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

i.LON SmartServer 2.0 Programmer’s Reference 4-11
or more <Item> elements. Each <Item> element includes a <UCPTname> property that specifies a
unique data point to be created or modified.
Each <Item> element may also include a series of properties that define the configuration of the new
(or modified) data point within the Data Server. This set of properties is the same, whether you are
creating a new data point or modifying an existing data point. The previous section, Using the Get
Function on the Data Server, details the properties you can include in the Set function.
You can set multiple data points with a single Set message. However, you should not attempt to create
or write to more than 100 data points with a single call to the Set function. Additionally, to optimize
the memory available to the SmartServer, you should not have more than 1,000 data points in your
network at any time.
The following example demonstrates how to add a new SNVT_temp f [1] input data point to the data
server on the Net/LON/iLON App/VirtFB functional block.
Request
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="Dp_Cfg">
<UCPTname>Net/LON/iLON App/VirtFb/temp_f[1]</UCPTname>
<UCPTannotation>Dp_In</UCPTannotation>
<UCPTformatDescription>#0000000000000000[0].SNVT_temp_f#US</UCPTformatDescription>
<UCPTdirection
LonFormat="UCPTdirection">DIR_IN</UCPTdirection>
<UCPTpersist>1</UCPTpersist>
<UCPTdefOutput
LonFormat="#0000000000000000[0].SNVT_temp_f#US">72.5</UCPTdefOutput>
<UCPTunit field="">°F</UCPTunit>
<ValueDef>
<UCPTindex>0</UCPTindex>
<UCPTname>OCCUPIED</UCPTname>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_temp_f#US">69.8</UCPTvalue>
</ValueDef>
<ValueDef>
<UCPTindex>1</UCPTindex>
<UCPTname>UNOCCUPIED</UCPTname>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_temp_f#US">60.8</UCPTvalue>
</ValueDef>
<ValueDef>
<UCPTindex>2</UCPTindex>
<UCPTname>STANDBY</UCPTname>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_temp_f#US">66.2</UCPTvalue>
</ValueDef>
</Item>
</iLonItem>
</Set>
Response
<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem >
<UCPTfaultCount>0</UCPTfaultCount>
<Item>
<UCPTname>Net/LON/iLON
App/VirtFb/temp_f[1]</UCPTname>
</Item>
</iLonItem>
</SetResponse>
4.3.4 Using the Read Function on the Data Server
You can use the Read function to read the value and status of any data point that you have added to the
Data Server. The input parameters you supply to the function will include one or more <Item>
elements. Each <Item> element includes a <UCPTname> property that specifies the data points whose
values and statuses are to be returned.
Alternatively, you can use an xSelect statement to return the values and statuses of a specific set of
data points on the Data Server. The filters you can use in an xSelect statement in the Read function