:SET_CALE

Script-Statement: Fügt ein Datum oder einen Zeitraum in ein Kalenderereignis ein oder löscht es/ihn.

Syntax

:SET_CALE Calendar, Calendar Event, [Date Format:]Date1[,[Date Format:]Date2[,Action]]

Syntax	Beschreibung/Format
Calendar	Name des Kalender-Objektes, dem ein Datum/Zeitraum hinzugefügt bzw. entfernt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Calendar Event	Name des Kalenderereignisses, in dem/aus dem ein Datum/Zeitraum hinzugefügt oder entfernt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Date1 und Date2	Datum im Format JJMMTT oder JJJJMMTT Format: Script-Literal oder Script-Variable (Optional) Sie können ein anderes Datumsformat angeben: Geben Sie das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und das Datum ein.
Action:	Kennzeichen für das Hinzufügen oder Entfernen. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: „ON“ (Standardwert), „OFF“ „ON“ - Datum/Zeitraum hinzufügen „OFF“ - Datum/Zeitraum entfernen

Mit diesem Script-Statement können Sie einem Kalenderobjekt ein Datum/einen Zeitbereich hinzufügen oder daraus entfernen.

Soll nur ein einzelnes Datum hinzugefügt oder entfernt werden, entfällt die Angabe von Datum2. Für einen Zeitraum müssen Datum1 und Datum2 angegeben werden.

Die Angabe eines Datumsformats ist optional. Wird kein Datumsformat verwendet, muss das Datum in den Formaten „JJMMTT“ oder „JJJJMMTT“ angegeben werden.

Wenn das angenommene Kalenderereignis nicht existiert, erstellt das Script-Statement ein neues, nicht wiederkehrendes Kalenderereignis. Als Gültigkeitsbereich wird standardmäßig das aktuelle Jahr minus NOW_MINUS und plus NOW_PLUS genommen. Beide Angaben sind Keys, die der Administrator in der AE-Variablen UC_CLIENT_SETTINGS angegeben hat. Der Gültigkeitsbereich kann nachträglich mit der Script-Funktion MODIFY_OBJECT geändert werden.

Beim Hinzufügen von Daten oder Zeiten ignoriert dieses Script-Statement vorhandene Datums-/Zeitangaben. Das Gleiche gilt, wenn Sie ein Datum/einen Zeitraum entfernen, das/der nicht existiert.

Die Script-Funktion VALID_CALE kann verwendet werden, um zu überprüfen, ob ein Datum für ein Kalenderobjekt und ein Kalenderereignis gültig ist.

Während der Verarbeitung dieses Script-Statements wird keine Kalenderberechnung ausgelöst. Öffnen und speichern Sie das Kalenderobjekt manuell, um den Kalender neu zu berechnen.

Beispiele

Das erste Beispiel fügt dem Kalender „Bereitschaft“ und dem Kalenderereignis „BU“ ein Datum hinzu.

:SET_CALE "READINESS", "BU", "YY-MM-DD:00-12-24"

Das zweite Beispiel entfernt den heutigen Tag aus diesem Kalender.

:SET &TODAY# = SYS_DATE()
:SET_CALE "READINESS", "BU", &TODAY#,, OFF

Das dritte Beispiel ermittelt Beginn und Ende der aktuellen Woche. Danach wird der Zeitraum in den Kalender eingetragen.

:SET &TODAY# = SYS_DATE()
:SET &BEGINNING# = FIRST_OF_PERIOD (&TODAY#, "WW")
:SET &END# = LAST_OF_PERIOD (&TODAY#, "WW")
:SET_CALE "READINESS", "BU", &BEGINNING#, &END#

Siehe auch: