Instruction de script : Insère/supprime une date ou une période d'une règle de calendrier.
:SET_CALECalendar, Calendar Keyword, Date1, [Date2], [Action]
Syntaxe |
Description / format |
---|---|
Calendrier |
Nom de l'objet calendrier dans lequel une date ou une période doit être ajoutée ou supprimée. |
Règle de calendrier |
Nom de la règle de calendrier dans laquelle une date ou une période doit être ajoutée ou supprimée. |
date1 |
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. |
Action |
Indicateur pour l'ajout ou la suppression. Valeurs autorisées : "ON" (par Défaut), "OFF" |
L'instruction de script vous permet d'ajouter ou de supprimer une date/période à un calendrier.
Si une seule date doit être ajoutée ou supprimée, la donnée Date2 n'est pas nécessaire. Pour une période, il faut indiquer Date1 et Date2.
L'indication du format de date est facultative. Si aucun format de date n'est utilisé, la date doit être indiquée au format "AAMMJJ" ou "AAAAMMJJ".
Si la règle de calendrier indiquée n'existe pas, l'instruction de script crée une nouvelle règle de calendrier de type "Statique". La plage de validité par défaut est l'année courante moins NOW_MINUS, plus NOW_PLUS. Les deux paramètres sont des clés spécifiées par l'administrateur dans la variable AE UC_CLIENT_SETTINGS. Vous pouvez néanmoins modifier ensuite la période de validité avec la fonction de script MODIFY_OBJECT.
Lors d'ajout de dates ou d'heures, cette instruction de script ignore les périodes dates/heures spécifiées existantes. La même chose est vraie si vous supprimez une période date/heure qui n'existe pas.
La fonction de script VALID_CALE permet de vérifier si une date est valide dans le calendrier et la règle de calendrier.
Aucun calcul de calendrier n'est déclenché tant que cette instruction de script est en cours de traitement. Ouvrez et enregistrez manuellement l'objet calendrier pour le recalculer.
Dans le premier exemple, une date est ajoutée à l'objet calendrier "DISPOSITION" et à la règle "BU".
:SET_CALE "READINESS", "BU", "YY-MM-DD:00-12-24"
Le deuxième exemple supprime la date d'aujourd'hui de ce calendrier.
:SET &TODAY# = SYS_DATE()
:SET_CALE "READINESS",
"BU",
&TODAY#,,
OFF
Le troisième exemple détermine le début et la fin de la semaine courante. Après cela, la période est saisie dans le calendrier.
:SET &TODAY# = SYS_DATE()
:SET &BEGINNING# = FIRST_OF_PERIOD (&TODAY#, "WW")
:SET &END# = LAST_OF_PERIOD (&TODAY#, "WW")
:SET_CALE "READINESS",
"BU",
&BEGINNING#, &END#
Rubriques connexes :
Elément de script | Description |
---|---|
Vérifie qu'une date est contenue dans une règle de calendrier. |
Eléments de script - Lecture ou modification d'objets
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