CALE_LOOK_AHEAD

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

Syntax

CALE_LOOK_AHEAD ([[Datumsformat]:Datum], JOBP|JSCH, Aufgabennummer)
CALE_LOOK_AHEAD ([[Datumsformat]:Datum], Bedingung, Kalender, Kalenderereignis [ [,Kalender][,Kalenderereignis] ]...)

Syntax	Beschreibung/Format
Datum
JOBP|JSCH	Name eines Workflows oder einer Schedule Format: Script-Literal oder Script-Variable
Aufgabennummer	Aufgabennummer im Workflow oder in der Schedule Format: Script-Literal oder Script-Variable
Bedingung	Bedingung, die für die Definition des Datums gelten muss Format: Script-Literal oder Script-Variable Zulässige 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 Hinweis: 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.
Kalender	Name eines Kalender-Objekts Format: Script-Literal oder Script-Variable
Kalenderereignis	Kalenderereignis in diesem Kalender-Objekt Format: Script-Literal oder Script-Variable

Rückgabewerte
Datum im angegebenen Format " " - Es gilt keine Kalenderbedingung

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 Objekts 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 Kalenderereignissen 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 Schlüssel "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.

Hinweis: Das Datum, das die Script-Funktion ermittelt, wird entweder im Standardformat oder in dem Format, das Sie im ersten Parameter definieren, geliefert.

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