MODIFY_UC_OBJECT
Fonction de script : Modifie l'attribut d'un objet activé.
Syntaxe
MODIFY_UC_OBJECT (RUN#, Attribute, Value)
Syntaxe |
Description / format |
---|---|
RunID |
Numéro d'exécution (RunID) de l'objet activé Notez que l'attribut EARLIEST_STARTTIME indique le RunID du Workflow auquel la tâche appartient (et non celui de la tâche). |
Attribute |
Attribut qui doit être modifié. |
Value |
Valeur qui doit être définie |
Code retour |
---|
"0" : la modification de l'attribut est réussie. Les codes retour de l'attribut IGNORE_SYNC sont : Les codes retour de PRIORITY sont : Les codes retour de l'attribut RELEASE sont : Les codes retour de l'attribut RESPONSE sont : Les codes retour de l'attribut GR_MAX_PAR_JOBS sont Les codes retour des attributs GOIMM, EARLIEST_STARTTIME et REMOVE_DEPENDENCY sont : Pour les attributs GAP : |
Les attributs des objets activés affichés dans le tableau ci-dessous peuvent être modifiés. Les nouvelles valeurs ne s'appliquent qu'à l'exécution courante de la tâche et ne sont pas enregistrées dans l'objet.
Type d'objet |
Attribut |
Valeur |
---|---|---|
CALL |
RESPONSE Réaction à une notification. |
"OK" : acquitter la notification (message). "YES" : répondre positivement à la notification (Requête). "ACCEPT" : accepter la notification (Alerte). |
JOBG | GR_MAX_PAR_JOBS Nombre maximum de tâches exécutées en parallèle dans un groupe. |
1 à 999 tâches exécutées en parallèle. |
JOBP | RELEASE Libération d'un Workflow bloqué. |
Numéro d'exécution (RunID) de la tâche bloquée dans le Workflow. |
|
Pour les trois attributs suivants, la tâche à modifier doit avoir le statut "Attente de pré-condition". |
|
|
GOIMM |
Nom de la tâche qui ne doit pas être utilisé plus d'une fois dans le Workflow. |
|
EARLIEST_STARTTIME |
Indiquez l'heure de début au plus tôt ou le mot clé "OFF". Dans les deux cas, la fonction de script requiert le nom de la tâche. Syntaxe du paramètre Valeur : Nom de la tâche, [format de l'heure;]heure L'heure de début est attribuée à la tâche ou remplace l'heure exsitante. La fonction de script attend l'heure au format "HHMMSS" si aucun format n'a été défini. Le mot clé "OFF" supprime une heure de début existante. |
|
REMOVE_DEPENDENCY |
La tâche ignore le statut de fin attendu (onglet Heure & dépendances) du prédécesseur indiqué. Par conséquent, le traitement de cette tâche se poursuit si tous les autres prédécesseurs sont déjà terminés. Syntaxe du paramètre Valeur : Nom de la tâche [, nom du prédécesseur] Lorsque vous n'indiquez pas de prédécesseur, tous les prédécesseurs sont ignorés et la tâche démarre immédiatement. |
CALL, JOBF, JOBP, JOBS, JSCH, SCRI |
PRIORITY |
Valeurs autorisées : 0 à 255 |
Tâches de Workflow | IGNORE_CONDITIONS | Démarre immédiatement une tâche de Workflow qui se trouve dans le statut "En attente des Pré-conditions". La valeur du paramètre n'est pas requise. Voir Onglets Précondition et Postcondition |
Tâches de Workflow | CHECK_CONDITIONS | Démarre la vérification des conditions/actions d'une tâche de Workflow qui se trouve dans le statut "En attente des Pré-conditions". La valeur du paramètre n'est pas requise. |
CALL, EVNT, JOBF, JOBG, JOBP, JOBQ,JOBS, JSCH, SCRI | IGNORE_QUEUE |
Démarre immédiatement une tâche se trouvant dans un statut d'attente en raison du manque de slots de queue. La valeur du paramètre n'est pas requise. |
Tous les objets activables |
IGNORE_SYNC |
Les paramètres de l'objet Sync sont ignorés. Ce paramètre doit être spécifié mais sa valeur est sans importance. Exemple MODIFY_UC_OBJECT( &RUNNR#, IGNORE_SYNC, "") |
Tâches périodiques |
GAP |
Modifie l'intervalle de temps entre les exécutions d'une tâche périodique. Valeur en minutes |
Tous les objets activables |
SET_EXPRESS |
Démarre immédiatement une tâche qui se trouve dans le statut "En attente de ressources" (JOBS, JOBF et JOBD). Valeurs autorisées : "ON" et "OFF" |
Vous pouvez modifier cette tâche avec cette fonction de script, si elle est déjà créée mais qu'elle se trouve encore en statut d'attente. L'option Générer à l'exécution ne doit pas avoir été définie. Utilisez l'instruction de script :PUT_ATT pour modifier une tâche lors de sa génération.
Conseil : Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre si la modification n'a pas lieu. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.
L'instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.
Exemples
Le premier exemple montre comment acquitter une notification (requête). Dans une première étape, le numéro d'exécution (RunID) doit être déterminé et enregistré dans la variable de script "&RUNNR#".
:SET &RUNNR# = ACTIVATE_UC_OBJECT("Nightshift")
!...
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#,
RESPONSE, OK)
Dans le deuxième exemple, un groupe est activé et le numéro d'exécution (RunID) est enregistré dans une variable de script. Le nombre de tâches exécutées en parallèle dans le groupe est défini à "1". Les tâches sélectionnées sont traitées une par une.
:SET &RUNNR# = ACTIVATE_UC_OBJECT("GRP7")
:SET &MODOBJ# = MODIFY_UC_OBJECT( &RUNNR#,
GR_MAX_PAR_JOBS, 1)
Les exemples suivants montrent des modifications de tâches exécutées dans un Workflow :
!The job "MM.CLOSING" should start
immediately.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, GOIMM, "MM.CLOSING")
!The job "MM.CLOSING" should not
run earlier than 3pm.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, EARLIEST_STARTTIME,
"MM.CLOSING","150000")
!The job "MM.CLOSING" should ignore
the earliest start time.
:SET &RUNNR# = GET_UC_OBJECT_NR(MM.DAY)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, EARLIEST_STARTTIME,
"MM.CLOSING",
OFF)
!The job "MM.CLOSING" should ignore
the dependency to the predecessor "MM.DAY_END".
:SET &RUNNR# = GET_UC_OBJECT_NR(MAWI.TAG)
:SET &MODOBJ# = MODIFY_UC_OBJECT(&RUNNR#, REMOVE_DEPENDENCY,
"MM.CLOSING",
"MM.DAY_END")
Voir aussi :