Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > DEACTIVATE_UC_OBJECT

DEACTIVATE_UC_OBJECT

Scriptfunktion: Deaktiviert eine abgeschlossene Aufgabe.

Syntax

DEACTIVATE_UC_OBJECT(RunID [, FORCED])

Syntax	Beschreibung/Format
RunID	RunID jener Aufgabe, die deaktiviert werden soll. Format: Script-Variable, Script-Literal, Zahl ohne Hochkommata
FORCED	Deaktiviert unabhängig vom Status der Aufgaben auf oberster Ebene. Das System prüft nicht, ob Aufgaben innerhalb eines Workflows laufen. Weiters werden die Optionen zur automatischen Deaktivierung aller untergeordneten Aufgaben ignoriert und diese trotzdem deaktiviert. FORCED kann nur in Zusammenhang mit Workflows verwendet werden. Beachten Sie: "Deaktivieren (erzwungen)" prüft nicht, ob Sub-Workflows noch aktive Aufgaben enthalten. Format: AE-Name, Script-Literal oder Variable

Syntax

Beschreibung/Format

RunID

RunID jener Aufgabe, die deaktiviert werden soll.
Format: Script-Variable, Script-Literal, Zahl ohne Hochkommata

FORCED

Deaktiviert unabhängig vom Status der Aufgaben auf oberster Ebene.

Das System prüft nicht, ob Aufgaben innerhalb eines Workflows laufen. Weiters werden die Optionen zur automatischen Deaktivierung aller untergeordneten Aufgaben ignoriert und diese trotzdem deaktiviert. FORCED kann nur in Zusammenhang mit Workflows verwendet werden.

Beachten Sie: "Deaktivieren (erzwungen)" prüft nicht, ob Sub-Workflows noch aktive Aufgaben enthalten.

Format: AE-Name, Script-Literal oder Variable

Rückgabewerte
12204 - Aufgabe mit RunID kann nicht deaktiviert werden. Objekte eines Workflows können nicht deaktiviert werden. 12205 - Aufgabe mit RunID kann nicht deaktiviert werden, da einige ihrer Teilaufgaben noch aktiv sind. 12206 - Zustandsdefinition nicht numerisch. 12207 - Zustandsdefinition ist nicht in aufsteigender Reihenfolge (von-bis). 12208 - Syntax der Zustandsdefinition ist falsch. 12209 - Statusdefinition wird nicht gefunden: Objekt wurde nicht automatisch deaktiviert. 12210 - Zustandsdefinition nicht numerisch. Objekt wurde nicht automatisch deaktiviert.

Rückgabewerte

12204 - Aufgabe mit RunID kann nicht deaktiviert werden. Objekte eines Workflows können nicht deaktiviert werden.
12205 - Aufgabe mit RunID kann nicht deaktiviert werden, da einige ihrer Teilaufgaben noch aktiv sind.
12206 - Zustandsdefinition nicht numerisch.
12207 - Zustandsdefinition ist nicht in aufsteigender Reihenfolge (von-bis).
12208 - Syntax der Zustandsdefinition ist falsch.
12209 - Statusdefinition wird nicht gefunden: Objekt wurde nicht automatisch deaktiviert.
12210 - Zustandsdefinition nicht numerisch. Objekt wurde nicht automatisch deaktiviert.

Kommentare

Deaktivieren ist nur für bereits beendete Aufgaben (erfolgreich oder abgebrochen) möglich und entfernt diese aus den Aktivitäten (Aktivitätenfenster). Dazu ist die RunID der Aufgabe anzugeben.

Für die Deaktivierung gelten folgende Voraussetzungen:

Wird ein Workflow angegeben, darf dieser keine untergeordneten Aufgaben enthalten, die noch aktiv sind. Dies gilt auch für die Aufgaben aller Sub-Workflows.
Aufgaben, die von einem Workflow gestartet wurden, können nur durch Deaktivierung des obersten Workflows (für welchen wiederum der erste Punkt gilt) deaktiviert werden.

In ausführbaren Objekten können auch Einstellungen zur automatischen Deaktivierung gesetzt werden. Diese werden ebenfalls geprüft.

Beispiele

In folgendem Beispiel wird ein Objekt aktiviert und auf dessen Ende gewartet. Im Fehlerfall wird anschließend eine Meldung an den betreffenden Benutzer gesendet. Endet das Objekt ohne Fehler, so wird es deaktiviert.

: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:

Script-Sprachmittel	Beschreibung
ACTIVATE_UC_OBJECT	Aktiviert ein Objekt.
RESTART_UC_OBJECT	Wiederholt die Durchführung einer Aufgabe.

Script-Sprachmittel - Objekte aktivieren

Beispielsammlung:
Datenbankwartung mit Optionen
Benachrichtigung mit variablem Meldungstext
Ermittlung der Fehlermeldung und -nummer
Reaktion auf externe Ereignisse

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support