tour of the af and pi notifications … afsdk programming/2 af y...title slide 1 author steve pilon...
TRANSCRIPT
Copyright © 2009 OSIsoft, Inc.
TOUR OF THE
AF AND PI NOTIFICATIONS
DEVELOPER TOOLS
THE BUILDERS' CAFÉ WEBINAR SERIES
Copyright © 2009 OSIsoft, Inc.
2
AGENDA
• Overview
– PI AF
– PI Notifications
– The OSIsoft SDKs
• PI AF Developer Tools
• PI Notifications Developer Tools
• Q&A
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
4
VCAMPUS-EXCLUSIVE WEBINARS
• The Builders' Café Webinar Series
• Submit your ideas here:
Copyright © 2009 OSIsoft, Inc.
5
VCAMPUS-EXCLUSIVE TOOLS
• AF Developer Tools
• PI Notifications Developer Tools
* Will be integrated in the next DVD image
Copyright © 2009 OSIsoft, Inc.
OVERVIEW
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
10
PI NOTIFICATIONS
• Real-time notifications management system
– Based on AF
• Features:
– Acknowledgement
– Escalation
– Customizable content
– Custom delivery mechanisms
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
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.
Copyright © 2009 OSIsoft, Inc.
14
PROGRAMMING WITH AF FOR NOTIFICATIONS
• AF.Notification = Namespace in AF SDK
• What would a programmer want to code?
– 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
Copyright © 2009 OSIsoft, Inc.
15
PROGRAMMING WITH AF.NOTIFICATION
• Object Model
• Don't forget the Sandbox/Check-in mechanism!
Copyright © 2009 OSIsoft, Inc.
16
PROGRAMMING WITH AN SDK
• Main AN SDK assembly = OSIsoft.PIAnalytics.SDK.dll
• What would a programmer want to code?
– Manipulate Notification Instances
• Acknowledgement, Comments, Triggering, etc.
• What for?
– Notification roll-ups and aggregation
– Custom visualization of notifications and their history
Copyright © 2009 OSIsoft, Inc.
17
PROGRAMMING WITH AN SDK
Copyright © 2009 OSIsoft, Inc.
AF DEVELOPER TOOLS
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
20
IMPROVED VISUAL STUDIO EXPERIENCE
• IntelliSense without the developer tools:
• IntelliSense with the developer tools:
Copyright © 2009 OSIsoft, Inc.
21
IMPROVED VISUAL STUDIO EXPERIENCE
• Object Browser without the developer tools:
• Object Browser with the developer tools:
Copyright © 2009 OSIsoft, Inc.
22
AF SDK PROGRAMMING REFERENCE
• Examples, Hierarchies, Namespace/Class Reference
Copyright © 2009 OSIsoft, Inc.
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…
Copyright © 2009 OSIsoft, Inc.
24
CONNECT
Copyright © 2009 OSIsoft, Inc.
25
CREATE A TEMPLATE AND A DERIVED ELEMENT
Copyright © 2009 OSIsoft, Inc.
26
CREATE ELEMENT ATTRIBUTES
Copyright © 2009 OSIsoft, Inc.
27
FIND ELEMENTS
Copyright © 2009 OSIsoft, Inc.
PI NOTIFICATIONS DEVELOPER
TOOLS
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
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
Copyright © 2009 OSIsoft, Inc.
31
CREATE NOTIFICATION RULE
• Using AF SDK's Notification namespace
Copyright © 2009 OSIsoft, Inc.
32
CUSTOM DELIVERY CHANNEL: XML
• Using AF SDK's Notification namespace
Copyright © 2009 OSIsoft, Inc.
33
MANIPULATING NOTIFICATION INSTANCES
• Using AN SDK
Copyright © 2009 OSIsoft, Inc.
AND THERE'S MORE
Copyright © 2009 OSIsoft, Inc.
35
CREATING AF 2.0 DATA REFERENCES
• New White Paper, only on the vCampus Library
– 3 code samples
Copyright © 2009 OSIsoft, Inc.
Q & A
Copyright © 2009 OSIsoft, Inc.
37
HOW TO CONTACT US
For further questions:
http://vCampus.osisoft.com > Contact Us