:SET_CALE

Verwenden Sie die Script-Anweisung :SET_CALE, um ein Datum oder einen Zeitraum zu einem statischen Kalenderereignis in einem Kalenderobjekt hinzuzufügen oder daraus zu entfernen.

Hinweise

• Kalenderberechnungen werden nicht automatisch ausgelöst, während diese Script-Anweisung verarbeitet wird. Sie müssen das Kalenderobjekt manuell öffnen und speichern, um den Kalender neu zu berechnen.
• Beim Hinzufügen von Daten oder Zeiten ignoriert diese Script-Anweisung vorhandene Datums-/Zeitangaben. Das Gleiche gilt, wenn Sie ein Datum oder einen Zeitraum entfernen, das/der nicht existiert.

Tipp: Schreiben Sie ein Script, um zu überprüfen, ob ein Datum in einem bestimmten Kalenderobjekt und ein Kalenderereignis gültig ist. Weitere Informationen finden Sie unter VALID_CALE.

Syntax

:SET_CALEKalender, Kalenderereignis, [Datumsformat:]Datum1[,[Datumsformat:]Datum2[,Aktion]]

Parameter

• :SET_CALE
  Fügt ein Datum oder einen Zeitraum zu oder aus einem Kalenderereignis hinzu oder entfernt es

• Kalender
  Name des Kalender-Objekts, zu dem ein Datum oder ein Zeitraum hinzugefügt bzw. daraus entfernt werden soll
  Format: AE Name, Script-Literal oder Script-Variable

• Kalenderereignis
  Name des Kalenderereignisses, zu dem ein Datum oder eine Uhrzeit hinzugefügt oder bzw. daraus entfernt werden soll.
  Wenn das Kalenderereignis nicht vorhanden ist, erstellt diese Script-Anweisung ein neues, nicht wiederkehrendes statisches Kalenderereignis. Standardmäßig wird das aktuelle Jahr minus NOW_MINUS und plus NOW_PLUS verwendet. Beide Angaben sind Schlüssel, die der Administrator in der AE-Variablen UC_CLIENT_SETTINGS angegeben hat. Sie können den Gültigkeitsbereich später über ein Script ändern. Weitere Informationen finden Sie unter MODIFY_OBJECT
  Format: AE Name, Script-Literal oder Script-Variable

• Datum1 und Datum2
  Datum im Format YYMMDD oder YYYYMMDD. Datum2 ist optional, wenn Sie nur ein Datum hinzufügen oder entfernen möchten. Für einen Zeitraum müssen Sie sowohl Datum1 als auch Datum2 angeben.
  (Optional) Sie können ein anderes Datumsformat angeben, indem Sie Ihr bevorzugtes Datumsformat eingeben, ein Trennzeichen hinzufügen (: oder ;) und das Datum eingeben.
  Format: Script-Literal oder Script-Variable

• Aktion
  (Optional) Aktion, die verwendet wird, um ein Datum oder einen Zeitraum hinzuzufügen oder zu entfernen
  Format: AE Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • ON (Standard)
    Fügt ein Datum oder einen Zeitraum hinzu
  • OFF
    Entfernt ein Datum oder einen Zeitraum

Beispiele

Das erste Beispiel fügt ein Datum zu einem Kalender mit dem Namen ON-CALL und ein statisches Kalenderereignis mit dem Namen SMITH hinzu.

:SET_CALE "ON-CALL", "SMITH", "YY-MM-DD:20-12-24"

Das zweite Beispiel entfernt den aktuellen Tag aus dem statischen Kalenderereignis BROWN.

:SET &TODAY# = SYS_DATE()
:SET_CALE "ON-CALL", "BROWN", &TODAY#,, OFF

Das dritte Beispiel bestimmt den Anfang und das Ende der aktuellen Woche und fügt diesen Zeitraum dann dem Kalenderereignis SMITH hinzu.

:SET &TODAY# = SYS_DATE()
:SET &BEGINNING# = FIRST_OF_PERIOD (&TODAY#, "WW")
:SET &END# = LAST_OF_PERIOD (&TODAY#, "WW")
:SET_CALE "ON-CALL", "SMITH", &BEGINNING#, &END#

Siehe auch: