Discover How to Programmatically Generate PI Coresight - OSIsoft

Discover How to Programmatically
Generate PI Coresight Displays with
the Right Data Items and Time Range
Michael Weiss, OSIsoft
Agenda
вЂў
вЂў
вЂў
вЂў
вЂў
What is PI Coresight?
Integrating with PI Coresight
Code sample
PI ProcessBook Add-In sample
Discussion
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
2
What is PI Coresight?
PI Coresight is an intuitive, web-based tool that
delivers fast, easy, and secure access to all your
PI System data.
With PI Coresight you can easily perform ad hoc
analysis, discover answers, and share your
insights with others.
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
3
PI Coresight Architecture
вЂў
Silverlight User Interface
вЂў
Web Services in middle tier
вЂў
PI System and SQL Server
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
4
PI Coresight Demo
Watch forвЂ¦
вЂў
вЂў
вЂў
вЂњDisplaysвЂќ
вЂњSymbolsвЂќ
The URLs in the browser
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
5
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
6
Why Integrate?
Allows a user to quickly open вЂњinterestingвЂќ data in
PI Coresight without requiring a preexisting
display or manual work.
вЂў Selected data items in PI Process Book, PI
DataLink, PI WebParts, PI Notification (likely
future features available from OSIsoft)
вЂў Custom applications
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
7
Building a sample application
1.
Find and connect to the PI Coresight Web
Service
2.
Make the Web Service call to create a display
3.
Open the Display
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
8
Step 1: Find and Connect
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
9
Find and connect to service
вЂў
вЂў
вЂў
WeвЂ™ll need the URLs to both UI website and
the Web Services
Stored in siteвЂ™s default PI AF server by PI
Coresight installer
PI AF Path:
\\AFServer\Configuration\OSIsoft\PI Coresight | Coresight URL
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
10
Find and connect - Authentication
вЂў
Any application that connects to the PI
Coresight Web Services must support
Windows Authentication.
вЂў
By default the authentication mode is
вЂњNegotiateвЂќ (Kerberos).
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
11
Adding a Web Service Reference
вЂў
.NET applications require a Web Reference
in order to call the Web Service.
вЂў
Other platforms may require a similar step.
вЂў
http://<yourwebserver>/Coresight/Services/St
orage/CoresightStorage.svc
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
12
Web Reference, continued
Add the bolded line temporarily to
Coresight\Services\Web.config:
вЂ¦
<serviceBehaviors>
<behavior name="CoresightBehavior">
<serviceThrottling вЂ¦/>
<serviceMetadata httpGetEnabled="true" />
</behavior>
вЂ¦
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
13
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
14
Step 2: Make the call
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
15
Making the call - NewAdHocDisplay
NewDisplayInfo NewAdHocDisplay (
string cog,
string namePrefix,
AccessLevel level )
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
16
The COG
вЂў
вЂў
вЂў
вЂў
вЂў
A common way to share data and context
between PI System applications
By data we mean PI Tags and/or PI AF Attributes
grouped into an abstract symbols
By context we mean a time range
XML
Focus on the COG features PI Coresight Trends
support
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
17
Major COG elements
Databases
A list of PI System and PI AF servers
Datasources
PI Tags or AF Elements (links to a Database)
Symbols
Groups of Datasources (links to one or more Datasources)
Context
Time ranges (links to nothing, for whole Display)
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
18
COG Structure
Databases
PI
Id = вЂњ1вЂќ
AF
Id = вЂњ2вЂќ
1 per unique PI
Server or PI AF
Database
Datasources
PIData
DbRef=вЂњ1вЂќ
Tag
Id=вЂњTag1вЂќ
Symbols
AFData
DbRef=вЂњ2вЂќ
Symbol
Id=вЂњs1вЂќ
AFAttribute
Id=вЂњAttrib1вЂќ
Datasource
Id=вЂњTag1вЂќ
1 per Trend
symbol, multiple
children =
multiple Traces
1 pair per unique Tag or Attribute
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
19
COG Time
вЂў Under an XML Tag: <Context><TimeRange>
вЂў Date and Time (Rfc3339)
"yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'FFFFFFFK"
вЂў Just time
"HH':'mm':'ss'.'FFFFFFFKвЂњ
вЂў Or PIвЂ™s relative time notation (вЂњ*вЂќ, вЂњ*-8hвЂќ, etc)
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
20
The other parameters
Name Prefix
The name of the new Display. PI Coresight will append a
unique number to this name.
Access Level
Should the new Display be Public (anyone can view) or
Private (accessible only by the author).
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
21
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
22
Step 3: Open the Display
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
23
Opening the Display
вЂў
вЂў
вЂў
Web Service call returns new Id
Create a URL
Email it
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
24
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
25
Not shown
вЂў
вЂў
вЂў
вЂў
вЂў
Calling Establish
Localization support
Client GUIDs
XSD Validation
Programmatically creating COGs
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
26
PI ProcessBook Add-in
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
27
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
28
WhatвЂ™s subject to change?
Endpoints
вЂ“ The paths of the URLs may change
вЂ“ AF Configuration may include additional URLs
вЂ“ Method calls intended for external consumption may be
grouped together into a single вЂњendpointвЂќ
Code
вЂ“ Expect code libraries (if provided) and XSDs will be updated.
Service References may need a refresh.
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C
29
Thank you
В©
C o p y r i g h t
2 0 1 1
O S I s o f t ,
L L C

Download Report