tour of the af and pi notifications … afsdk programming/2 af y...title slide 1 author steve pilon...

Copyright © 2009 OSIsoft, Inc.

TOUR OF THE

AF AND PI NOTIFICATIONS

DEVELOPER TOOLS

THE BUILDERS' CAFÉ WEBINAR SERIES


2

AGENDA

• Overview

– PI AF

– PI Notifications

– The OSIsoft SDKs

• PI AF Developer Tools

• PI Notifications Developer Tools

• Q&A


3

PRESENTERS

• Steve Pilon, vCampus Team Member

• Laurent Garrigues, Product Manager at OSIsoft

• Chris Manhard, Lead Developer for PI AF

• Beth McNeill, Lead Developer for PI Notifications


4

VCAMPUS-EXCLUSIVE WEBINARS

• The Builders' Café Webinar Series

• Submit your ideas here:


5

VCAMPUS-EXCLUSIVE TOOLS

• AF Developer Tools

• PI Notifications Developer Tools

* Will be integrated in the next DVD image


OVERVIEW


7

PI ACE

RtReports

PI AnalyticsProcessBook

DataLink

RtPortal iViews

ActiveView

RtReports Clients

Real-Time Interfaces

PI AF

PI Archive

PI NotificationsData Access

The Server The Analytics The Visuals

MCN HealthMonitor

BatchView

Smart Clients

Thin ClientsSigmafine

RtWebParts

THE PI SYSTEM


8

AF

• Additional layer on top of PI

• Significantly changes how to view and use PI:

– Tag-centric Asset-centric

– Flat Hierarchical

– Unstructured Organized

– Server-centric Enterprise-wide


9

IS AF JUST "A MORE ORGANIZED PI"?

No

• Allows for better and even broader data aggregation:– PI Points and Data (obviously!)

– Relational databases

– Web services

– Custom data sources

– UoMs

– Relationships and modeling

• Base building block for visualization, analysis, notification and other engines


10

PI NOTIFICATIONS

• Real-time notifications management system

– Based on AF

• Features:

– Acknowledgement

– Escalation

– Customizable content

– Custom delivery mechanisms


11

THE OSISOFT SDKS

• PI SDK– PI Points (Attributes & Data)

– PI Server Message Log

– Various PI Databases (Users & Groups, etc.)

• AF SDK– AF Databases, Elements, Attributes

– AF Analysis Rules (ARs) and Data References (DRs)

– AF Connectivity Models and Cases

– Notification Configuration (including Delivery Channel)

• Notifications SDK (a.k.a. AN SDK)– Notification Instances


12

PROGRAMMING WITH AF SDK

• Main AF SDK assembly = OSIsoft.AFSDK.dll

• What would a programmer want to code?

– Manage/Find Assets

• Database, Elements, Attributes

– Manage Library

• Templates, Tables

• What for?

– AF Deployment

– AF Synchronization with EAM systems

– Custom end-user interface


13

PROGRAMMING WITH AF SDK

• Object model

• Sandbox/Check-in Mechanism on objects

– .CheckIn(), .CheckOut(), .UndoCheckOut()

– .CheckOutInfo

To other namespaces: AF. UnitsOfMeasure, AF.Analysis, AF.Modeling, etc.


14

PROGRAMMING WITH AF FOR NOTIFICATIONS

• AF.Notification = Namespace in AF SDK


– Manage Notifications (from a configuration standpoint)

– Create Custom Delivery Channels

– Manage Contacts

• What for?

– Bulk creation/management of notifications

– Develop a thin client configuration tool

– Expand support for delivering notifications

– Easier management of contact list


15

PROGRAMMING WITH AF.NOTIFICATION

• Object Model

• Don't forget the Sandbox/Check-in mechanism!


16

PROGRAMMING WITH AN SDK

• Main AN SDK assembly = OSIsoft.PIAnalytics.SDK.dll


– Manipulate Notification Instances

• Acknowledgement, Comments, Triggering, etc.

• What for?

– Notification roll-ups and aggregation

– Custom visualization of notifications and their history


17

PROGRAMMING WITH AN SDK


AF DEVELOPER TOOLS


19

AF SDK DEVELOPER TOOLS

• AF SDK Programming Reference

– \PIPC\Help\AFSDK.CHM

• VB.NET and C# Sample Code

– In the Programming Reference (for now)

• Improved Microsoft Visual Studio experience

– More exhaustive IntelliSense

– More detailed Object Browser


20

IMPROVED VISUAL STUDIO EXPERIENCE

• IntelliSense without the developer tools:

• IntelliSense with the developer tools:


21

IMPROVED VISUAL STUDIO EXPERIENCE

• Object Browser without the developer tools:

• Object Browser with the developer tools:


22

AF SDK PROGRAMMING REFERENCE

• Examples, Hierarchies, Namespace/Class Reference


23

AF SDK SAMPLES

• In the AF SDK Programming Reference

• VB.NET and C# examples

• Examples for major components/objects in AF SDK• Attributes

• Elements

• Search Methods

• More…


24

CONNECT


25

CREATE A TEMPLATE AND A DERIVED ELEMENT


26

CREATE ELEMENT ATTRIBUTES


27

FIND ELEMENTS


PI NOTIFICATIONS DEVELOPER

TOOLS


29

AN SDK DEVELOPER TOOLS

• AN SDK Programming Reference

– \PIPC\Help\ANSDK.CHM

• VB.NET and C# Sample Code

– 4 Projects in \PIPC\Analytics\Samples

• Improved Microsoft Visual Studio experience

– More exhaustive IntelliSense

– More detailed Object Browser


30

• VB.NET and C# examples for Visual Studio .NET 2005

– Create Notification Rule

– Element-Based Notifications

– List Notifications Instance Count

– XML Custom Delivery Channel

• Very exhaustive examples

PI NOTIFICATIONS SAMPLES


31

CREATE NOTIFICATION RULE

• Using AF SDK's Notification namespace


32

CUSTOM DELIVERY CHANNEL: XML

• Using AF SDK's Notification namespace


33

MANIPULATING NOTIFICATION INSTANCES

• Using AN SDK


AND THERE'S MORE


35

CREATING AF 2.0 DATA REFERENCES

• New White Paper, only on the vCampus Library

– 3 code samples


Q & A


37

HOW TO CONTACT US

For further questions:

http://vCampus.osisoft.com > Contact Us

[email protected]

http://vcampus.osisoft.com/

mailto:[email protected]

tour of the af and pi notifications … afsdk programming/2 af y...title slide 1 author steve pilon...

Documents