![Page 1: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/1.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Presented by
RESTful Web Services
Coming to the PI System with OData
Steve Pilon, Product Manager
![Page 2: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/2.jpg)
© Copyr i gh t 2012 OSIso f t , LLC. 2
![Page 3: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/3.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Platinum Sponsor
3
![Page 4: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/4.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
RESTful??
4
![Page 5: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/5.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Web Services Landscape
SOAP
Web Services
REST
Web Services
![Page 6: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/6.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
By definition…
SOAP
REST
• Simple Object Access Protocol (protocol specification)
• REpresentational State Transfer (architectural style)
![Page 7: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/7.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
In clear…
SOAP
REST
• Exposes methods with inputs and outputs (operation-centric)
• Well-defined, discoverable calling sequences
• Thought of as "official, serious, for large enterprises"
• Exposes resources, collections, relationships (data-centric)
• No predefined format, but using URIs (with verbs and nouns ) and focus on readability
• Thought of as "easy, simple, free-form"
![Page 8: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/8.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
The Open Data
(OData) Protocol
8
![Page 9: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/9.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
OData
• Protocol specification for RESTful, data-centric service
• Exposing entities (with relationships) and operations
• Queryable via URIs (browser or code) or client libraries
• Full CRUD possibility – HTTP verbs (GET, POST, PUT, DELETE)
• Undergoing standardization at OASIS (Microsoft, SAP, IBM, Citrix, Red Hat and more)
http://www.odata.org
![Page 10: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/10.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Use Cases
• Mobile Application Development (and development of distributed apps in general)
• Data Exchange and Cloud-Based Apps
• Line-of-Business Systems Integration (including Asset Synchronization)
• Business Intelligence and Reporting
• Windows vs. Non-Windows Platforms
![Page 11: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/11.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Proposal: a 2-feed approach
Catalog
(Servers/Databases)
Data
(Elements, Event
Frames, etc.)
Each Database has
an "endpoint" for
the other feed
![Page 12: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/12.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Entities
• Queryable and updatable, analogous to SQL tables
• Navigation properties to walk through entities
• Available entities: – Elements and Attributes
– ElementTemplates and AttributeTemplates
– Categories
– UnitsOfMeasure and UOMClasses
– EnumerationSets and EnumerationSetValues
– EventFrames
– ElementReferences, EventFrameReferences ReferenceTypes
![Page 13: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/13.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Operations
• Analogous to methods – Mandatory and optional parameters
• Available operations: – RecordedValues
– RecordedValue
– InterpolatedValues
– SummaryValue
– SummaryValues
– PlotValues
![Page 14: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/14.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Query via URIs
• Rich query and filtering semantics
• Web browser or code
• AtomPub or JSON
Navigation Properties
Properties
URI
![Page 15: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/15.jpg)
© Copyr i gh t 2012 OSIso f t , LLC. 15
![Page 16: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/16.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Using OData
16
![Page 17: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/17.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Application Development
• Manually issue HTTP requests and handle the returned AtomPub or JSON payload
Generic HTTP
• Generally object-oriented and strongly-typed (generated from service metadata)
OData client libraries
![Page 18: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/18.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Line-of-Business Systems
• Growing number of OData producers and consumers
– Microsoft, SAP, IBM, Telerik, Tableau, and others
![Page 19: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/19.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Data Markets and Other Feeds
• Open Government Data Initiative (ODGI) – Several government agencies and municipalities
(USA, Canada, Columbia, Portugal, France, etc.)
• Microsoft Azure Data MarketPlace
• On the geeky side: – eBay, Netflix, Stack Overflow, twitpic, NerdDinner
19
![Page 20: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/20.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
In the Hands-On Lab
• Tomorrow at 10am
• PI OData Service [prototype]
• Need your feedback!
20
![Page 21: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/21.jpg)
© Copyr i gh t 2012 OSIso f t , LLC.
Steve Pilon
Product Manager
OSIsoft, LLC
21
![Page 22: RESTful Web Services Coming to the PI System with ODatacdn.osisoft.com/corp/en/media/presentations/2012/vCampusLive2012/... · RESTful Web Services Coming to the PI System with OData](https://reader034.vdocument.in/reader034/viewer/2022051508/5a8434f57f8b9ac96a8b6f41/html5/thumbnails/22.jpg)
THANK YOU
© Copyr i gh t 2012 OSIso f t , LLC.