APIs for integration

© A

BB

Util

ities

- 1

20

00-0

6/S

PID

ER

MR

APIs forintegration

© A

BB

Util

ities

- 2

-

APIs, Possibilities

What APIs do we have?

How can we use them for integration?

New functionality/project deviations Future APIs

API = Application Program Interface

© A

BB

Util

ities

- 3

-

APIs, Possibilities

What APIs do we have? DB Server API

ActiveX COM DB Server API

ODBC

APIs on different layers

After Sales opportunities

© A

BB

Util

ities

- 4

-

APIs, DB Server API

DB Server API Supports a lot of functions:

Authority Start of SPIDER program (Avanti sndmsg) Read real time data including quality flags Read/update historical data including quality flags. Transparent

UDW 200 or Avanti TTD Dynamic SQL Read/write server disk files Redundancy transparent for the user application etc...

Available on multi platforms UNIX/VMS/Windows API is a DLL (Windows) or a shared library (UNIX/VMS)

© A

BB

Util

ities

- 5

-

APIs, ActiveX DB Server API

ActiveX COM DB Server API Functionality about the same as for the DB Server API

Excellent support for writing Visual Basic applications

Active Server Pages (ASP) support

© A

BB

Util

ities

- 6

-


© A

BB

Util

ities

- 7

-


© A

BB

Util

ities

- 8

-

APIs, ODBC

ODBC Supports a lot of functions:

Authority Read/update real time data Read/update historical data including quality flags

Virtual tables => extremely easy to set up a query (you have to know something about the contents of the database)

Insert/Delete records in Avanti Redundancy transparent for the user application

Supported by MS Office MS Query (to set up the select statement) MS Excel SPIDER Reports MS Access direct import of Avanti data

Supports tools that support ODBC

© A

BB

Util

ities

- 9

-

APIs, ODBC

© A

BB

Util

ities

- 1

0 -

APIs on different layers

VBA code

Excel

SXReport(1 ActiveX + 3 DLLs)

DB server API COM version

DB server API Win32 version

ODBC

Appl. toconnect

Appl. toconnect

Appl. toconnectHMI support

(office connection)

Middleware

Appl. toconnect

© A

BB

Util

ities

- 1

1 -

APIs, Possibilities for After Sales

After sales opportunities Experience

NOINA has sold the ODBC-driver

SEUTA has sold Excel to SPIDER release 1 using DB Server API

DEUTA offers integration solutions by means of ODBC and DB Server API

supports old releases

Product wrapping is needed Identified and known for different releases

© A

BB

Util

ities

- 1

2 -

APIs, Possibilities for After Sales

After Sales opportunities (cont.) In priority (go for money)

Win a soft support upgrade contract

Look at integration aspects between different systems and SPIDER

Suggest different solutions

Sell Excel using the report package

Sell ODBC driver

Sell DB Server API/DB Server API COM-version

© A

BB

Util

ities

- 1

3 -

APIs, Possibilities for integration

How can we use the APIs for integration?

Here follows examples of what have been done in DEUTA

© A

BB

Util

ities

- 1

4 -

Utility Data Warehouse

Maintenance & servicing

BMS

NPS

GIS

NMS/ CRMS

NIS

EMS/ DMS/ SCADA

Network managementMiddle- and High voltage

LMS

Energy Management/ Load Management

Network completion

&optimize

Business Management

Geographic Information

Systems

TCMS

Trouble call

Network Management low voltage

CIS

Customer Information systems

The business process: Exchange of information

Common Businessdatabase

© A

BB

Util

ities

- 1

5 -

Open System architecture

Open Systems based on “independent“ Standards

• Software portability: IEEE POSIX Operating System Interface

• Standards on workplaces (Human Machine Interface, HMI)

• Database server: Structured Query Language (SQL)

• Database Interface to the Office-world (ODBC)

• Communication standards: e.g. ISO/ OSI- Reference Model

• Remote control system protocols : RP 570/ 571, IEC 870-5-104

• ...

© A

BB

Util

ities

- 1

6 -

ExternalSystem

*

RDBMS

GUI

PCG PCG PCG

RTURTURTURTU

RTURTURTURTU

RTURTURTURTU

Data Acquisition

SPIDERSCADA

Avanti

WS400

HMI

DMS

SPIDER DE

MDBEOracle

DE

GIS

GIS DB

GIS

Integration example

* External System,for example NMS,Crew Management,Trouble Call Management,PC- Office System, etc.

Expert LoadShedding

Cooperate Systems

SCADA EMS

EMS

ICCP

USI, ODBC,SQL

© A

BB

Util

ities

- 1

7 -

SCADA-near layer

Data collector layer

Communication layer

Universal SCADA Interface USI

NMSAdapter

ESB

Continuous growing demand !

TCOMAdapter

CLP

NMSAdapter

NIE

NISAdapter

TCOMAdapter

HC

© A

BB

Util

ities

- 1

8 -

HO

T

ST

AN

DB

Y

connectivity Network model

TCP/IP

Logicgating

Process connection

Online PDB

SCADA Server

TemporaryDevices

DMS DevicesSCADA-Interface

“data mapping“

separate workplaces/HMIOperator interface

Mutual call interface (HMI- Adapter)

USI - Project example NIESPIDER HMI Extern GUI

any DB-

System (SQL)

NMS Server

SPIDER Network system Foreign system

© A

BB

Util

ities

- 1

9 -

HO

T

ST

AN

DB

Y

TCP/IP

Foreign system

common workplace

NT- Terminalserver

Network modelLogical

connection

Process connection

Online PDB

SCADA Server

DMS DevicesSCADA-Interface

“data mapping“

