CALE_LOOK_AHEAD

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

Syntaxe

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

Syntaxe	Description / format
Date
JOBP|JSCH	Nom d'un Workflow ou d'un Schedule. Format : littéral de script ou variable de script
Task Number	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 (voir Surveiller les schedules).
Calendar	Nom d'un objet calendrier Format : littéral de script ou variable de script
Calendar Event	Événement de calendrier de l'objet Calendrier Format : littéral de script ou variable de script

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

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, événéments de calendriers compris. L'administrateur AE peut définir pour chaque client le nombre maximal de jours pris en compte lors de la détermination de la prochaine date valide dans la variable UC _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. Le format de date est optionnel. 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 et Événement de calendrier doivent toujours être utilisés ensemble (voir exemple ci-dessous).

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

Voir aussi :