2 creating and modifying the calendar xml file, 3 calendar soap interface, Creating and modifying the calendar xml file -2 – Echelon i.LON SmartServer 2.0 User Manual

Page 151: Calendar soap interface -2, Creating and modifying the calendar xml file, Calendar soap interface

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

10-2

<UCPTaliasName>Holiday</UCPTaliasName>
<UCPTtemporary>0</UCPTtemporary>
<Schedule>
<StartDate>
<UCPTdate>2008-03-12</UCPTdate>
<UCPTyearMask

LonFormat="UCPTyearMask">DW_NUL</UCPTyearMask>

<UCPTmonthMask

LonFormat="UCPTmonthMask">DW_NUL</UCPTmonthMask>

<UCPTdayMask

LonFormat="UCPTdayMask">DW_NUL</UCPTdayMask>

</StartDate>
<EndDate>
<UCPTdate>2015-12-31</UCPTdate>
<UCPTyearMask

LonFormat="UCPTyearMask">DW_NUL</UCPTyearMask>

<UCPTmonthMask

LonFormat="UCPTmonthMask">DW_NUL</UCPTmonthMask>

<UCPTdayMask

LonFormat="UCPTdayMask">DW_NUL</UCPTdayMask>

</EndDate>
<UCPTschedDay

LonFormat="UCPTschedDay">DM_DAY_4</UCPTschedDay>

<UCPTschedMonth

LonFormat="UCPTschedMonth">MN_JUL</UCPTschedMonth>

</Schedule>
<Schedule>
<StartDate>
<UCPTdate>2008-03-12</UCPTdate>
<UCPTyearMask

LonFormat="UCPTyearMask">DW_NUL</UCPTyearMask>

<UCPTmonthMask

LonFormat="UCPTmonthMask">DW_NUL</UCPTmonthMask>

<UCPTdayMask

LonFormat="UCPTdayMask">DW_NUL</UCPTdayMask>

</StartDate>
<EndDate>
<UCPTdate>2015-12-31</UCPTdate>
<UCPTyearMask

LonFormat="UCPTyearMask">DW_NUL</UCPTyearMask>

<UCPTmonthMask

LonFormat="UCPTmonthMask">DW_NUL</UCPTmonthMask>

<UCPTdayMask

LonFormat="UCPTdayMask">DW_NUL</UCPTdayMask>

</EndDate>
<UCPTschedDay

LonFormat="UCPTschedDay">DM_DAY_25</UCPTschedDay>

<UCPTschedMonth

LonFormat="UCPTschedMonth">MN_DEC</UCPTschedMonth>

</Schedule>
<UCPTmaxClient>1</UCPTmaxClient>
<Client>
<UCPTname>Net/LON/iLON

App/Scheduler[0]</UCPTname>

<UCPTservicePath/>
</Client>
</Exception>
</Item>

10.2

Creating and Modifying the Calendar XML File

You can create and manage the #8000010128000000[4].UFPTcalendar.xml file with the Set SOAP
function. The following section, Calendar SOAP Interface, describes how to use Set and the other
SOAP functions provided for the Calendar application.

Alternatively, you can create and manage the #8000010128000000[4].UFPTcalendar.xml file
manually with an XML editor and download it to the SmartServer via FTP. Echelon does not
recommend this, as the SmartServer will require a reboot to read the configuration of the downloaded
file. Additionally, the SmartServer 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 Calendar’s configuration.

10.3

Calendar SOAP Interface

You can use the SOAP interface to perform the following functions on the Calendar:

Function Description

List

Generate a list of the Calendars that you have added to the

Advertising