:SET_CALE

Instruction de script : Insère ou supprime une date ou une période dans un événement de calendrier.

Syntaxe

:SET_CALE Calendar, Calendar Event, [Date Format:]Date1[,[Date Format:]Date2[,Action]]

Syntaxe	Description / format
Calendar	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
Calendar Event	Nom de l'événement de 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
Date1 et date2	Date au format AAMMJJ ou AAAAMMJJ Format : littéral de script ou variable de script (Optionnel) Vous pouvez spécifier un autre format de date : saisissez le format de date souhaité, un séparateur (: ou ;) et la date.
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

Cette instruction de script vous permet d'ajouter ou de supprimer une date ou une période d'un objet 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.

Le format de date est optionnel. Si aucun format de date n'est utilisé, la date doit être indiquée au format "AAMMJJ" ou "AAAAMMJJ".

Si l'événement de calendrier n'existe pas, l'instruction de script crée un nouvel événement de calendrier non périodique. 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 pour un objet Calendrier et un événement de calendrier.

Aucun calcul de calendrier ne se déclenche 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 au calendrier "Readiness" et à l'événement de calendrier "BU".

:SET_CALE "READINESS", "BU", "YY-MM-DD:00-12-24"

Dans le deuxième exemple la date du jour est supprimée de ce calendrier.

:SET &TODAY# = SYS_DATE()
:SET_CALE "READINESS", "BU", &TODAY#,, OFF

Dans le troisième exemple sont déterminés le début et la fin de la semaine en cours. 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#

Voir aussi :