Mutual call interface (HMI- Adapter)

HMI-client like WinNTHmi client e.g. UNIX

E.g.. X- Window clients

SPIDER HMIForeign-GUI

USI - Project example NIS

TemporaryDevices

anyDB-

System (SQL)

SPIDER HMIForeign-GUI

SPIDER Network system

© A

BB

Util

ities

- 2

0 -

TroubleCall

System

HO

T

ST

AN

DB

Y

Network model

Outage Engine

MDBE(ORACLE)

TCP/IP

SQL-Net

Logic connection

Process connection

Online PDB

SCADA Server

DMS Devices

SCADA-Interface

UPDATE UPDATE

“data mapping“

CommonData entry

Common work place

X- Window clients

USI - Project example TCOM

TemporaryDevices

SPIDER HMIFremd-GUI

SPIDER HMIFremd-GUI

SPIDER Network control system Foreign system

© A

BB

Util

ities

- 2

1 -

Firewall

SPIDER SCADA/ DMS as an open data resource (example)

SQL,ODBC, USI

External System

Intranet

UDW, Utility Data Warehouse

Oracle

SQL,ODBC,WebGate

Oracle

Database Server

Intranet

SPIDER Host

Avanti

SQL,ODBC,WebGate

SQL,ODBC,USI,

WebGate

• Interfaces, e.g. ODBC, SQL, WebGate and USI • Customization (usually required e.g. for ORACLE or MS- Office applications, etc.)

ABB- Services for:

Office Applications (ORACLE, EXCEL, Internet- Browser, etc.)

SQL, ODBC,

WebGate

© A

BB

Util

ities

- 2

2 -

New “External Services“ for Utilities WebGate

Network Control System

Intranet

Firewall

Common Gateway Interface (CGI)

Online - PDB

Avanti

DIS/DB- Server

ORACLE

2)3)4)Web Server Interface

Web Browser

Internet

Internet Service Provider

Web Client Interface

“External Services“

IS400, WebGate

© A

BB

Util

ities

- 2

3 -

Utility Service Interfaces for the Business Process Improvements

Intranet

Programming Interfaces incl. format conversion

2)3)4)Web Server Interface

Web Browser

Web Client Interface (“Thin Client“)

“Utility Services“e.g. SCRIPTS, Aplets, etc.

WebGate:

Data Presentation and Data Access into “any“ external system of the network

HTML, (XML)- Document

Any external system Interface(proprietary) formats & protocols

Remote Data Access:

• ODBC• SQL• DB- API• C- API• OPC• etc.

© A

BB

Util

ities

- 2

4 -

• We help to optimize the business process four our customers.

• We use IT- technologies for the integration of different software-components.

Our objectives

The new IT-Integration concept is a real

Milestone in network operation

© A

BB

Util

ities

- 2

5 -


New functionality/project specials Use the APIs to implement new functions like:

Stand alone calculations of various kind

Operators Diary (in the WS400 NT)

….

Use the APIs to implement project specials Supports upgrades of SPIDER (The API used is still supported in

next release)

No messing up in standard implementation

© A

BB

Util

ities

- 2

6 -


Future APIs Many more APIs will come

Release independent

Also available on integration platforms

SPIDER IDL (SIDL)

DAIS (OPC)

DAF/CIM

HMI third party API support

Java support via IIOP (Internet Inter-ORB Protocol) transport module will enable all coming SIDL based APIs to work with Java (RMI Remote Method Invocation)

JDBC support is possible to buy for the existing ODBC-driver

© A

BB

Util

ities

- 2

7 -


SPIDER Interface Definition Language (SIDL) Opens up the functions of SPIDER to the external world

(compare MS)

Supports different hardware as well as different platforms

Supports loose coupling of functions Compare with MS closed to an open environment

Good performance

To guide and support development

Promotes modules/components

It is an ongoing development project (C-28)

© A

BB

Util

ities

- 2

8 -

SPIDER IDL Framework Presentation

The framework is a ‘middleware’ with similarities to COM and CORBA but differs in some areas. Similarities

IDL (SIDL) Name Server Support at least two of the three OO criteria's

Encapsulation Polymorphism (Inheritance (not supported by COM, only as aggregates))

Differences Supports system configuration and supervision High performance although very flexible Ease of use, low threshold for new users Supports heterogeneous networks (as do most CORBA impl)

© A

BB

Util

ities

- 2

9 -


Internal example

Server

StatusChange

Command

GetStatus

Client

Client

Method Invocation Interface

Event Interface

Client

Client

StatusChange

GetStatus

Process Interface

Command Dialog

Filter

Presentation

Equipment StatisticsData flow, media transparent (local, LAN,

WAN)

© A

BB

Util

ities

- 3

0 -


Third party software example

Server

StatusChange

Command

GetStatus

Client

ActiveX

Method Invocation Interface

Event Interface

Client

StatusChange

GetStatus

Process Interface

Command Dialog

Excel

Data flow, media transparent (local, LAN, WAN)

Object

Bridge to COM

‘Normal’ COM Interface

© A

BB

Util

ities

- 3

1 -

APIs, DAIS

OMG DAIS (Data Acquisition for Industrial Systems) Is a becoming standard

Initiated by ABB

Subscription of process data

Compatible with OPC (process data)

Used in the SPIDER Cadops integration

Based on the SPIDER IDL Framework

© A

BB

Util

ities

- 3

2 -

APIs, DAF/CIM

OMG Utility Management Systems DAF (Data Access Facility) API for retrieval of data according to the structure defined in CIM

(Common information Model)

Mapping of CIM and Avanti structures Ongoing work in US as well as in Sweden

Publishing via a DAF API

Documents

APIs for integration