© 2019 AVEVA Group plc and its subsidiaries. All rights reserved. NA 2019 Day 1 Content/AP... · 2019. 11. 25. · linkedin.com/company/aveva @avevagroup ABOUT AVEVA AVEVA is a global

© 2019 AVEVA Group plc and its subsidiaries. All rights reserved.

Presented by:

Session ID: AP-TR-02

eDNA Enterprise Data Management Developer Training


Ivan Gutierrez, Technical Trainer & Content Developer

Ryan Schumacher, GCS Technical Account Manager

November 13th, 2019


eDNA ENTERPRISE DATA

MANAGEMENT

API

• Dynamic Link Library (DLL)

• RESTful

Examples

• Query Real-Time Data

• Query Historical Data

eDNA API

• The API is used to interface with the eDNA historian to retrieve and write data.

• Variety of APIs to accommodate for different language interfaces and architecture flavors

• Using the API, you can incorporate eDNA data into your programs by communicating

directly with eDNA services.


eDNA API

• APIs for reading data from eDNA:

• EzDnaApi.dll – classic API for retrieving data from eDNA

• EzDnaApi32/64.dll – classic API rebuilt in VS2010 with 32-bit and 64-bit flavors

• EzDnaApiNet.dll or EzDnaApiNet64.dll – Net wrapper for the classic API

• EzDnaApiNetLite.dll or EzDnaApiNetLite64.dll – Simplified API built for Object Oriented use.


Query Data

eDNA API

• APIs for writing data to eDNA:

• EzDnaServApi.dll or EzDnaServApi64.dll – API for pushing data to eDNA

• EzDnaServApiNet.dll or EzDnaServApiNet64.dll – Net wrapper for pushing API


Write Data

eDNA API


Goal\Programming Language C++ \ VBA \ Excel VB.NET \ C#

Retrieve Data from eDNA EzDnaApi.dll EzDnaApiNet.dll

Write Data to eDNA EzDnaServApi.dll EzDnaServApiNet.dll

eDNA REST

• Enables communication between the eDNA historian platform and 3rd party systems and

applications through REST (Representational State Transfer)

• Traditional Web Service conforms to the SOAP standard.

• Increases interoperability between eDNA and other web-based systems and applications.

• Runs as a Windows Service.


What is REST?

eDNA REST


eDNA ServerRequest for data

Web Host readsdata from eDNA

Data published inJSON format

eDNA REST

• eDNA Data Points

• Retrieve a list of eDNA points

• Retrieve a list of eDNA services


Resource Groups

• Asset Data (iAsset)

• Return a list of all available asset types

• Retrieve a single asset by its full name

• eDNA Real-Time Data (iData)

• Retrieve the current value for a given point

• Historical Data Retrieval (iHistory)

• Returns a list of all eDNA points stored in History

• Returns a count of eDNA points stored in History

eDNA REST

• Instructions for populating the component, api version, and resource syntax is found in the

developer documentation

• Results can be filtered and sorted using standard OData query options.

• Responses from the API are in JSON format, unless otherwise noted in the developer

documentation.


Structure

http://host:port/<component>/<api_version>/<resource>?$<query_parameters>

eDNA API

• We will primarily be working with:

• Dynamic link library (EzDnaApi.dll)

• RESTful API (eDNARestHost)


Lab



linkedin.com/company/aveva

@avevagroup

ABOUT AVEVA

AVEVA is a global leader in engineering and industrial software driving digital transformation across the entire asset and operational l ife cycle of capital -intensive industries.

The company’s engineering, planning and operations, asset performance, and monitoring and control solutions deliver proven results to over 16,000 customers across the globe. Its customers are supported by the largest industrial software ecosystem, including 4,200 partners and 5,700 certified developers. AVEVA is headquartered in Cambridge, UK, with over 4,400 employees at 80 locations in over 40 countries.

aveva.com


Documents

© 2019 AVEVA Group plc and its subsidiaries. All rights reserved. NA 2019 Day 1 Content/AP... · 2019. 11. 25. · linkedin.com/company/aveva @avevagroup ABOUT AVEVA AVEVA is a global