Creating and modifying the eventcalendar.xml file, Event calendar soap interface, Event calendar soap interface -3 – Echelon i.LON 100 e2 Internet Server User Manual
Page 170: 1 event calendar soap interface

i.
LON 100 Internet Server Programmer’s Reference
11-3
XML Configuration File
11.2 Creating and Modifying the EventCalendar.XML File
You can create and modify the EventCalendar.XML file with the EventCalendarSet SOAP
function. The following section, Event Calendar SOAP Interface, describes how to use the
EventCalendarSet function and the other SOAP functions provided for the Event Calendar
application.
Alternatively, you can create and modify the EventCalendar.XML file manually with an
XML editor, and download it to the
i.
LON 100 via FTP. Echelon does not recommend this, as
the
i.
LON 100 will require a reboot to read the configuration of the downloaded file.
Additionally, the
i.
LON 100 performs error checking on all SOAP messages it receives before
writing to the XML file. It will not perform error checking on any XML files you download via
FTP, and thus the application may not boot properly.
If you plan to create the XML file manually, you should review the rest of this chapter first,
as it describes the elements and properties in the XML file that define each Event Calendar.
For instructions on creating or modifying an XML file manually, see Manually Modifying an
on page 15-1.
11.2.1
Event Calendar SOAP Interface
The SOAP interface for the Event Calendar application includes four functions. Table 55 lists
and describes these functions. For more information on any of these functions, see the
sections following Table 55.
Table 55 Event Calendar SOAP Interface
Function Description
EventCalendarList
Use this function to retrieve a list of the Event Calendars that you
have added to the
i.
LON 100. For more information, see
on page 11-4.
EventCalendarList
EventCalendarGet
Use this function to retrieve the configuration of any Event
Calendar that you have added to the
i.
LON 100. For more
information, see EventCalendarGet on page 11-5.
EventCalendarSet
Use this function to create an Event Calendar, or to overwrite the
configuration of an existing Event Calendar. For more information,
see EventCalendarSet on page 11-12.
EventCalendarDelete Use this function to delete an Event Calendar. For more
information, see EventCalendarDelete on page 11-13.