Calendar

With adding a calendar or a duty roster as part of the alarm configuration, you can define time-based deviations from the default alarm settings. When the alarm is launched at a time that falls into a selected Annual or Week calendar, it will either jump to an alternative alarm or alert an alternative group. If you add a Duty roster to an alarm, persons as assigned to their shifts will be alerted.

The following general information on the calendar concept should be noted:

→ Annal calendars, Week calendars, and Duty rosters can be assigned to several alarms.

→ Several annual and week calendars can be assigned to one alarm.

→ Only one duty roster can be assigned to an alarm.

Calendars can be assigned to an organizational unit or are available to all users as a global entry. In addition, they can go beyond 24 o'clock (beginning: 17:00 end: 06:00 o'clock). In the tool there are three different calendars which can be stored - Annual calendar, Week calendar, and Duty rosters.

Week calendar

• Name: A unique name must be assigned to the Week calendar. Here it is recommended to use a meaningful name, so that with the later selection of the calendar it is clear, which calendar it concerns.
• Weekdays: Weekdays can be selected on which the subsequent time slot is to be valid. Days/times that are not selected are processed (if no other calendar plan is active) with the groups/processes set by default in the alarm.
• Start time and end time: Start and End selects the time for which the calendar plan is valid. The time can be selected for all days (e.g., start: 17:00 end: 06:00).
• Global: With the global switch, the calendar plan can be made available to all organizational units at «On». The selection of the organizational unit is then hidden. The option for a global calendar entry is only available to a root user.
• Organizational unit: If the calendar plan has not been marked as «Global», the selection of the organizational unit is available. The calendar plan is then only available within the selected organizational unit.

Annual calendar

• Name: A unique name must be assigned to the annual calendar. Here it is recommended to use a meaningful name, so that with the later selection of the calendar it is clear, which calendar it concerns.
• Global: With the global switch, the calendar plan can be made available to all organizational units at «On». The selection of the organizational unit is then hidden. The option for a global calendar entry is only available to a root user.
• Organizational unit: If the calendar plan has not been marked as «Global», the selection of the organizational unit is available. The calendar plan is then only available within the selected organizational unit.
• Duration: The annual calendar can be divided into up to 26 time periods. A new section is added with «+» or removed with «-». The period can be configured by selecting the start and end points. The time is used for both points and can be configured separately for start and end point. For this purpose, the time must be adjusted after the respective selection of the day.

You can also export and import Annual calendars.

For the export you can choose between csv and ics format. The ics file can be added to your own calendar easily.

For the import you should use a csv file in the same as the export format:

If you choose to import a calendar, you have the option to overwrite an existing calendar with the same name.

Duty roster

With a duty roster you can organize persons in shifts. As a first step, you have to define a name and select the channels, which shall be used to notify persons (similarly to when you assign persons to groups or to alarms).

Once you click "Save", you will see the option to add persons to the duty roster. You can filter for various fields to find the persons you would like to add.

Once a person is added to the roster, you can define the time frames in which this person is "on duty", either by clicking into the calendar directly or seleting the pen icon. When you click into the calendar directly and have selected the month view, you select full days from 00:00 to 23:59 by default, which you can then adapt via the pen icon. With this, the definition of time periods is the same as in Calendars.

If you select Day or Week, the scale of the calendar will adapt accordingly:

Managing Duty rosters via csv exports and imports   

Use csv exports and imports to manage duty rosters more easily, particularly when it comes to a large amount of persons.  

We recommend to always start with one duty roster, which is manually created, and then export it as csv to have the correct structure. It is important that all persons you would like to import have an employee ID, and all persons in one duty roster have the same channels assigned.   

Sample export of a duty roster where all channels are selected.   

Sample export of a duty roster where only Mobile and SMS channels are selected.   

When importing a file, you have the following options:   

• Create / Add a new duty roster altogether  
• Update an existing duty roster  
• Add additional time frames for existing persons   
• Overwrite time frames with new ones for existing persons  
• Add additional persons to existing persons  
• Overwrite existing persons in a duty roster, i.e., delete persons that are not existent in the import file and add new persons  
• Note that it is not possible to delete a duty roster via import.   

Let’s go through step by step:  

We start with this duty roster setting.
If we export this duty roster, the csv has this file structure.
Now we change the time slot for person 3 but don’t overwrite anything
Result: The new time frame was added
Now we use the same import file and select “overwrite existing periods”.
Now the time frame was adapted – the slot no longer present in the calendar was removed.
Now we remove Person 3 manually from the duty roster, and remove person 1 from the import file.
First, we import with overwrite “off”:
Result: Person 3 is added, Person 1 is still there.
Same source file but overwrite on.
Result: Person 1 is deleted.
Adding a new duty roster: simply adding new rows with a new duty roster name to the import file