Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datum und Zeit > CALE_LOOK_AHEAD

CALE_LOOK_AHEAD

Script-Funktion: Ermittelt das nächste Datum aufgrund von Kalenderbedingungen.

Syntax

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.
Format: Script-Literal oder Script-Variable

Aufgabennummer

Nummer der Aufgabe innerhalb des Workflows bzw. des Schedules.
Format: Script-Literal oder Script-Variable

Bedingung

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 würde in diesem Fall CALE_LOOK_AHEAD_MAX angezeigt.

Kalender

Name eines Kalenders
Format: Script-Literal oder Script-Variable

Kalenderbegriff

Kalenderbegriff innerhalb dieses Kalenders
Format: Script-Literal oder Script-Variable


Rückgabewerte

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

Anmerkungen

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)!

Beispiele

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