Soap body, Lon 100 internet server programm, Soap body -3 – Echelon i.LON 100 e2 Internet Server User Manual
Page 14: Lon 100 internet server program, Lon 100 internet serv, 2 soap body, 1 parameter
LON 100 Internet Server Programmer’s Reference
2-3
The SOAP envelope portion of the sample input message shown above includes the following:
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> ...
You will notice that the fourth line of this example includes the symbol “
...
” This is where
the portion of the message known as the SOAP body would be. The SOAP body portion of the
message is described in the next section.
2.3.1.2 SOAP Body
The SOAP body contains general information about the SOAP message, and contains the
data that is passed to the function as input. The SOAP body conforms to the W3C SOAP 1.1
proposed Technical Recommendation mentioned above.
The SOAP header portion of the sample input message shown above includes the following:
xmlns:echelon="http://wsdl.echelon.com/web_services_ns/ilon100/v1.1/message/"> Data
The name of the function that was invoked is passed as part of the SOAP body, and is
prefixed by the string “Echelon.” In order to use the features included in version 1.1,
the version1.1 namespace URI must be included as an attribute of the function
name element. The
i.
LON 100 namespace URI for version 1.1 of the SOAP interface is:
By passing this Namespace URI in the input messages, the tool transmits version and
platform compatibility information to the target server. In this way, a version 1.1
i.
LON 100
could accept a version 1.0 SOAP message, and recognize from the namespace that it is a
version 1.0 SOAP message. It would then process the message as though it were a version 1.0
i.
LON 100. As a result, all applications written for version 1.0 of the SOAP/XML
interface are compatible with version 1.1 of the SOAP/XML interface. The
i.
LON 100
will return the Namespace URI in all of the response messages it sends, so that a tool can
use the Namespace identifier to check the version and platform of the SOAP interface.
2.3.1.2.1 Parameter
The parameter in the SOAP body is an essential part of the body of the SOAP
message sent to the
i.
LON 100 when you call the functions described in this manual. The
above example shows the string “Data” included in the parameter. This represents
the input that you must supply when you invoke any of the functions described in
this manual.
The majority of the functions of the SOAP/XML interface require a string of XML as input.
When the function is called, the SOAP message is generated, the XML is inserted in the
parameter, and the message is sent. The description of each SOAP function in this