Echelon i.LON SmartServer 2.0 - Manual (Page 27)

i.LON SmartServer 2.0 Programmer’s Reference 2-13
Example 9 – Select a formatter report:
xSelect = "//Item[@xsi:type=”TemplateManager_NVT_Cfg”][UCPTlanguage="enu"]
[UCPTname="#0000000000000000[0].standard"][position()>=0 and
position()<10]"
Notes:
• For List functions, you must include an xSelect statement in the SOAP message request.
• For Get, Delete, and Read functions, the xSelect statement in the SOAP message request is
optional.
o If a Get, Delete, or Read function is called only with an xSelect statement, the function returns
all items of the specified xsi type that meet the criteria specified in the xSelect statement.
o If a Get, Delete, or Read function is called with an xSelect statement and one or more item
instances, the xSelect statement is overlaid on the item instances. This means that the xSelect
statement is an and expression (not an or expression or an exclusive or expression).
• You can only filter for properties that are included in a message response (except for the
property, which you can always filter). In a List request of Dp_Cfg items
(data points on the Data Server) for example, you can filter on the property, but
you cannot filter on the . In a Get request of Dp_Cfg items, however,
you can filter on the property because this property is returned in the
Get message response.
• The SmartServer can only process one item type (xsi:type) per SOAP message (e.g., only
Channel_Cfg, LON_Dp_Cfg, or UFPTalarmGenerator). This is also true for xSelect responses
(except for UCPTlastUpdate which is a special case), Set messages, and other SOAP commands.
The first item type specified is always the one returned in the response message.
• Not all properties can be filtered and not all filter combinations work.
2.5.8.1 xsi Types
The following section lists the common xsi (items) types that you will include in xSelect statements.
For a list of all the item types included in the SOAP interface, see the Version 4.0 XML schema type
(iLON100.xsd), which is installed in the L
ON W ORKS \iLon100\images\iLon100 4.0x\web\WSDL\v4.0
folder on your computer when you install the SmartServer software
Driver Item xsi type
Network Network_Cfg
Channel Channel_Cfg
Device Device_Cfg
Functional Block
Fb_Cfg
SmartServer Applications
Alarm Generator UFPTalarmGenerator_Cfg
Alarm Notifier UFPTalarmNotifier_Cfg
Analog Functional Block UFPTanalogFunctionBlock_Cfg
Calendar UFPTcalendar_Cfg
Data Logger UFPTdataLogger_Cfg
Digital Input UFPTdigitalInput_Cfg
Digital Ouput UFPTdigitalOutput_Cfg
Node Object UFPTnodeObject_Cfg
Pulse Counter UFPTpulseCounter_Cfg
Real-TimeClock UFPTrealTimeClock_Cfg
General (no Driver)
Scheduler UFPTscheduler_Cfg