DEACTIVATE_UC_OBJECT

Verwenden Sie die Script-Funktion DEACTIVATE_UC_OBJECT, um eine abgeschlossene Aufgabe zu deaktivieren. Mit der Funktion können Sie bereits beendete Aufgaben deaktivieren:

• Aufgaben, die erfolgreich abgeschlossen wurden
• Aufgaben, die abgebrochen wurden

Hinweise:

• Sie können weder Workflows, noch Child-Workflows mit aktiven Aufgaben deaktivieren.
• Um Aufgaben zu deaktivieren, die durch einen Workflow gestartet wurden, müssen Sie den obersten Workflow deaktivieren und sicherstellen, dass keine der Child-Aufgaben aktiv ist.
• Wenn Sie Aufgaben deaktivieren, werden sie aus der Perspektive Process Monitoring entfernt.

Tipp: Sie können in ausführbaren Objekten Einstellungen vornehmen, um die Aufgabe automatisch zu deaktivieren. Weitere Informationen finden Sie imAbschnitt Automatische Deaktivierung.

Syntax

DEACTIVATE_UC_OBJECT (RunID [,FORCED])

Parameter

• DEACTIVATE_UC_OBJECT
  Deaktiviert eine abgeschlossene Aufgabe

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

• FORCED
  (Optional, nur Workflows) Deaktiviert die Workflow-Aufgabe und alle untergeordneten Aufgaben, unabhängig von ihrem Status und allen automatischen Deaktivierungseinstellungen in den Child-Aufgaben
  Format: AE-Name, Script-Literal oder Script-Variable
  Hinweise:

  • Das System prüft nicht, ob die Aufgabe, die Sie deaktivieren, in einem Workflow aktiv ist.
  • Das System prüft nicht, ob Child-Aufgaben im Workflow aktiv sind.

Rückgabewerte

Die Script-Funktion gibt die folgenden Werte zurück:

• 12204
  Aufgabe kann nicht deaktiviert werden, da Sie Objekte eines Workflows nicht deaktivieren können
• 12205
  Aufgabe kann nicht deaktiviert werden, da die Aufgabe aktive Child-Aufgaben hat
• 12206
  Die Statusdefinition ist nicht numerisch
• 12207
  Die Statusdefinition nicht aufsteigend (von-bis)
• 12208
  Die Statusdefinition ist syntaktisch falsch
• 12209
  Die Statusdefinition konnte nicht gefunden werden, sodass das Objekt nicht automatisch deaktiviert wurde
• 12210
  Die Statusdefinition ist nicht numerisch, deshalb wurde das Objekt nicht automatisch deaktiviert

Beispiel

Das folgende Beispiel aktiviert ein Objekt und wartet auf die Fertigstellung der Aufgabe. Wenn ein Fehler auftritt, sendet das System eine E-Mail an einen Benutzer. Wenn die Aufgabe ohne Fehler abgeschlossen wird, deaktiviert das Script die Aufgabe.

: 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# , "Bitte prüfen. Danke!" )
:ELSE
: SET &DEACTJOB# = DEACTIVATE_UC_OBJECT(&ACTJOB#)
: ENDIF

Siehe auch: