Programming samples, Getting started, I.lon 100 version 1.1 soap/xml interface upgrades – Echelon i.LON 100 e2 Internet Server User Manual
Page 7: Programming samples -2, Getting started -2, 2 programming samples, 3 getting started
You can create or modify the files using any XML editor or ASCII text editor. This document
provides examples you can use when creating the XML configuration files for your
i.
LON
100, and instructions to follow when downloading these files to the
i.
LON 100. The XML files
used by the
i.
LON 100 applications conform to the XML 1.0 Technical Recommendation:
Echelon strongly recommends that you use the SOAP interface to configure the
applications of your
i.
LON 100. The
i.
LON 100 performs error-checking on all data
written in a SOAP message, so that invalid data will not be written to any of the XML files.
The
i.
LON 100 will not perform error-checking on any XML files downloaded to it via FTP,
and so manually editing the XML files may cause errors during the boot process.
Additionally, you can send SOAP messages to the
i.
LON 100 while it is operating, and the
i.
LON 100 will update the XML files affected by the SOAP messages without requiring a
reboot.
You may find the information in this document that pertains to manually creating and
managing XML files useful if you are using several
i.
LON 100s, and would like to use the
same configuration on each one. In that case, you could configure one of the
i.
LON 100s, copy
its XML files, and download them to the appropriate directories of the other
i.
LON 100s to
obtain the same configuration in all of them. For more information on how to download XML
configuration files, see Copying XML Files Between i.LON 100s on page 15-2.
1.2 Programming Samples
This document includes programming samples written in Microsoft Visual Basic .NET ® to
illustrate concepts described in this manual. To make these samples more easily understood,
they have been simplified. Error checking has been removed, and in some cases, the
examples are only fragments that may not compile without errors or warnings.
1.3 Getting Started
You should review Chapter 2, SOAP Messages and the i.LON 100 WSDL File , before
proceeding to the rest of this document and learning about the functions and applications of
the SOAP/XML interface. Chapter 2 describes the WSDL file which defines the
i.
LON 100
SOAP/XML interface, and contains vital information you will need to know before
referencing the WSDL file and using the various functions of the SOAP/XML interface. The
final section of Chapter 2, Writing SOAP Applications, sets a roadmap you can follow when
reading through the rest of the document.
If you are upgrading to version 1.1 of the SOAP/XML interface, it is also recommended that
you review the next section, i.LON 100 Version 1.1 SOAP/XML Interface Upgrades, before
proceeding. This section outlines the changes that have been made to the SOAP/XML
interface for version 1.1.
1.4
i.
LON 100 Version 1.1 SOAP/XML Interface Upgrades
This section provides an overview of the changes made to the SOAP/XML interface for
version 1.1, and includes the following sections:
•
Modified SOAP Applications and Functions
•
Changes to SOAP Message Formats
You may find these changes advantageous when using version 1.1 of the SOAP/XML
interface. You should also note that version 1.1 provides complete compatibility with version
LON 100 Internet Server Program
1-2
mer’s Reference