1 dataserverwrite fault responses – Echelon i.LON 100 e2 Internet Server User Manual

Page 69

Advertising

5-25

<Result>
Parameter

<NVL>

</NVL>

<NVL>

<UCPTfieldName>state</UCPTfieldName>

</NVL>

</iLONDataServer>

</Result>

5.2.1.5.1 DataServerWrite Fault Responses

As of version 1.1, the

LON 100 will return a detailed fault response message if it fails to

update the value of any of the data points specified in the <Data> parameter. Consider a case

where you specify input to update the values of 3 data points called NVL_myNetworkVar_1,

NVL_myNetworkVar_2, and NVL_myNetworkVar_3. If the

LON 100 is unable to update

any one of the 3 data points for any reason, none of the data points will be updated, and a

fault response message will be returned that indicates which data points the

LON 100 was

unable to update, and why.
The fault message will be returned using the same error reponse format as described in the

SOAP Error Responses section in Chapter 2 of this document. However, the SOAP envelope
will contain an additional element called the

<SOAP-ENV:detail>

after the

<SOAP-

ENV:faultstring>

element. The

<SOAP-ENV:detail>

will contain a child-element for each

data point that the

LON 100 was unable to update.

In the following example, the

LON 100 is unable to update the NVL_myNetworkVar_1 and

NVL_myNetworkVar_2 data points

. The <SOAP-ENV:detail>

element includes a child

element for each of these data points containing properties identifying the data point

(UCPTindex, UCPTpointName, UCPTdataPointType) and the error code and description
(faultcode and faulstring) that describes why the

LON 100 was unable to update the data

point. Remember that the value of the NVL_myNetworkVar_3 data point would not be

updated by the funtion in this case, even though the new value passed to the function for the
data point is valid.

<Data>
Parameter

<UCPTpointName>NVL_myNetworkVar_1</UCPTpointName>
<UCPTvalue>500.0 1</UCPTvalue>
</NVL>
<NVL>

<UCPTpointName>NVL_myNetworkVar_3</UCPTpointName>
<UCPTvalue>100.0 1</UCPTvalue>
</NVL>
</iLONDataServer>
</Data>

Advertising