3 lonworks devices, 1 using the list function on a lonworks device, Orks – Echelon i.LON SmartServer 2.0 User Manual
Page 217: Devices -17, Using the list function on a l, Device -17, Devices
i.LON SmartServer 2.0 Programmer’s Reference
14-17
</Delete>
Response
<DeleteResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem >
<UCPTfaultCount>0</UCPTfaultCount>
<Item>
<UCPTname>MyOldNetwork/MyOldChannel</UCPTname>
</Item>
</iLonItem>
14.3
L
ON
W
ORKS
Devices
The following section describes how to use the List, Get, Set, and Delete functions on L
ON
W
ORKS
devices.
Note: Section 21.1.4, Creating and Installing a LonWorks Device in Visual Basic.NET, includes a C#
programming example demonstrating how to use the L
ON
W
ORKS
Device SOAP interface to create and
install L
ON
W
ORKS
devices. Section 21.2.4, Creating and Installing a LonWorks Device in Visual
Basic.NET, includes a Visual Basic example demonstrating how to do this.
Section 22.3.3, Creating and Installing a LonWorks Device in Java, includes a Java programming
example demonstrating how to create and install external L
ON
W
ORKS
devices.
14.3.1
Using the List Function on a L
ON
W
ORKS
Device
You can use the List function to retrieve a list of L
ON
W
ORKS
devices on the SmartServer or to retrieve
a list of L
ON
W
ORKS
devices in a specific LNS network database via the LNS Proxy Web service. The
List function takes an <iLonItem> element that has an xSelect statement with a LON_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="LON_Device_Cfg"]</xSelect>
</iLonItem>
</List>
Alternatively, you can specify one or more device properties in the xSelect statement to filter the items
returned by the List function, including the <UCPTname>, <UCPTitemStatus>, and
<UCPTlastUpdate> properties.
Request (return all devices on a specific L
ON
W
ORKS
channel)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect> //Item[@xsi:type="LON_Device_Cfg"][starts-with(UCPTname,"MyNetwork/Channel 1")]
</xSelect>
</iLonItem>
</List>
Request (return all devices that are uncommissioned)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect> //Item[@xsi:type="LON_Device_Cfg"] [UCPTitemStatus="IS_UNCONFIGURED"]
</xSelect>
</iLonItem>
</List>
Request (return all devices 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_Device_Cfg"] [UCPTlastUpdate> "2008-03-26T16:25:00"]
</xSelect>
</iLonItem>
</List>