Manuel des Scripts Automation Engine > Organisation fonctionnelle > Activation d'objets > ROLLBACK_UC_OBJECT

ROLLBACK_UC_OBJECT

Fonction script : Exécuter un rollback d'une tâche définie.

Syntaxe

ROLLBACK_UC_OBJECT(RunID)
ROLLBACK_UC_OBJECT([RunID du Workflow], RunID2)

Elément de syntaxe	Description/format
RunID	RunID de la tâche à démarrer pour le rollback. Format : Variable de script, nombre sans guillemets simples ou littéral de script
RunID2	RunID de la tâche jusqu'à laquelle le rollback doit être exécuté au sein du Workflow. Format : Variable de script, nombre sans guillemets simples ou littéral de script Si ce paramètre est mentionné, le premier est alors optionnel. Pour effectuer un rollback du Workflow jusqu'à l'objet START, le mot clé START (sans guillemets simples) doit être utilisé pour RunID2. Dans ce cas, le RunID du Workflow est absolument nécessaire !
RunID du Workflow	RunID du Workflow au sein duquel le rollback doit être exécuté jusqu'à la tâche RunID2. Format : Variable de script, nombre sans guillemets simples ou littéral de script

Elément de syntaxe

Description/format

RunID

RunID de la tâche à démarrer pour le rollback.
Format : Variable de script, nombre sans guillemets simples ou littéral de script

RunID2

RunID de la tâche jusqu'à laquelle le rollback doit être exécuté au sein du Workflow.
Format : Variable de script, nombre sans guillemets simples ou littéral de script

Si ce paramètre est mentionné, le premier est alors optionnel.

Pour effectuer un rollback du Workflow jusqu'à l'objet START, le mot clé START (sans guillemets simples) doit être utilisé pour RunID2. Dans ce cas, le RunID du Workflow est absolument nécessaire !

RunID du Workflow

RunID du Workflow au sein duquel le rollback doit être exécuté jusqu'à la tâche RunID2.
Format : Variable de script, nombre sans guillemets simples ou littéral de script

Code retour
11121 - La tâche avec le RunID indiqué est introuvable. 12108 - Rollback de la tâche impossible. Rollback inactivé dans l'objet. 12107 - Rollback de la tâche impossible en raison du statut. 20282 - Erreur de durée : Objet non trouvé.

Remarques

Le script exécute les actions de rollback de la tâche indiquée. La définition du rollback dans l'objet (onglet Rollback) indique les actions à exécuter.

Le rollback peut être démarré uniquement pour les tâches de Workflow déjà achevées et pour lesquelles la fonctionnalité a été activée.

Lorsque la tâche mentionnée est un Workflow, le rollback est effectué également pour les tâches subordonnées.

Vous pouvez également exécuter le rollback seulement jusqu'à une certaine tâche d'un Workflow. Pour cela, utilisez le RunID de cette tâche du Workflow pour le second paramètre RunID2. Pour le premier paramètre, le RunID du Workflow concerné par l'exécution de la tâche peut être indiqué. Cette indication est cependant optionnelle.
Afin d'effectuer un rollback du Workflow jusqu'à l'objet START, le mot clé START doit être utilisé pour RunID2. Dans ce cas, le RunID du Workflow doit absolument être indiqué !

Vous trouverez des informations détaillées sur l'exécution de la sauvegarde et du rollback dans le document correspondant.

Exemple

L'exemple suivant présente l'activation d'un Job et la vérification de son Code Retour. Si la tâche ne s'achève pas normalement, son rollback démarre.

: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

Rubriques connexes :

Elément de script	Description
RERUN_UC_OBJECT	Poursuite d'un Workflow spécifique.

Elément de script - Séquences de données

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle