Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > :SET_CALE

:SET_CALE

Script-Anweisung: Fügt einem Kalenderbegriff ein Datum oder einen Zeitraum hinzu oder entfernt diese.

Syntax

:SET_CALECalendar, Calendar Keyword, Date1, [Datum2], [Aktion]

Syntax	Beschreibung/Format
Kalender	Name des Kalender-Objektes, dem ein Datum/Zeitraum hinzugefügt bzw. entfernt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Kalenderbegriff	Name des Kalenderbegriffs, dem ein Datum/Zeitraum hinzugefügt bzw. entfernt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Datum1 und Datum2	Angabe eines Datums im Format "YYMMDD" oder "YYYYMMDD". Format: Script-Literal oder Script-Variable Es ist auch möglich, ein anderes Datumsformat auszuwählen. Geben Sie dazu zuerst das gewünschte Datumsformat, ein Trennzeichen (: oder ;) und danach das Datum an. Die Angabe des Datumsformats ist optional.
Aktion	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

Anmerkungen

Mit der Script-Anweisung fügen Sie einem Kalender-Objekt ein Datum/Zeitraum hinzu bzw. entfernen ein Datum/Zeitraum aus einem Kalender.

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 des Datumsformats ist optional. Wird kein Datumsformat verwendet, muss das Datum in den Formaten "JJMMTT" oder "JJJJMMTT" angegeben werden.

Existiert der übergebene Kalenderbegriff nicht, so legt die Script-Anweisung einen neuen Kalenderbegriff des Typs "Statisch" an. Als Gültigkeitsbereich wird standardmäßig das aktuelle Jahr minus NOW_MINUS und plus NOW_PLUS genommen. Bei beiden Einstellungen handelt es sich um Keys, die der Administrator in der Variablen UC_CLIENT_SETTINGS konfiguriert. Sie können den Gültigkeitszeitraum jedoch nachträglich mit der Script-Funktion MODIFY_OBJECT ändern.

Die Script-Anweisung ignoriert, wenn beim Hinzufügen ein Datum/Zeitraum bereits existiert bzw. wenn beim Entfernen ein Datum/Zeitraum nicht existiert.

Sie können mit der Script-Funktion VALID_CALE prüfen, ob ein Datum in einem Kalenderbegriff enthalten ist.

Beachten Sie, dass bei der Durchführung der Script-Anweisung keine Kalenderberechnung angestoßen wird! Das Kalender-Objekt muss manuell geöffnet und gespeichert werden!

Beispiele

Im ersten Beispiel wird dem Kalender "BEREITSCHAFT" und Kalenderbegriff "BU" ein Datum hinzugefügt.

: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:

Script-Sprachmittel	Beschreibung
VALID_CALE	Prüft, ob ein Datum in einem Kalenderbegriff enthalten ist.

Script-Sprachmittel - Objekte lesen oder verändern

Datums-, Zeit- und Periodenformate

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support