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

i.LON SmartServer 2.0 Programmer’s Reference 4-6
Alternatively, you can specify one or more data point properties such as <UCPTformatDescription>in
an xSelect statement to filter the items returned by the Get function.
Note: You should not attempt to retrieve the configuration of more than 100 data points with a single
call to the Get function.
Request (return all SNVT_switch data points on the internal SmartServer automated systems
device [i.LON App])
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Dp_Cfg"]
[starts-with(UCPTname,"Net/LON/iLON App")]
[UCPTformatDescription="#0000000000000000[0].SNVT_switch"]
</xSelect>
</iLonItem>
</List>
Request (return a specific data point)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item>
<UCPTname>Net/LON/DIO-3/Digital
Encoder[0]/DE_D1_1</UCPTname>
</Item>
</iLonItem>
</Get>
Response
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="Dp_Cfg">
<UCPTname>Net/LON/DIO-3/Digital Encoder[0]/DE_D1_1</UCPTname>
<UCPTannotation>Dp_In;xsi:type="LON_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-17T13:36:48.460-07:00</UCPTlastUpdate>
<UCPTdescription>Digital encoder input 1. This is the least-significant
bit</UCPTdescription>
<UCPTformatDescription>#0000000000000000[0].SNVT_switch</UCPTformatDescription>
<UCPTlength>2</UCPTlength>
<UCPTdirection
LonFormat="UCPTdirection">DIR_IN</UCPTdirection>
<UCPTunit field="value">% of full level</UCPTunit>
<UCPTunit field="state">state code</UCPTunit>
<UCPTbaseType LonFormat="UCPTbaseType">BT_STRUCT</UCPTbaseType>
<UCPTmaxFields>2</UCPTmaxFields>
<SCPTmaxSendTime>0.0</SCPTmaxSendTime>
<SCPTmaxRcvTime>0.0</SCPTmaxRcvTime>
<ValueDef>
<UCPTindex>0</UCPTindex>
<UCPTname>OFF</UCPTname>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_switch">0.0 0</UCPTvalue>
</ValueDef>
<ValueDef>
<UCPTindex>1</UCPTindex>
<UCPTname>ON</UCPTname>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_switch">100.0 1</UCPTvalue>
</ValueDef>
</Item>
<iLonItem>
The Get function returns an <Item> element for each data point referenced in the input parameters you
supplied to the function. The properties included within each <Item> element are initially defined
when the data point is added to the DataServer. You can write to these data point properties with the
Set function. The following table describes these properties.