beautypg.com

1 soap envelope, 1 w3c namespaces supported in version 4.0, 2 soap header – Echelon i.LON SmartServer 2.0 User Manual

Page 19: Soap envelope -5, Soap header -5

background image

i.LON SmartServer 2.0 Programmer’s Reference

2-5

2.5.1

SOAP Envelope

The SOAP envelope is the highest level in a SOAP message. The SOAP envelope is the highest level
of a SOAP message. The SOAP envelope for any message sent to the SmartServer must conform to
the W3C SOAP 1.1 proposed Technical Recommendation:
http://www.w3.org/TR/2000/NOTE-SOAP-20000508/. The SOAP envelope portion of the sample
input message shown in section 2.3 includes the following:

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


Note: The fourth line of this example includes the symbol “...” This denotes the location of the SOAP
body, which is described in section 2.5.3.

2.5.1.1 W3C Namespaces Supported in Version 4.0

Version 4.0 supports the following W3C namespaces:

SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV=http://schemas.xmlsoap.org/soap/envelope/
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
...

2.5.2

SOAP Header

The SOAP header contains general information about the entire message. This section is also tightly
controlled by the W3C standards. Each element in a SOAP header and all immediate child elements
must be Namespace Qualified; therefore, each user-defined element contains a namespace prefix and a
path to the unique Echelon namespace.

Note: The Version 4.0 SOAP header is only used in a response message (except for the
UCPTvalueFormat for WebBinder response messages). You do not need to supply this information
for a SOAP request.

The following provides an example of a SOAP header in a SOAP response message:


xmlns:p="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
2008-02-25T15:10:35.360-08:00
030000197B82
10.2.124.82
80
2008-02-25T19:11:19Z
90

The SOAP header consists of a complex type with six fields describing different properties of the
message: