Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > :SET_CALE

:SET_CALE

Instruction de script : Insère/supprime une date ou une période d'une règle de calendrier.

Syntaxe

: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.
Format : Nom AE, littéral de script ou variable de script

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.
Format : Nom AE, littéral de script ou variable de script

date1
et

date2

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.
Format : Nom AE, littéral de script ou variable de script

Valeurs autorisées : "ON" (par Défaut), "OFF"
"ON" : ajouter une date/période
"OFF" : retirer une date/période

Remarques

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.

Exemples

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

VALID_CALE

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