4 using the delete function on a virtual channel, 2 virtual devices, 1 using the list function on virtual devices – Echelon i.LON SmartServer 2.0 User Manual

Page 287: 2 using the get function on virtual devices, Using the delete function on a virtual channel -4, Virtual devices -4, Using the list function on virtual devices -4, Using the get function on virtual devices -4, Virtual devices

Advertising

i.LON SmartServer 2.0 Programmer’s Reference

17-4

17.1.4

Using the Delete Function on a Virtual Channel

You can use the Delete function to delete a Virtual channel on the SmartServer. The Delete function
takes an <Item> element with a Virtual_Channel_Cfg type as its input. The <Item> element only
needs to include the Virtual channel’s <UCPTname> property in the Delete Request as demonstrated
in the following code sample:

Request

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

xsi:type="Virtual_Channel_Cfg">

<UCPTname>Net/Virtual

Channel

1</UCPTname>

</Item>

</iLonItem>
</Delete>

Response

<Item>
<UCPTname>Net/Virtual

Channel

1</UCPTname>

</Item>
</iLonItem>

17.2

Virtual Devices

The following section describes how to use the List, Get, Set, and Delete functions on Virtual devices.

17.2.1

Using the List Function on Virtual Devices

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

Request

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="Virtual_Device_Cfg"]</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</UCPTname>

<UCPTannotation>VirtualDevice;local;xsi:type="Virtual_Device_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>

You could use the list of <Item> elements returned by this function as input for the Get function. The
Get function would then return the configuration of each device included in the list. The next section
describes the properties included in each of these elements.

17.2.2

Using the Get Function on Virtual Devices

You can use the Get function to retrieve the configuration of a Virtual device defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>

Advertising