The holiday calendars are managed in this mask. The calendars are displayed in the menu. The holiday days settings are made with the HS/FS running. The holiday calendar is taken into account in the universal timers and represents a time period. The holiday begins on the start date at 0:00:00 and ends on the end date at 23:59:59. Overlaps do not have any effect. The holiday calendar and the assigned holiday days are saved retentively in the HS/FS.
1.Tabs
1.2.End point
Holiday calendars can be accessed via the end point interface of the HS/FS.
There is a description of the call parameters here.
There is a description of the call parameters here.
Note
Any holiday calendar can of course be used instead of the holiday calendar used in all the call-up examples in the following table.
Placeholders are specified in UPPER CASE.
Placeholders are specified in UPPER CASE.
1.2.1.Methods
Method | Description/Call |
---|---|
meta | Retrieval of metadata of the holiday calendar.https://HS_IP/endpoints/call?key=VC@my_vcal&method=meta&user=USER&pw=PWD |
get | Retrieval of a calendar.https://HS_IP/endpoints/call?key=VC@my_vcal&method=get&user=USER&pw=PWD |
set | Setting a calendar (example: Calendar is activated, the time period is 03.07.2017 until 11.08.2017).https://HS_IP/endpoints/call?key=VC@my_vcal&method=set&active=1&from=20170703&to=20170811&user=USER&pw=PWD |
1.2.2.Fields
ID
The value entered here forms the unique object keyof the end point, together with the fixed prefix "VC", with which the ID is connected by an '@' character.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Description
A meaningful description of the holiday calendar.
Holiday calendars can be searched via the end point interface, where a word from the description begins with the search word used there.
Holiday calendars can be searched via the end point interface, where a word from the description begins with the search word used there.
Tags
A list of terms, separated by commas (",").
Holiday calendars can be searched via the end point interface, where an individual tag completely matches the search word used there.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
Holiday calendars can be searched via the end point interface, where an individual tag completely matches the search word used there.
Permitted characters are: A-Z, a-z, 0-9, hyphen ("-") and underscore ("_")!
User groups
Important
This item is only available when user groups have been activated!
User groups can be authorised to access this holiday calendar for reading (left column) and/or writing (right column) via the end point interface.