2 using the get function on a web connection, Using the get function on a web connection -21, Using the get function on a web connection – Echelon i.LON SmartServer 2.0 User Manual
Page 62
i.LON SmartServer 2.0 Programmer’s Reference
4-21
<UCPTannotation>Dp_In_WebBinding;xsi:type="Dp_Ref"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</ListResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>
4.4.2
Using the Get Function on a Web Connection
You can use the Get function to retrieve the configuration of any Web connection that you have added
to the SmartServer’s Data Server. The input parameters you supply to the function will include an
<iLonItem> element that has an xSelect statement with a Dp_Ref type, and one or more <Item>
elements. Each <Item> element includes a <UCPTname> property that you can use to specify the
source data point in the Web connection to be returned.
Request
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Dp_Ref"]</xSelect>
<Item>
<UCPTname>Net/LON/iLON App/Digital Input 1/nvoClsValue_1</UCPTname>
</Item>
<Item>
<UCPTname>Net/LON/iLON
App/VirtFb/nvoSwitch</UCPTname>
</Item>
</iLonItem>
</Get>
Response
<GetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="Dp_Ref">
<UCPTname>Net/LON/iLON App/Digital Input 1/nvoClsValue_1</UCPTname>
<UCPTannotation>Dp_In_WebBinding</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-17T14:29:35.666-07:00</UCPTlastUpdate>
<UCPTdescription>Generated by WB web UI</UCPTdescription>
<UCPTuri>Dp_Ref.htm</UCPTuri>
<DataPoint
dpType="Target"
discrim="dir_in_out">
<UCPTname>Net/LON/iLON
App/Digital
Output
1/nviClaValue_1</UCPTname>
<UCPTserviceType
LonFormat="UCPTserviceType">ST_WEB_ACK</UCPTserviceType>
<UCPTservicePath>//WebService[UCPTindex=1]</UCPTservicePath>
<UCPTpriority>255</UCPTpriority>
<UCPTpropagate>1</UCPTpropagate>
</DataPoint>
</Item>
<Item
xsi:type="Dp_Ref">
<UCPTname>Net/LON/iLON
App/VirtFb/nvoSwitch</UCPTname>
<UCPTannotation>Dp_In_WebBinding</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-19T16:41:23.338-07:00</UCPTlastUpdate>
<UCPTdescription>Generated by WB web UI</UCPTdescription>
<UCPTuri>Dp_Ref.htm</UCPTuri>
<DataPoint
dpType="Target"
discrim="dir_in_out">
<UCPTname>Net/LON/iLON
App/Digital
Output
1/nviClaValue_1</UCPTname>
<UCPTserviceType
LonFormat="UCPTserviceType">ST_WEB_ACK</UCPTserviceType>
<UCPTservicePath></UCPTservicePath>
<UCPTpriority>255</UCPTpriority>
<UCPTpropagate>1</UCPTpropagate>
</DataPoint>
</Item>
</iLonItem>
</Get>
The Get function returns an <Item> element for each source data point in a Web connection referenced
in the input parameters you supplied to the function. The properties included within each <Item>
element are initially defined when the Web connection is added to the DataServer. You can write to
these properties with the Set function. The following table describes these properties.