La fonction de script ROLLBACK_UC_OBJECT vous permet de restaurer une tâche active. Vous pouvez restaurer les types de tâches suivants :
- Un workflow entier, avec toutes ses tâches
- Une partie de workflow, en restaurant jusqu'à une certaine tâche antérieure dans le workflow
- Une tâche individuelle
Important !
- Vous devez activer la restauration et définir les actions de restauration dans la définition d'objet de toutes les tâches à restaurer. ROLLBACK_UC_OBJECT traite les actions de restauration spécifiées pour la tâche.
- La restauration n'est possible que pour les tâches non désactivées.
Pour plus d'informations :
Conseil : Utilisez RERUN_UC_OBJECT pour ré-exécuter des tâches restaurées.
Syntaxe
ROLLBACK_UC_OBJECT (RunID)
ROLLBACK_UC_OBJECT ([Workflow RunID], RunID2)
ROLLBACK_UC_OBJECT (Workflow RunID, START)
Paramètres
-
ROLLBACK_UC_OBJECT
Restaure la tâche -
RunID
RunID de la tâche à restaurer
Format : fonction de script, nombre sans guillemet ou littéral de script -
Workflow RunID
RunID du workflow, lorsque vous souhaitez restaurer une partie du workflow jusqu'à la tâche RunID2
Remarque : Ce paramètre est optionnel lorsque vous restaurez une partie de workflow, et obligatoire lorsque vous restaurez tout le chemin à la boîte START.
Format : variable de script, nombre sans guillemets simples ou littéral de script -
RunID2
RunID de la tâche à restaurer dans le workflow
Format : variable de script, nombre sans guillemets simples ou littéral de script
Remarque : Spécifiez le RunID du workflow et le mot-clé START sans guillemets pour restaurer jusqu'à la boîte START.
Codes retour
- 11121
Tâche introuvable avec le RunID spécifié. - 12108
Restauration de la tâche impossible : la restauration n'est pas activée dans la définition d'objet. - 12107
Restauration de tâche impossible en raison du statut actuel de la tâche. - 20282
Erreur d'exécution : Objet non trouvé.
Exemple
L'exemple suivant illustre l'activation d'un job et la restauration de la tâche lorsqu'il se termine anormalement :
:SET &ACT# = ACTIVATE_UC_OBJECT(JOBS.TEST,WAIT)
:SET &RET# = GET_UC_OBJECT_STATUS(, &ACT#, "RETCODE")
:IF &RET# > 0
: SET &RB# = ROLLBACK_UC_OBJECT(&ACT#)
:ENDIF
Voir aussi :