Script-Funktion: Ermittelt das nächste Datum aufgrund von Kalenderbedingungen.
CALE_LOOK_AHEAD([Date], JOBP\JSCH, Task Number)
CALE_LOOK_AHEAD([Date], Condition, Calendar, Calendar Keyword, [[Calendar], [Calendar Keyword]]...)
Syntax |
Beschreibung/Format |
---|---|
Datum |
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. |
JOBP\JSCH |
Name eines Workflows oder eines Schedules. |
Aufgabennummer |
Nummer der Aufgabe innerhalb des Workflows bzw. des Schedules. |
Bedingung |
Bedingung, die bei der Datumsbestimmung zutreffen muss. Erlaubte Werte: "ONE", "ALL", "NO" "ONE" - Eine der angegebenen Kalenderbedingungen muss zutreffen. Trifft für eine Aufgabe keine Kalenderbedingung zu, wird ein Leerzeichen zurückgeliefert. Im Schedule-Monitor würde in diesem Fall CALE_LOOK_AHEAD_MAX angezeigt. |
Kalender |
Name eines Kalenders |
Kalenderbegriff |
Kalenderbegriff innerhalb dieses Kalenders |
Rückgabewerte |
---|
Datum im angegebenen Format. |
Die Script-Funktion kann auf zwei unterschiedliche Arten verwendet werden.
Unter Angabe eines Workflows oder Schedules ist es zum einen möglich, das nächste Datum eines zugehörigen Objektes zu ermitteln, an welchem es aufgrund der definierten Kalenderbedingungen laufen wird. Das Objekt wird über die Aufgabennummer bestimmt. Diese wird beim Workflow in der graphischen Ansicht angezeigt und richtet sich nach der Reihenfolge, in der die Objekte dem Workflow hinzugefügt wurden. Beim Schedule entspricht die Nummerierung der Objekte der Reihenfolge in der Liste der Registerkarte Schedule.
Die Script-Funktion unterstützt zum anderen die Berechnung des nächsten Datums, an dem eine, alle oder keine der Kalenderbedingungen zutreffen. Es können bis zu 5 Kalender mit ihren Kalenderbegriffen angegeben werden. Die maximale Anzahl von Tagen, die bei der Ermittlung des nächsten gültigen Datums berücksichtigt wird, kann der Administrator in der Variablen UC_CLIENT_SETTINGS mit dem Key "CALE_LOOK_AHEAD_MAX" für jeden Mandanten festlegen.
Es kannein Datum angegeben werden, ab einschließlich dem die Kalenderbedingungen geprüft werden. Die Angabe eines Datumsformats ist optional. Wird kein bestimmtes Datumsformat verwendet, muss das Datum in den Formaten "JJMMTT" oder "JJJJMMTT" angegeben werden. Als Trennzeichen zwischen Datumsformat und Datum sind Doppelpunkt oder Semikolon erlaubt. Geben Sie kein Datum an, so wird für die Berechnung das jeweils aktuelle Datum verwendet.
Das Datum, das die Script-Funktion ermittelt, wird entweder im Standardformat oder in dem Format, das Sie im ersten Parameter definieren, geliefert.
Beachten Sie, dass die Parameter Kalender und Kalenderbegriff immer gemeinsam angegeben werden müssen (siehe Beispiel unten)!
In dem folgenden Beispiel soll das nächste Datum ermittelt werden, an dem das Objekt mit der Aufgabennummer "3" im Workflow MAWI.TAG läuft.
:SET &DATE# = CALE_LOOK_AHEAD('YYYYMMDD:20041010','MM.DAY','3')
Das zweite Beispiel bestimmt das nächste Datum, an dem alle übergebenen Kalenderbedingungen zutreffen.
:SET &DATE# = CALE_LOOK_AHEAD(,'ALL','FIRM.CALENDAR','WORKDAYS','FIRM.CALENDAR','READINESS01')
Siehe auch:
Script-Sprachmittel - Datum und Zeit
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 |
Copyright © 2016 Automic Software GmbH |