Utilisez la fonction de script DEACTIVATE_UC_OBJECT pour désactiver une tâche terminée. Cette fonction vous permet de désactiver des tâches déjà terminées :
- Tâches terminées avec succès
- Taches interrompues
Remarques :
- Vous ne pouvez désactiver les workflows contenant des tâches actives, ni désactiver des workflows enfants contenant des tâches actives.
- Pour désactiver des tâches lancées par un workflow, vos devez désactiver le workflow parent en vous assurant qu'aucune de ses tâches enfants n'est active.
- Les tâches désactivées disparaissent de la perspective Surveillance des processus.
Conseil : Vous pouvez définir les paramètres dans des objets exécutables pour désactiver la tâche automatiquement. Pour plus d'informations, voir la Section Désactivation automatique.
Syntaxe
DEACTIVATE_UC_OBJECT (RunID [,FORCED])
Paramètres
- DEACTIVATE_UC_OBJECT
Désactive une tâche terminée - RunID
RunID de la tâche à désactiver
Format : littéral de script, variable de script ou nombre sans guillemets - FORCED
(Optionnel, workflows uniquement) Désactive la tâche du workflow et toutes ses tâches enfants, indépendamment de leur statut et des paramètres de désactivation automatique dans les tâches enfants
Format: Nom AE, littéral de script ou variable de script
Remarques :- Le système ne vérifie pas si la tâche désactivée est exécutée dans un workflow.
- Le système ne vérifie pas si les tâches enfants des workflows sont actives.
Codes retour
La fonction de script renvoie les codes retour suivants :
- 12204
Désactivation de la tâche impossible car les objets d'un workflow ne peuvent pas être désactivés - 12205
Désactivation de la tâche impossible car la tâche comporte des tâches enfants actives - 12206
La définition du statut n'est pas numérique - 12207
La définition du statut n'est pas ascendante (de - à) - 12208
La définition du statut est incorrecte d'un point de vue syntaxique - 12209
Définition du statut introuvable : l'objet n'a pas été désactivé automatiquement - 12210
La définition du statut n'est pas numérique : l'objet n'a pas été désactivé automatiquement
Exemple
L'exemple suivant illustre l'activation d'un objet et l'attente de fin de tâche. En cas d'erreur, le système envoie un courriel à un utilisateur. Si la tâche se termine sans erreur, le script désactive la tâche.
:SET &ACTOBJ# = ACTIVATE_UC_OBJECT(&OBJ#,WAIT)
:IF &ACTOBJ# = "0"
: SET &ERRNR# = SYS_LAST_ERR_NR()
: SET &ERRINS# = SYS_LAST_ERR_INS()
: SET &MESSAGE# = GET_MSG_TXT(&ERRNR#,&ERRINS#)
: SET &RET# = SEND_MAIL("John.Smith@automic.com",,&MESSAGE#, "Please check. Thanks!")
:ELSE
: SET &DEACTJOB# = DEACTIVATE_UC_OBJECT(&ACTJOB#)
:ENDIF
Voir aussi :