ROLLBACK_UC_OBJECT

Verwenden Sie die Script-Funktion ROLLBACK_UC_OBJECT, um eine aktive Aufgabe zurückzusetzen. Sie können die folgenden Aufgabentypen zurücksetzen:

• Einen ganzen Workflow, einschließlich aller Aufgaben innerhalb des Workflows
• Einen Teil eines Workflows, der bis zu einer bestimmten Aufgabe weiter vorne im Workflow zurückgesetzt wird
• Eine individuelle Aufgabe

Wichtig!

• Aktivieren Sie das Rollback, und definieren Sie Rollback-Aktionen in der Objektdefinition aller Aufgaben, die Sie zurücksetzen möchten. ROLLBACK_UC_OBJECT verarbeitet die für die Aufgabe angegebenen Rollback-Aktionen.
• Ein Zurücksetzen ist nur für Aufgaben möglich, die nicht deaktiviert wurden.

Mehr Informationen:

• Rollback von Aufgaben und Workflows
• Seite "Rollback"

Tipp: Verwenden Sie RERUN_UC_OBJECT, um Aufgaben erneut auszuführen, für die ein Rollback durchgeführt wurde.

Syntax

ROLLBACK_UC_OBJECT (RunID)

ROLLBACK_UC_OBJECT ([Workflow RunID], RunID2)

ROLLBACK_UC_OBJECT (Workflow RunID, START)

Parameter

• ROLLBACK_UC_OBJECT
  Setzt die Aufgabe zurück

• RunID
  RunID der zurückzusetzenden Aufgabe
  Format:Script-Variable, Zahl ohne Anführungszeichen oder Script-Literal

• Workflow-RunID
  RunID des Workflows, wenn Sie einen Rollback für einen Teil eines Workflows bis zur Aufgabe mit RunID2 durchführen möchten
  Hinweis: Der Parameter ist optional, wenn Sie ein teilweise Rollback für einen Workflow durchführen, und erforderlich, wenn Sie ein Rollback bis zur START-Box durchführen.
  Format: Script-Variable, Zahl ohne Anführungszeichen oder Script-Literal

• RunID2
  RunID der Aufgabe, auf die Sie innerhalb des Workflows zurücksetzen möchten
  Format: Script-Variable, Zahl ohne Anführungszeichen oder Script-Literal
  Hinweis: Geben Sie die Workflow RunID und das Schlüsselwort START ohne Anführungszeichen an, um ein Rollback auf die START-Box durchzuführen.
  

Rückgabewerte

• 11121
  Es wurde keine Aufgabe mit der angegebenen RunID gefunden.
• 12108
  Rollback ist für die Aufgabe nicht möglich: Rollback ist in der Objektdefinition nicht aktiviert.
• 12107
  Rollback ist für die Aufgabe aufgrund des aktuellen Aufgabenstatus nicht möglich.
• 20282
  Laufzeitfehler: Objekt nicht gefunden.

Beispiel

Das folgende Beispiel aktiviert einen Job und setzt die Aufgabe zurück, wenn der Job vorzeitig beendet wird:

: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

Siehe auch: