Verwenden Sie die DEACTIVATE_UC_OBJECT-Script-Funktion, 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 im Abschnitt Automatische Deaktivierung.
Syntax
DEACTIVATE_UC_OBJECT (RunID [,FORCED])
Parameter
- DEACTIVATE_UC_OBJECT
Deaktiviert eine abgeschlossene Aufgabe - RunID
RunID der Aufgabe um zu deaktivieren
Format: Script-Literal, Script-Variable oder Zahl ohne Hochkommata - FORCED
(Optional, nur Workflows) Deaktiviert die Workflow-Aufgabe und alle Child-Aufgaben, unabhängig von ihrem Zustand und den 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 Zustandsdefinition ist nicht numerisch - 12207
Die Zustandsdefinition nicht aufsteigend (von-bis) - 12208
Die Zustandsdefinition ist syntaktisch falsch - 12209
Die Zustandsdefinition konnte nicht gefunden werden, so dass das Objekt nicht automatisch deaktiviert wurde - 12210
Die Zustandsdefinition nicht numerisch, daher 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#, "Please check. Thanks!")
:ELSE
: SET &DEACTJOB# = DEACTIVATE_UC_OBJECT(&ACTJOB#)
:ENDIF
Siehe auch: