4 virtual data points, 1 using the list function on virtual data points, Virtual data points -8 – Echelon i.LON SmartServer 2.0 User Manual

Page 291: Using the list function on virtual data points -8, Virtual data points

Advertising

i.LON SmartServer 2.0 Programmer’s Reference

17-8

</iLonItem>
</SetResponse>

17.4

Virtual Data Points

The following section describes how to use the List, Get, Set, and Delete functions on Virtual data
points. For information on reading and writing values to Virtual data points, see Chapter 4, Using the
SmartServer Data Server.

17.4.1

Using the List Function on Virtual Data Points

You can use the List function to retrieve a list of Virtual data points on the SmartServer. The List
function takes an <iLonItem> element that has an xSelect statement with a Virtual_Dp_Cfg type as its
input, as shown in the example below.

Request (return all the Virtual data points on the SmartServer)

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Virtual_Dp_Cfg"]</xSelect>

</iLonItem>
</List>

Alternatively, you can filter the Virtual data points returned by the List function to those on a specific
device by including the <UCPTname>of the parent device in the xSelect statement, or you can filter
the Virtual data points returned using the <UCPTname> and <UCPTlastUpdate> data point properties.

Request (use an xSelect statement to return all the Virtual data points on a specific device)

<xSelect>//Item[@xsi:type="Virtual_Dp_Cfg"][starts-with(UCPTname,"Net/Virtual Channel/Virtual
Device")]
</xSelect>

</iLonItem>
</List>

Request (use an xSelect statement to return all the Virtual data points that were updated after a
specific time)

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

</iLonItem>
</List>

Request (return all the Virtual data points related to the connection manager based on name)

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Virtual_Dp_Cfg"][contains(UCPTname,"CM")]</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>Net/VirtCh/iLON

System/VirtFb/CMdialInNum</UCPTname>

<UCPTannotation>Dp_Out;xsi:type="Virtual_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
<Item>
<UCPTname>Net/VirtCh/iLON

System/VirtFb/CMgprsIp</UCPTname>

<UCPTannotation>Dp_Out;xsi:type="Virtual_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>

Advertising