Manuel des Scripts Automation Engine > Organisation fonctionnelle > Date et heure > CALE_LOOK_AHEAD

CALE_LOOK_AHEAD

Fonction de script : Retourne la date suivante en fonction des conditions de calendrier.

Syntaxe

CALE_LOOK_AHEAD([Date], JOBP\JSCH, Task Number)
CALE_LOOK_AHEAD
([Date], Condition, Calendar, Calendar Keyword, [[Calendar], [Calendar Keyword]]...)

Syntaxe

Description / format

Date

Saisie d'une date au format "AAMMJJ" ou "AAAAMMJJ".

Format : littéral de script ou variable de script

Il est aussi possible d’indiquer la date dans un autre format de date. Pour cela, saisissez le format de date souhaité suivi d’un séparateur (: ou ;) puis la date. Le format de la date est facultatif.

JOBP\JSCH

Nom d'un Workflow ou d'un Schedule.
Format : littéral de script ou variable de script

Numéro de tâche

Numéro de la tâche dans le Workflow ou le Schedule.
Format : littéral de script ou variable de script

Condition

Condition qui doit être remplie pour la définition de la date.
Format : littéral de script ou variable de script

Valeurs autorisées : "ONE", "ALL", "NO"

"ONE" : une des conditions de calendrier doit être remplie.
"ALL" : toutes les conditions de calendrier doivent être remplies.
"NO" : aucune condition de calendrier ne doit être remplie.

Si aucune des conditions de calendrier n'est remplie pour une tâche, un espace est renvoyé. Dans ce cas, CALE_LOOK_AHEAD_MAX s'affiche dans le moniteur de Schedule.

Calendrier

Nom d'un calendrier
Format : littéral de script ou variable de script

Règle de calendrier

Règle de calendrier dans ce calendrier
Format : littéral de script ou variable de script


Codes retour

Date au format indiqué
" " : Aucune condition de calendrier n'est remplie

Commentaires

Vous pouvez utiliser la fonction de script de deux façons différentes :

D'une part, il est possible de déterminer la prochaine date d'exécution d'un objet, conformément aux conditions du calendrier. L'objet peut être identifié par son numéro de tâche, qui est affiché dans la vue graphique du Workflow dans l'ordre dans lequel les objets ont été ajoutés au Workflow. Pour un Schedule, la numérotation des objets correspond à l'ordre dans la liste de l'onglet Schedule.

D'autre part, la fonction de script prend en charge le calcul de la prochaine date lorsque qu'une, toutes ou aucune des conditions de calendrier sont réunies. Il est possible de spécifier jusqu'à cinq calendriers, règles de calendriers comprises. L'administrateur AE peut définir pour chaque client le nombre maximal de jours pris en compte lors de la détermination de la prichaine date valide dans la variable UC _CLIENT_SETTINGS avec la clé "CALE_LOOK_AHEAD_MAX".

Il est possible d'indiquer une date à partir de laquelle les conditions de calendriers doivent être vérifiées. L'indication d'un format de date est facultative. Les formats de date par défaut à utiliser sont "AAMMJJ" ou "AAAAMMJJ". Deux points ou un point-virgule sont autorisés comme séparateur entre le format de date et la date. Si aucune date n'est spécifiée, la date du jour sera utilisée pour le calcul.

Cette fonction de script fournit la date soit au format par défaut soit au format qui a été défini dans le premier paramètre.

Notez que les paramètres Calendrier etRègle de calendrier doivent toujours être utilisés ensemble (voir exemple).

Exemples

L'exemple suivant montre comment identifier la prochaine date à laquelle l'objet avec le numéro de tâche "3" s'exécutera dans le Workflow "MM.DAY".

:SET  &DATE# = CALE_LOOK_AHEAD('YYYYMMDD:20041010','MM.DAY','3')

Le deuxième exemple définit la prochaine date à laquelle toutes les conditions de calendriers sont réunies.

:SET  &DATE# = CALE_LOOK_AHEAD(,'ALL','FIRM.CALENDAR','WORKDAYS','FIRM.CALENDAR','READINESS01')

 

Rubriques connexes :

Eléments de script - Date et heure

Formats de date, d'heure et de période

Généralités sur les scripts
Eléments de script - Liste alphabétique

Eléments de script - Répartition fonctionnelle