Urlaubskalender
Inhalt
In dieser Maske werden die Urlaubskalender verwaltet. Die Kalender werden im Menü angezeigt. Die Einstellung der Urlaubstage wird bei laufendem HS/FS vorgenommen. Der Urlaubskalender wird in den Universalzeitschaltuhren berücksichtigt und stellt einen Zeitraum dar. Der Urlaub beginnt am Startdatum um 0:00:00 Uhr und endet am Enddatum um 23:59:59. Überschneidungen haben keine Auswirkungen. Urlaubskalender und die zugeordneten Urlaubstage werden remanent im HS/FS gespeichert.

1.Register

1.1.Daten

Bezeichnung

Unter diesem Begriff wird der Urlaubskalender im HS/FS geführt (z. B. Sommerferien).
Über die Endpunkt-Schnittstelle können Urlaubskalender gesucht werden, bei denen ein Wort aus der Bezeichnung mit dem dort verwendeten Suchwort beginnt.

1.2.Endpunkt

Auf Urlaubskalender kann über die Endpunkte-Schnittstelle des HS/FS zugegriffen werden.
Eine Beschreibung der Aufruf-Parameter gibt es hier.
Hinweis
Anstelle des in allen Aufruf-Beispielen in der folgenden Tabelle eingesetzten Urlaubskalenders, kann natürlich jeder beliebige Urlaubskalender verwendet werden.

Platzhalter sind in GROSSBUCHSTABEN angegeben.

1.2.1.Methoden

MethodeBeschreibung/Aufruf
metaAbruf von Meta-Daten des Urlaubskalenders.
https://HS_IP/endpoints/call?key=VC@my_vcal&method=meta&user=USER&pw=PWD
getAbruf eines Kalenders.
https://HS_IP/endpoints/call?key=VC@my_vcal&method=get&user=USER&pw=PWD
setSetzen eines Kalenders (Beispiel: Kalender wird aktiviert, Zeitraum ist der 03.07.2017 bis zum 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.Felder

ID
Der hier eingegebene Wert bildet zusammen mit dem fest vorgegebenen Präfix "VC", mit dem die ID durch ein '@'-Zeichen verbunden ist, den eindeutigen Objekt-Schlüssel des Endpunkts.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Beschreibung
Eine sprechende Beschreibung des Urlaubskalenders.
Über die Endpunkt-Schnittstelle können Urlaubskalender gesucht werden, bei denen ein Wort aus der Beschreibung mit dem dort verwendeten Suchwort beginnt.
Tags
Eine Liste von Begriffen, getrennt durch Kommata (",").
Über die Endpunkt-Schnittstelle können Urlaubskalender gesucht werden, bei denen ein einzelner Tag vollständig mit dem dort verwendeten Suchwort übereinstimmt.
Erlaubte Zeichen sind: A-Z, a-z, 0-9, Bindestrich ("-") und Unterstrich ("_")!
Benutzergruppen
Achtung
Dieser Punkt ist nur verfügbar, wenn Benutzergruppen aktiviert wurden!
Benutzergruppen können berechtigt werden, über die Endpunkte-Schnittstelle auf diesen Urlaubskalender zum Lesen (linke Spalte) und/oder zum Schreiben (rechte Spalte) zuzugreifen.