CALE_LOOK_AHEAD

Script-Funktion: Gibt das nächste Datum basierend auf Kalenderbedingungen zurück.

Syntax

CALE_LOOK_AHEAD ([[Date Format]:Date], JOBP|JSCH, Task Number)
CALE_LOOK_AHEAD ([[Date Format]:Date], Condition, Calendar, Calendar Event [ [,Calendar][,Calendar Event] ]...)

Syntax	Beschreibung/Format
Date
JOBP|JSCH	Name eines Workflows oder eines Schedules. Format: Script-Literal oder Script-Variable
Task Number	Aufgabennummer im Workflow oder im Schedule Format: Script-Literal oder Script-Variable
Condition	Bedingung, die bei der Datumsbestimmung zutreffen muss. Format: Script-Literal oder Script-Variable Erlaubte Werte: "ONE", "ALL", "NO" "ONE" - Eine der angegebenen Kalenderbedingungen muss zutreffen. "ALL" - Alle angegebenen Kalenderbedingungen müssen zutreffen. "NO" - Keine der angegebenen Kalenderbedingungen darf zutreffen. Trifft für eine Aufgabe keine Kalenderbedingung zu, wird ein Leerzeichen zurückgeliefert. Im Schedule-Monitor (siehe Schedules überwachen) würde in diesem Fall CALE_LOOK_AHEAD_MAX angezeigt.
Calendar	Name eines Kalender-Objektes. Format: Script-Literal oder Script-Variable
Calendar Event	Kalenderereignis in diesem Kalenderobjekt Format: Script-Literal oder Script-Variable

Rückgabewerte
Datum im angegebenen Format " " - Es trifft keine Kalenderbedingung zu.

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 kann ein Datum angegeben werden, ab einschließlich dem die Kalenderbedingungen geprüft werden. Die Angabe eines Datumsformats ist dabei optional. Wird kein 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 Kalenderereignis immer gemeinsam angegeben werden müssen (siehe Beispiel unten)!

Beispiele

In dem folgenden Beispiel soll das nächste Datum ermittelt werden, an dem das Objekt mit der Aufgabennummer "3" im Workflow MM.DAY 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: