2 using the get function on network variables, Using the get function on network variables -41, Using the get function on network variables – Echelon i.LON SmartServer 2.0 User Manual

Page 241

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

14-41

<xSelect>//Item[@xsi:type="LON_Dp_Cfg"][starts-with(UCPTname,"Building 2/Channel 1/DIO-5/Digital
Output[0]")]
</xSelect>

</iLonItem>
</List>

Request (use an xSelect statement to return all the network variables that were updated after a
specific time)

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>

<xSelect>//Item[@xsi:type="LON_Dp_Cfg"][UCPTlastUpdate&gt;"2008-03-31T00:00:00"]
</xSelect>

</iLonItem>
</List>

Request (return all the network variables of a specific type based on name)

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="LON_Dp_Cfg"][contains(UCPTname,"DO_Digital")]</xSelect>
</iLonItem>

</List>

Response

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<UCPTcurrentConfig>4.0</UCPTcurrentConfig>
<Item>

<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[0]/DO_Digital_1</UCPTname>

<UCPTannotation>Dp_In;xsi:type="LON_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
<Item>

<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[1]/DO_Digital_2</UCPTname>

<UCPTannotation>Dp_In;xsi:type="LON_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>

14.7.2

Using the Get Function on Network Variables

You can use the Get function to retrieve the configuration of network variables (L

ON

W

ORKS

data

points) defined on the SmartServer or in a specific LNS network database. The input parameters you
supply to this function will include one or more <Item> elements with a LON_Dp_Cfg type. Each
<Item> element will include the <UCPTname> of each

network variable whose configuration is to be

returned by this function, as shown in the example below.

Request (use an xSelect statement to return a specific

network variable)

<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item

xsi:type="LON_Dp_Cfg">

<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[0]/DO_Digital_1/</UCPTname>

</Item>
</iLonItem>
</Get>

Alternatively, you can specify one or more network variable (L

ON

W

ORKS

data point) properties in the

xSelect statement to filter the items returned by the Get function, including the <UCPTname> to filter
data points based on their parent functional block.

Request (use an xSelect statement return all the network variables on a specific functional block)

<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>

<xSelect> //Item[@xsi:type="LON_Fb_Cfg"][starts-with(UCPTname,"Building 2/Channel 1/DIO-5/
Digital Output[0]")]</xSelect>

Advertising