2 using the get function on virtual data points, Using the get function on virtual data points -9, Using the get function on virtual data points – Echelon i.LON SmartServer 2.0 User Manual
Page 292
i.LON SmartServer 2.0 Programmer’s Reference
17-9
</Item>
<Item>
<UCPTname>Net/VirtCh/iLON
System/VirtFb/CMdialInIp</UCPTname>
<UCPTannotation>Dp_Out;xsi:type="Virtual_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>
17.4.2
Using the Get Function on Virtual Data Points
You can use the Get function to retrieve the configuration of Virtual data points defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>
elements with a Virtual_Dp_Cfg type. Each <Item> element will include the <UCPTname> of each
Modbus data point whose configuration is to be returned by this function, as shown in the example
below.
Request (use an xSelect statement to return a specific
Virtual data point)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="Virtual_Dp_Cfg">
<UCPTname>Net/VirtCh/iLON
System/VirtFb/CMdialInNum</UCPTname>
</Item>
</iLonItem>
</Get>
Alternatively, you can specify one or more Virtual 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 device.
Request (use an xSelect statement return all the Virtual data points on a specific device)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Virtual_Dp_Cfg"][starts-with(UCPTname,"Net/VirtCh/iLON
System/VirtFb")]
</xSelect>
</iLonItem>
</Get>
Response
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="Virtual_Dp_Cfg">
<UCPTname>Net/VirtCh/iLON
System/VirtFb/CMdialInNum</UCPTname>
<UCPTannotation>Dp_Out</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-26T11:09:27.420-07:00</UCPTlastUpdate>
<UCPTuri>Virtual_Dp_Cfg.htm</UCPTuri>
<UCPTformatDescription>#0000000000000000[0].SNVT_str_asc</UCPTformatDescription>
<UCPTlength>31</UCPTlength>
<UCPTdirection
LonFormat="UCPTdirection">DIR_OUT</UCPTdirection>
<UCPThandle>0</UCPThandle>
</Item>
</iLonItem>
</Get>
The Get function returns an <Item> element for each Virtual data point referenced in the input
parameters you supplied to the function. The properties included within each <Item> element are
initially defined when the Virtual data point is added to the SmartServer. You can write to these data
point properties with the Set function. The following table describes these properties.
Property Description
<UCPTname>
The name of the Virtual data point in the following format: