Instruction Manual

document includes a sample XML string you could supply as the <Data> parameter, and a

description of how to build the XML string.

However, there are a few exceptions to this rule. The DataPointRead, DataPointWrite,

and DataPointResetPriority functions do not include a <Data> parameter as part

of their input messgaes. They take a series of input parameters, each of which contains a

single value, as input. These input parameters are inserted in place of the <Data> parameter

that is included in the SOAP body of all the other SOAP functions. This is described in more

detail later in the document in Chapter 3, where the DataPoint functions are described.

2.3.2 Response Message

The following represents the basic format of the SOAP message returned by the i.LON 100

when you call any of the functions described in this document.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<SOAP-ENV:Envelope

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header>

<p:messageProperties

xmlns:p="http://wsdl.echelon.com/web_services_ns/ilon100/v1.1/type">

</p:messageProperties>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<echelon:FunctionNameResponse

xmlns:echelon="http://wsdl.echelon.com/web_services_ns/ilon100/v1.1/message/">

<Result>Result</Result>

</echelon:FunctionNameResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

There are two differences between the input messages sent to the i.LON 100, and those

returned by the i.LON 100. The first is the inclusion of a SOAP header between the SOAP

envelope and SOAP body. The second is the inclusion of the <Result> parameter contained

within the SOAP body.

2.3.2.1 SOAP Header

The SOAP/XML interface has been modified in version 1.1 to include a SOAP header in all

response messages. The SOAP header section of each response message is between the SOAP

envelope and the SOAP body, and is shown below:

<SOAP-ENV:Header>

<p:messageProperties

xmlns:p="http://wsdl.echelon.com/web_services_ns/ilon100/v1.1/type">

</p:messageProperties>

</SOAP-ENV:Header>

The SOAP Header contains general information about the message, and can be used to

identify the i.LON 100 that sent it. This section is also tightly controlled by the W3C

i.LON 100 Internet Server Program2-4 mer’s Reference