Using the get function on a l, Orks, Functional block -36 – Echelon i.LON SmartServer 2.0 User Manual
Page 236: Functional block
i.LON SmartServer 2.0 Programmer’s Reference
14-36
<Item>
<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[1]</UCPTname>
<UCPTannotation>#8000010000000000[3].UFPTDigitalOutput;xsi:type="LON_Fb_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>
14.6.2
Using the Get Function on a L
ON
W
ORKS
Functional Block
You can use the Get function to retrieve the configuration of a functional block defined on the
SmartServer or in a specific LNS network database. The input parameters you supply to this function
will include one or more <Item> elements with a LON_Fb_Cfg type. Each <Item> element will
include the <UCPTname> of each functional block whose configuration is to be returned by this
function, as shown in the example below.
Request (return a specific functional block)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Fb_Cfg">
<UCPTname>Building 2/Channel 1/DIO-5/Digital Output[0]</UCPTname>
</Item>
</iLonItem>
</Get>
Alternatively, you can specify one or more functional block properties in the xSelect statement to filter
the items returned by the Get function, including the <UCPTname> to filter functional blocks based on
their parent device, and the <UCPTfptKey> to filter functional blocks based on the functional profile
template.
Request (use an xSelect statement return all the functional blocks on a specific L
ON
W
ORKS
device)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect> //Item[@xsi:type="LON_Fb_Cfg"][starts-with(UCPTname,"Building 2/Channel
1/DIO-5/")]</xSelect>
</iLonItem>
</Get>
Request (use an xSelect statement to return all functional blocks from a specific manufacturer
based on the functional profile template)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect> //Item[@xsi:type="LON_Fb_Cfg"][UCPTfptKey="#8000010000000000[3].UFPTDigitalCounter"]
</xSelect>
</iLonItem>
</Get>
Response
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="LON_Fb_Cfg">
<UCPTname>Building 2/Channel 1/DIO-5/Digital Counter[0]</UCPTname>
<UCPTannotation>#8000010000000000[3].UFPTDigitalCounter;xsi:type="LON_Fb_Cfg"
</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-03-31T12:33:52.013-07:00</UCPTlastUpdate>
<UCPTuri>LON_Fb_Cfg.htm</UCPTuri>
<UCPTfbIndex>1</UCPTfbIndex>
<UCPTfptKey>#8000010000000000[3].UFPTDigitalCounter</UCPTfptKey>
<UCPTdynamic
LonFormat="UCPTdynamic">DDT_STATIC</UCPTdynamic>
</Item>
<Item
xsi:type="LON_Fb_Cfg">
<UCPTname>Building 2/Channel 1/DIO-5/Digital Counter[1]</UCPTname>
<UCPTannotation>#8000010000000000[3].UFPTDigitalCounter;xsi:type="LON_Fb_Cfg"
</UCPTannotation>