Schedule

A schedule is used to influence tags in Web Port based on time and date. It can be, for example, to control lighting and fans based on time of day. Schedules can also be used to shut down systems to save energy, for example during holiday periods.

NOTE!

To be able to use the Web Port functionality for Schedules it needs to be activated under System settings/Server/Schedules.

A schedule consists of:

• a number of different states (see "States")
• a weekly schedule (see "Weekly schedule")
• special periods (see "Special periods")

A schedule can be set in different modes. These consist of Inactive, Auto and all states defined for the schedule (see "Local schedules"). If the schedule is set to inactive, it is excluded when evaluating schedules. If the schedule is set to Auto, the weekly schedule and special periods are evaluated when the fulfilled condition is activated. If no state is met, the default state is activated.

Access to a schedule can be given either by connecting it to a page that the user has access to, or by giving the user a permission specifically for schedules.

Local schedules

Web Port allows you to read local schedules in DUC/PLC to manage these in Web Port's schedule management interface. This is done by activating local schedule and selecting a tag reference and if needed a schedule script. Read more about schedule scripts in Chapter "Schedule scripts".

For some protocols (eg. Bacnet, Fidelix) to load the schedule into the data type SCHEDULE. For the control systems that cannot be loaded as SCHEDULE, a schedule script is used. Also add how many on/off events the schedule script should handle (typically how many daily on/offs).

To manage the local states, you need to create two states. One for local off-state with event "local = 0" and one for local on state "local = 1".
Then the schedule is handled in the same way as the central one, by selecting one of the local states when new events or periods are added.
See section "Schedule script" for examples of schedule script.

States

States indicate different modes of the schedule. For example, it can be OFF and ON. The states are defined per schedule and can be two or more. Each state has the following settings:

Setting:	Description:
Description	Descriptive text for the state
Event	Indicates what should happen when the state is active

Inforamtion

An event in its simplest form updates a single tag and is defined as follows:
TAG=value

State associated with local schedules is defined according to:
Local=value

Example:
LB01_GT11_SP = 21 Several tags can be affected by separating them with a “&” symbol, e.g. LB01_GT11_SP=21&LB01_GT12_SP=24
Information: To perform more complex actions, CALL SCRIPTS can be run. This is done by writing: script#script name(parameters)
Script names can be read from SYSTEM SETTINGS/SCRIPTS/CALL SCRIPTS

Parameters are not mandatory but are a good way to send information to the script. Parameters are written as par1 = value, par2 = value where par1 and par2 become variables with set values in the script.

Example:
The following example calls the script sum with two parameters x=3 and y=5. This assumes that a called script with the name sum exists and that it uses x and y as parameters (see chapter 11.1)
script#sum (x=3, y=5)

To change a state, open the schedule in change mode by first selecting the schedule in the list under SCHEDULES and then clicking the EDIT button in the dialog that opens. States have an empty description are automatically deleted when the schedule is saved.

Weekly schedule

A weekly schedule consists of days for Monday-Sunday, holiday eves and public holidays. To activate a state for one or more of the days, an event is created by clicking on the NEW EVENT button.

An event has the following settings:

Setting:	Description:
Start time	Start time for the event
End time	End time for the event
m-f	The event applies Monday-Friday
m-s	The event applies Monday-Sunday
Monday	The event applies to Mondays
Tuesday	The event applies to Tuesdays
Wednesday	The event applies to Wednesdays
Thursday	The event applies to Thursdays
Friday	The event applies to Fridays
Saturday	The event applies to Saturdays
Sunday	The event applies to Sundays
Holiday Eve	The event applies to holiday eves
Holiday	The event applies to public holidays
State	The state to be activated during the time period

Information

An event is shown as a time span along with what state applies within the span.
Example:
07:00-16:30 [ON]

To edit an event go to SCHEDULES and click on the desired schedule in the list. Then click on the desired event in the Weekly Schedule.

To remove an event, the small garbage to the right of the respective event can be clicked.
States become green when they are active.
To make any changes, click on SAVE. Clicking CANCEL returns the changes to what they were before they were made.

Information

An event can also be linked to a group of days. To create groups see chapter 10.3

Special periods

Special periods can extend over several days and have the following settings:

Setting:	Description:
Start time	Start time and date of the event
End time	End time and date of the event
State	The state to be activated during the time period

Information

An event is shown as a time span along with what state applies within the span.
Example:
20150703 16:30 - 20150803 07:00 [OFF]

To edit a period go to SCHEDULES and click on the desired schedule in the list. Then click on the desired period under Special periods.

To remove a period, the small garbage to the right of the respective period can be clicked. The period will be removed from Web Port when it has passed.

Information

If several events and periods overlap, the period has priority. This is also marked with green color.
Example:
Weekday: 07:00 - 16:30 [ON]
Period: 20150703 07:30 - 20150803 16:30 [OFF]
Where these two rules overlap, the period will have priority over the weekday.
When a rule is active, it becomes green.

Calendar view

A schedule can also be presented as a calendar by clicking on the calendar icon to the left in the
table. From this view, events and periods can be created through the top menu and changes can be made by clicking or dragging an already created event/period. Remember to click SAVE in the top menu to save your changes. Clicking CANCEL in the top menu will cause any changes to be lost.

Creating a schedule

First make sure that schedules are activated, under System settings/Server/Schedules.
To create a schedule, go to SCHEDULES and then select New schedule.

The following settings can be made:

Setting:	Description:
Name	Name of the schedule
Description	Descriptive text for the schedule
Category	Text describing the category of schedule
Page link	Connects the schedule to a specific page in Web Port
Standard state	The state the schedule uses when nothing else is set

Local schedule

Setting:	Description:
Active	Indicates whether local schedule is used
Schedule script	Indicates any script used to read/write local schedules
#On/Off	Number of potential on and off-sets in the control system
Use eves	Set whether local schedule supports holiday eves
Use public holidays	Indicates whether local schedule supports holidays
Use periods	Indicates whether local schedule supports special periods

State 0 (default)

Setting:	Description:
Description	Description of state 0. This state is activated by default
Action	What should happen when the state is active

State 1

Setting:	Description:
Description	Description of state 1
Action	What should happen when the state is active

Information

To add more states, click + STATE. Don't forget to save any changes that have been made before they are lost.

If local schedule is used, Action must be indicated as "local = 0" for OFF and "local = 1" for ON.

The default state is written once every minute to the device.

Example of local schedule combined with central override:
Two states for handling the local schedule are configured as
“Local OFF” as local=0 and “Local ON” as local=1
In addition three states are configured to override the local schedule in the control system, “Override disabled” as SCH1_CMD=0, “Central OFF” as SCH1_CMD=1 and “Central ON” as SCH1_CMD=2.

Mode is set to auto.

Edit schedule

To edit a schedule go to SCHEDULES and then select the desired schedule from the list. In the dialog that opens, settings can be made for schedules and periods. To change the schedule's default settings, click the EDIT button in the dialog.

Delete schedule

To remove a schedule, go to SCHEDULES and then select the desired schedule from the list. In the dialog that opens, click the DELETE button and then confirm your selection.