Echelon i.LON SmartServer 2.0 - Manual (Page 3)

i.LON SmartServer 2.0 Programmer’s Reference iii
Table of Contents
1 Introduction to the SmartServer SOAP/XML Interface ............... 1-1
1.1 About This Document ......................................................................1-1
1.2 Programming Samples ....................................................................1-2
1.3 Getting Started ................................................................................1-2
1.4 SmartServer SOAP/XML Interface Upgrades .................................1-2
1.4.1 Version 4.0 SOAP Message Name Schema.............................1-3
2 SOAP Messages and the SmartServer WSDL File...................... 2-1
2.1 SmartServer Naming Structure .......................................................2-1
2.2 SmartServer WSDL File ..................................................................2-2
2.3 Security............................................................................................2-2
2.4 SOAP Request and Response Message Structure.........................2-2
2.4.1 SOAP Request ..........................................................................2-3
2.4.2 SOAP Response .......................................................................2-4
2.5 SOAP Messages Formats ...............................................................2-4
2.5.1 SOAP Envelope.........................................................................2-5
2.5.2 SOAP Header ............................................................................2-5
2.5.3 SOAP Body................................................................................2-6
2.5.4 Namespace................................................................................2-9
2.5.5 SOAP Message Schema...........................................................2-9
2.5.6 SOAP Function Types ...............................................................2-9
2.5.7 SOAP Message Attributes.......................................................2-11
2.5.8 Using xSelect Statements in SOAP Message Requests ........2-11
2.6 Data Point References ..................................................................2-14
2.7 UCPTcurrentConfig .......................................................................2-15
2.8 Fault Structure ...............................................................................2-15
2.9 LonString type ...............................................................................2-15
2.10 SOAP Message Examples ............................................................2-15
2.10.1 Configuration Data.................................................................2-16
2.10.2 Web Binding ..........................................................................2-17
2.10.3 Data Log Read ......................................................................2-18
3 SmartServer Applications and the SOAP/XML Interface............ 3-1
3.1 Overview of SmartServer Applications............................................3-1
3.2 SmartServer XML Configuration Files.............................................3-2
3.2.1 Modifying the XML Configuration Files......................................3-2
3.3 SmartServer Resource Files ...........................................................3-3
3.3.1 Standard Network Variable Type (SNVT)
Device Resource Files...............................................................3-3
3.3.2 Standard Configuration Property Type (SCPT)
Device Resource Files...............................................................3-3
3.3.3 User-Defined Network Variable Type (UNVT)
Device Resource Files...............................................................3-4
3.3.4 User-Defined Configuration Property Type (UCPT)
Device Resource Files...............................................................3-4
3.3.5 Data Point Templates ................................................................3-4
3.3.6 Data Formatting .........................................................................3-4
3.4 SOAP Functions ..............................................................................3-5
3.4.1 List Functions ............................................................................3-5
3.4.2 Get Functions ............................................................................3-6
3.4.3 Set Functions.............................................................................3-6
3.4.4 Read Functions .........................................................................3-7