Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > MODIFY_TASK

MODIFY_TASK

Script-Funktion: Ändert laufende Workflows.

Allgemeine Informationen

Die Änderung eines laufenden Workflows erfolgt in mehreren Schritten. Alle werden mit Hilfe von MODIFY_TASK durchgeführt:

Stoppen Sie den Workflow mit dem Status "STOP_MODIFY".
Nehmen Sie eine oder mehrere Änderungen vor.
Aktivieren Sie die Änderungen mit dem Status "COMMIT".
Starten Sie den Workflow mit dem Status "GO".

Die Parameter der Script-Funktion sind in einer bestimmten Reihenfolge anzuordnen. Wenn Sie daher Parameter auslassen, sind trotzdem deren Kommata zu setzen (siehe nachfolgende Beispiele).

Verwenden Sie "START" bzw. "END", um die Eigenschaften des START- bzw. Ende-Kästchens zu ändern.

Beachten Sie, dass die Registerkarte Ergebnis (Workflow-Eigenschaften) ab Version 9.00A nicht mehr existiert und daher mit dem Sprachmittel nicht mehr geändert werden kann!

Mit dem Sprachmittel ist es nicht möglich, die Ausführung des eigenen Workflows zu stoppen bzw. fortzusetzen und diesen in weiterer Folge zu ändern.

Rückgabewerte
Allgemein: "0" - Die Änderung wurde erfolgreich vorgenommen. "9" - Der Benutzer verfügt nicht über die Berechtigungen, die angegebene Aufgabe zur Laufzeit zu modifizieren. "20591" - Der Workflow mit der RunID existiert nicht oder ist nicht mehr aktiv. "20738" - Die Aufgabe befindet sich in einem Status in dem die Änderung nicht vorgenommen werden kann. "20739" - Die Aufgabe kann nicht geändert werden, da sie zur Zeit von einem anderen Benutzer modifiziert wird. "20740" - Angabe eines ungültigen Objekttyps. "20741" - Es existiert keine Aufgabe mit dem angegebenen Namen und/oder der angegebenen laufenden Nummer. "20742" - Der angegebene Aufgabenname passt nicht zur angegebenen laufenden Nummer. "20743" - Die Aufgabe kann nicht geändert werden, da ihr Workflow nicht zum Editieren gestoppt wurde. "20744" - Die Aufgabe kann nicht geändert werden, da sie sich in keinem modifizierbaren Status befindet. "20745" - Die Änderung der Aufgabe ist nicht zulässig, da der Wert nicht erlaubt ist. "20746" - Hinzufügen einer Abhängigkeit ist nicht möglich, da diese bereits existiert. "20747" - Die Änderung einer Abhängigkeit ist nicht möglich, da sie sich in keinem modifizierbaren Status befindet. "20748" - Das Hinzufügen einer Aufgabe ist nicht möglich, da sich an der Stelle bereits eine Aufgabe befindet. "20749" - Der Objekttyp der angegebenen Aufgabe ist nicht zulässig. "20750" - Die Funktion kann für die Aufgabe mit der RunID auf Grund eines vorigen Fehlers nicht durchgeführt werden. "20752" - Das Ersetzen einer externen Aufgabe ist nur durch eine externe Aufgabe möglich. "20753" - Die Ersetzung von <START> und <END> ist nicht möglich. "20754" - <START> darf keinen Vorgänger haben. "20755" - <END> darf keinen Nachfolger haben. "20756" - Externe Aufgaben dürfen keinen Vorgänger haben. "20757" - Bei der Änderung einer externen Abhängigkeit, wurde eine ungültige Aufgabe angegeben. "20758" - Die Angabe von externen Abhängigkeiten ist nicht möglich. ADD_TASK: Laufende Nummer der hinzugefügten Aufgabe im Workflow "0" - Die Aufgabe konnte nicht hinzugefügt werden. REPLACE_TASK: Laufende Nummer der neuen Aufgabe im Workflow "0" - Die Aufgabe konnte nicht ersetzt werden.

Rückgabewerte

Allgemein:

"0" - Die Änderung wurde erfolgreich vorgenommen.
"9" - Der Benutzer verfügt nicht über die Berechtigungen, die angegebene Aufgabe zur Laufzeit zu modifizieren.
"20591" - Der Workflow mit der RunID existiert nicht oder ist nicht mehr aktiv.
"20738" - Die Aufgabe befindet sich in einem Status in dem die Änderung nicht vorgenommen werden kann.
"20739" - Die Aufgabe kann nicht geändert werden, da sie zur Zeit von einem anderen Benutzer modifiziert wird.
"20740" - Angabe eines ungültigen Objekttyps.
"20741" - Es existiert keine Aufgabe mit dem angegebenen Namen und/oder der angegebenen laufenden Nummer.
"20742" - Der angegebene Aufgabenname passt nicht zur angegebenen laufenden Nummer.
"20743" - Die Aufgabe kann nicht geändert werden, da ihr Workflow nicht zum Editieren gestoppt wurde.
"20744" - Die Aufgabe kann nicht geändert werden, da sie sich in keinem modifizierbaren Status befindet.
"20745" - Die Änderung der Aufgabe ist nicht zulässig, da der Wert nicht erlaubt ist.
"20746" - Hinzufügen einer Abhängigkeit ist nicht möglich, da diese bereits existiert.
"20747" - Die Änderung einer Abhängigkeit ist nicht möglich, da sie sich in keinem modifizierbaren Status befindet.
"20748" - Das Hinzufügen einer Aufgabe ist nicht möglich, da sich an der Stelle bereits eine Aufgabe befindet.
"20749" - Der Objekttyp der angegebenen Aufgabe ist nicht zulässig.
"20750" - Die Funktion kann für die Aufgabe mit der RunID auf Grund eines vorigen Fehlers nicht durchgeführt werden.
"20752" - Das Ersetzen einer externen Aufgabe ist nur durch eine externe Aufgabe möglich.
"20753" - Die Ersetzung von <START> und <END> ist nicht möglich.
"20754" - <START> darf keinen Vorgänger haben.
"20755" - <END> darf keinen Nachfolger haben.
"20756" - Externe Aufgaben dürfen keinen Vorgänger haben.
"20757" - Bei der Änderung einer externen Abhängigkeit, wurde eine ungültige Aufgabe angegeben.
"20758" - Die Angabe von externen Abhängigkeiten ist nicht möglich.

ADD_TASK:

Laufende Nummer der hinzugefügten Aufgabe im Workflow
"0" - Die Aufgabe konnte nicht hinzugefügt werden.

REPLACE_TASK:

Laufende Nummer der neuen Aufgabe im Workflow
"0" - Die Aufgabe konnte nicht ersetzt werden.

Start, Stop und Commit

[Start, Stop und Commit] [Workflow-Struktur ändern] [Registerkarte Allgemein] [Registerkarte "Frühestens"] [Registerkarte "Abhängigkeiten"] [Registerkarte "Laufzeit"] [Registerkarte "Externe Abhängigkeit"][Registerkarte "Wert"]

Syntax

MODIFY_TASK (RunID, Status, [FORCED])

Syntax

Beschreibung/Format

RunID

Laufende Nummer (RunID) des aktivierten Workflows
Format: Script-Literal, Zahl oder Script-Variable

Status

Verarbeitungsstatus, der für die Aufgabe gesetzt werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte: COMMIT, GO, STOP und STOP_MODIFY

"COMMIT" - Übernimmt die Änderungen ohne den Workflow zu starten.
"GO" - Startet einen gestoppten Workflow. Verwenden Sie den Parameter FORCED, um einen Workflow auch dann zu starten, wenn er im Monitor gerade zur Bearbeitung geöffnet ist.
"STOP" - Stoppt einen Workflow.
"STOP_MODIFY" - Stoppt einen Workflow, um ihn in weiterer Folge zu modifizieren.

FORCED

Ist in Verbindung mit dem Parameter "GO" zu verwenden. FORCED startet einen gestoppten Workflow auch dann, wenn er im Monitor gerade zur Bearbeitung geöffnet ist. Änderungen, die ein anderer Benutzer in der Zwischenzeit eventuell vorgenommen hat, gehen dabei verloren.

Anmerkungen

Die Script-Funktion ändert den Verarbeitungsstatus eines Workflows.

Beispiele

Der Workflow "MAWI.TAG" wird gestoppt, um anschließend Änderungen an ihm durchzuführen.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RET# = MODIFY_TASK(&RUNID#, STOP_MODIFY)

Der Workflow "MAWI.TAG" wird gestartet.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RET# = MODIFY_TASK(&RUNID#, GO, FORCED)

Workflow-Struktur ändern

[Start, Stop und Commit] [Workflow-Struktur ändern] [Registerkarte Allgemein] [Registerkarte Frühestens] [Registerkarte Abhängigkeiten] [Registerkarte Laufzeit] [Registerkarte "Externe Abhängigkeit"] [Registerkarte Wert]

Syntax

MODIFY_TASK (RunID, Objektname,, ADD_TASK [EXTERNAL, Workflow-Name])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Workflows Format: Script-Literal, Zahl oder Script-Variable
Objektname	Name des Objektes, das in den Workflow eingefügt werden soll. Format: Script-Literal, Zahl oder Script-Variable
ADD_TASK	Fügt eine Aufgabe hinzu.
EXTERNAL	Fügt die Aufgabe als externe Abhängigkeit hinzu.
Workflow-Name	Name des Workflows auf die sich die externe Abhängigkeit beziehen soll. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion fügt dem Workflow eine Aufgabe bzw. externe Abhängigkeit hinzu.

Die Aufgabe wird an eine freie Stelle im Workflow positioniert. Verwenden Sie MODIFY_TASK in Verbindung mit MOVE_TASK, um sie zu verschieben.

Beachten Sie, dass die hinzugefügte Aufgabe nicht mit anderen Aufgaben verbunden wird! Ziehen Sie die gewünschten Linien indem Sie MODIFY_TASK in Verbindung mit ADD_DEPENDENCY aufrufen.

Beachten Sie: zwei Kommata sind zu setzen nach dem Parameter Objektname . Beim dritten Parameter handelt es sich um die laufende Nummer einer Aufgabe innerhalb des Workflows. Er hat jedoch für das Hinzufügen einer Aufgabe keine Bedeutung.

Beispiel

Das Objekt "DATEI.EINGANG" wird dem Workflow "MAWI.TAG" hinzugefügt.

:SET &RUNID# = GET_UC_OBJECT_NR(MAWI.TAG)
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#,"FILE.INPUT",, ADD_TASK)
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK (RunID, [task name], [running number], REPLACE_TASK, object name, [EXTERNAL, Workflow-Name])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Workflows Format: Script-Literal, Zahl oder Script-Variable
Task-Name laufende Nummer	Objektname bzw. laufende Nummer der Workflow-Aufgabe, die ersetzt werden soll. Format: Script-Literal, Zahl oder Script-Variable. Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
REPLACE_TASK	Ersetzt eine Aufgabe.
Objektname	Name des Objektes, das die Aufgabe ersetzen soll. Format: Script-Literal oder Script-Variable
EXTERNAL	Ersetzt eine externe Abhängigkeit.
Workflow-Name	Name des Workflows auf die sich die externe Abhängigkeit bezieht. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion ersetzt eine Workflow-Aufgabe durch ein anderes Objekt.

Eine externe Abhängigkeit kann nur durch eine externe Abhängigkeit und eine normale Workflow-Aufgabe kann nur durch eine normale Workflow-Aufgabe ersetzt werden.

Beispiel

Die externe Abhängigkeit "MAWI.DATEIEN.HOLEN" wird durch die externe Abhängigkeit "MAWI.DATEI.EINGANG" ersetzt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "MM.GET.FILES",, REPLACE_TASK, "MM.FILE.INPUT", EXTERNAL)
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [running number], MOVE_TASK ,Column, Line)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Workflows Format: Script-Literal, Zahl oder Script-Variable
Task-Name laufende Nummer	Objektname bzw. laufende Nummer der Workflow-Aufgabe, die verschoben werden soll. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
MOVE_TASK	Verschiebt eine Aufgabe.
Spalte	Nummer der Spalte zu der die Aufgabe verschoben werden soll. Format: Script-Literal, Zahl oder Script-Variable
Zeile	Nummer der Zeile zu der die Aufgabe verschoben werden soll. Format: Script-Literal, Zahl oder Script-Variable

Anmerkungen

Die Script-Funktion verschiebt eine Workflow-Aufgabe.

Beispiel

Die Aufgabe "DATEI.EINGANG" wird in die vierte Zeile der ersten Spalte verschoben.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, MOVE_TASK, 1, 4)
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [running number], ALIAS, Alias)
MODIFY_TASK(RunID, [Task name], [running number], ALIAS_PARENT , Alias Parent)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Workflows Format: Script-Literal, Zahl oder Script-Variable
Task-Name laufende Nummer	Objektname bzw. laufende Nummer der Workflow-Aufgabe, die verschoben werden soll. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt. Existieren mehrere Aufgaben mit dem selben Namen im Workflow und es wird keine laufende Nummer angegeben, so wird automatisch die Aufgabe mit der niedrigsten Nummer verwendet.
ALIAS	Ändert den Alias einer Aufgabe oder externen Abhängigkeit im Workflow
ALIAS_PARENT	Ändert den Alias des Workflows von externen Abhängigkeiten. Nur möglich, wenn die externe Aufgabe von einem anderen Workflow stammt.
Alias Alias Parent	Nummer der Spalte zu der die Aufgabe verschoben werden soll. Format: Script-Literal, Zahl oder Script-Variable Alias für die Aufgabe, externe Abhängigkeit oder für den Workflow der externen Aufgabe (nur bei externen Abhängigkeiten, die auf eine Aufgabe in einem anderen Workflow verweisen). Format: AE-Name, Script-Literal, Zahl oder Script-Variable Für den Alias gelten die selben Einschränkungen wie für den Objektnamen: Maximale Länge: 200 Zeichen Zulässige Zeichen: A-Z, 0-9, $, @, _, -, .

Anmerkungen

Die Script-Funktion ändert den Alias einer Aufgabe bzw. externen Abhängigkeit in einem Workflow.

Der Alias kann nur von Workflow-Aufgaben und externen Abhängigkeiten geändert werden, die mit dem Sprachmittel neu hinzugefügt wurden. Verwenden Sie dazu den Parameter ADD_TASK.

Wir empfehlen immer die laufende Nummer anzugeben, um die Änderung an der richtigen Aufgabe durchzuführen! Dies ist vor allem dann notwendig, wenn sich mehrere Aufgaben mit dem selben Objektnamen im Workflow befinden. Die laufende Nummer erhalten Sie als Rückgabewert der Script-Funktion, wenn Sie eine Aufgabe hinzufügen (ADD_TASK).

Beispiel

Die Aufgabe "DATEI.EINGANG" wird dem Workflow "MAWI.TAG" hinzugefügt und deren Alias auf "ALIAS.FT" geändert.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &NR# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, ADD_TASK)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",&NR#,ALIAS,ALIAS.FT)
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte Allgemein

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], CHECKPOINT, Zeitstempel, [Zeitzone], [Alarmobjekt])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
CHECKPOINT	Setzt bzw. entfernt einen Kontrollpunkt
Zeitstempel	Zeitstempel für den Kontrollpunkt. Format: Script-Literal oder Script-Variable Erlaubte Werte: Zeitstempel im Format "TT/HH:MM" - Setzt einen Kontrollpunkt mit diesem Zeitstempel "NONE" - Entfernt den Kontrollpunkt
Zeitzone	Name eines ZeitZonen-Objektes. Format: Script-Literal oder Script-Variable Zeitzone für die der Zeitstempel umgerechnet werden soll.
Alarmobjekt	Objekt, das gestartet werden soll, wenn der Kontrollpunkt überschritten wird. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion fügt einer Workflow-Aufgabe einen Kontrollpunkt hinzu oder entfernt ihn.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" erhält einen Kontrollpunkt. Das Benachrichtigungs-Objekt "TAGSCHICHT" soll gestartet werden, wenn der Kontrollpunkt überschritten wird.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, CHECKPOINT, "00/15:00",,"DAYSHIFT")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte "Frühestens"

[Start, Stop und Commit] [Workflow-Struktur ändern] [Registerkarte Allgemein] [Registerkarte Frühestens] [Registerkarte Abhängigkeiten] [Registerkarte Laufzeit] [Registerkarte "Externe Abhängigkeit"] [Registerkarte Wert]

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], EARLIEST_START, Zeitstempel, [Zeitzone])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
EARLIEST_START	Setzt bzw. entfernt einen frühesten Startzeitpunkt
Zeitstempel	Zeitstempel für den frühesten Startzeitpunkt. Format: Script-Literal oder Script-Variable Als Vergleichswert für den frühesten Startzeitpunkt wird das reale Datum (= Generierungszeitpunkt des obersten Workflows) verwendet. Erlaubte Werte: Zeitstempel im Format "TT/HH:MM" - Setzt einen frühesten Startzeitpunkt mit diesem Zeitstempel "NONE" - Entfernt den frühesten Startzeitpunkt
Zeitzone	Name eines ZeitZonen-Objektes. Format: Script-Literal oder Script-Variable Zeitzone für die der Zeitstempel umgerechnet werden soll.

Anmerkungen

Die Script-Funktion fügt einer Workflow-Aufgabe einen frühesten Startzeitpunkt hinzu oder entfernt ihn.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" erhält einen frühesten Startzeitpunkt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, EARLIEST_START, "00/18:00")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK (RunID, [Task name], [Running number], ACTIVE, Value)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
ACTIVE	Setzt eine Workflow-Aufgabe auf aktiv bzw. inaktiv.
Wert	Erlaubte Werte: "YES" und "NO" "YES" - Setzt die Workflow-Aufgabe auf aktiv. Sobald ihr Startzeitpunkt gekommen ist, wird sie durchgeführt. "NO" - Setzt die Workflow-Aufgabe auf inaktiv. Sobald ihr Startzeitpunkt gekommen ist, wird sie nicht durchgeführt.

Anmerkungen

Die Script-Funktion setzt eine Workflow-Aufgabe auf aktiv bzw. inaktiv.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" wird inaktiv gesetzt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, ACTIVE, "NO")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK (RunID, [Task name], [Running number], BREAKPOINT, Value)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
BREAKPOINT	Setzt bzw. entfernt einen Haltepunkt auf eine Workflow-Aufgabe.
Wert	Erlaubte Werte: "YES" und "NO" "YES" - Setzt einen Haltepunkt bei dieser Workflow-Aufgabe. "NO" - Entfernt den Haltepunkt bei dieser Workflow-Aufgabe.

Kommentare

Die Script-Funktion setzt bzw. entfernt einen Haltepunkt bei einer Workflow-Aufgabe.

Beispiel

Bei der Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" wird ein Haltepunkt gesetzt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, BREAKPOINT, "YES")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte Abhängigkeiten

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], LATEST_START,Zeitstempel, [Zeitzone])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
LATEST_START	Setzt bzw. entfernt einen spätesten Startzeitpunkt
Zeitstempel	Zeitstempel für den spätesten Startzeitpunkt. Format: Script-Literal oder Script-Variable Erlaubte Werte: Zeitstempel im Format "TT/HH:MM" - Setzt einen spätesten Startzeitpunkt mit diesem Zeitstempel "NONE" - Entfernt den spätesten Startzeitpunkt
Zeitzone	Name eines ZeitZonen-Objektes. Format: Script-Literal oder Script-Variable Zeitzone, für die der Zeitstempel umgerechnet werden soll.

Anmerkungen

Die Script-Funktion fügt einer Workflow-Aufgabe einen spätesten Startzeitpunkt hinzu oder entfernt ihn.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" erhält einen spätesten Startzeitpunkt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, LATEST_START, "00/10:00")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], LATEST_END,Zeitstempel, [Zeitzone])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
LATEST_END	Setzt bzw. entfernt einen spätesten Endezeitpunkt
Zeitstempel	Zeitstempel für den spätesten Endezeitpunkt. Format: Script-Literal oder Script-Variable Erlaubte Werte: Zeitstempel im Format "TT/HH:MM" - Setzt einen spätesten Endezeitpunkt mit diesem Zeitstempel "NONE" - Entfernt den spätesten Endezeitpunkt
Zeitzone	Name eines ZeitZonen-Objektes. Format: Script-Literal oder Script-Variable Zeitzone, für die der Zeitstempel umgerechnet werden soll.

Anmerkungen

Die Script-Funktion fügt einer Workflow-Aufgabe einen spätesten Endezeitpunkt hinzu oder entfernt ihn.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" erhält einen spätesten Endezeitpunkt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, LATEST_END, "00/18:00")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], DEPENDENCY_STATE_MATCH,Wert)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
DEPENDENCY_STATE_MATCH	Beeinflusst wieviele Status der Vorgänger zutreffen müssen
Wert	Erlaubte Werte: "ALL" und "ONE" "ALL" - Alle Status müssen zutreffen "ONE" - Mindestens 1 Status muss zutreffen

Kommentare

Die Script-Funktion bestimmt wieviele Status der Vorgänger zutreffen müssen, damit die Workflow-Aufgabe durchgeführt werden kann.

Beispiel

Alle Vorgänger der Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" müssen dem erwarteten Status entsprechen.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, DEPENDENCY_STATE_MATCH, "ALL")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK (RunID, [Successor task name], [Running number], Dependency, [Source task name], [Running number], Status)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Workflows Format: Script-Literal, Zahl oder Script-Variable
Nachfolger-Aufgabenname Laufende Nummer	Name bzw. laufende Nummer der Nachfolger-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
Abhängigkeit	Aktion zum Bearbeiten der Abhängigkeiten Erlaubte Werte: ADD_DEPENDENCY, MODIFY_DEPENDENCY und REMOVE_DEPENDENCY "ADD_DEPENDENCY" - fügt eine Abhängigkeit hinzu "MODIFY_DEPENDENCY" - ändert eine Abhängigkeit "REMOVE_DEPENDENCY" - entfernt eine Abhängigkeit
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Aufgabe, bei der die Abhängigkeit geändert werden soll. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
Status	Status, der für die Vorgängeraufgabe bei Durchführungsende erwartet wird. Format: Script-Literal oder Script-Variable Erlaubte Werte: "Endestatus" und "NONE" "Endestatus" - z.B: ENDED_OK "NONE" - Der Endestatus der Vorgängeraufgabe wird nicht überwacht. Bei "REMOVE_DEPENDENCY" muss kein Status angegeben werden.

Anmerkungen

Die Script-Funktion fügt einer Workflow-Aufgabe eine Abhängigkeit hinzu, ändert oder entfernt sie. Sie verbindet damit auch Aufgaben durch Linien.

Beispiel

Das START-Kästchen wird mit der 4. Aufgabe verbunden. Zusätzlich ändert sich der Ende-Status, den die 9. Aufgabe von seinem Vorgänger der 8. Aufgabe erwartet, auf "ANY_OK". Die Abhängigkeit und damit auch die Linie zwischen der 10. und 11. Aufgabe wird entfernt.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#,, 4, ADD_DEPENDENCY, "START",, "ENDED_OK")
:SET &RET# = MODIFY_TASK(&RUNID#,, 9, MODIFY_DEPENDENCY,, 8,"ANY_OK")
:SET &RET# = MODIFY_TASK(&RUNID#,, 11, REMOVE_DEPENDENCY,, 10, "ENDED_OK")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], DEPENDENCY_ELSE_ACTION , Sonst-Aktion, [Alarmobjekt])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
DEPENDENCY_ELSE_ACTION	Bestimmt die Aktion, die ausgeführt werden soll, wenn die Abhängigkeiten nicht wie erwartet eintreffen.
Sonst-Aktion	Erlaubte Werte: ABORT, BLOCK, BLOCK_ABORT und SKIP "ABORT" - Die Aufgabe und der Workflow selbst werden abgebrochen. "BLOCK" - Der Workflow blockiert bei der Vorgängeraufgabe. "BLOCK_ABORT" - Der Workflow blockiert bei der Vorgängeraufgabe und schickt ein Abbruch-Signal an den übergeordneten Workflow (sofern vorhanden). "SKIP" - Die Ablauf-Aufgabe wird übersprungen.
Alarmobjekt	Objekt, das gestartet werden soll, wenn der Kontrollpunkt überschritten wird. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion bestimmt die Aktion, die ausgeführt werden soll, wenn die Abhängigkeiten nicht wie erwartet eintreffen.

Beispiel

Die Aufgabe "DATEI.EINGANG" des Workflows "MAWI.TAG" wird übersprungen, wenn die Abhängigkeiten nicht zutreffen.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, DEPENDENCY_ELSE_ACTION, "SKIP")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte Laufzeit

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], Runtime option, Value)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
Laufzeitoption	Laufzeitoption, die geändert werden soll. Erlaubte Werte: "RUNTIME_USE_TASK_SETTINGS" - MRT/SRT-Einstellungen der Aufgabe verwenden. "RUNTIME_MRT_NONE" - Keine maximale Laufzeit. "RUNTIME_MRT_FIXED" - Fixwert für die maximale Laufzeit. "RUNTIME_MRT_ERT" - ERT plus Prozentsatz für die maximale Laufzeit. "RUNTIME_MRT_TIME" - Aktuelles Datum plus Zeitraum für die maximale Laufzeit. "RUNTIME_SRT_NONE" - Keine minimale Laufzeit. "RUNTIME_SRT_FIXED" - Fixwert für die minimale Laufzeit. "RUNTIME_SRT_ERT" - ERT minus Prozentsatz für die minimale Laufzeit. "RUNTIME_ELSE_ACTION" - Sonst-Aktion, wenn die Laufzeit abweicht.
Wert	Der Wert richtet sich nach der Laufzeitoption: Für "RUNTIME_USE_TASK_SETTINGS": "YES" und "NO" "YES" - Laufzeitoptionen der Aufgabe verwenden "NO" - Laufzeitoptionen der Eigenschaften verwenden Für "RUNTIME_MRT_NONE": Kein Wert Für "RUNTIME_MRT_FIXED": Fixwert im Format "HHHH:MM:SS" Für "RUNTIME_MRT_ERT": Prozentsatz Für "RUNTIME_MRT_TIME": "TT/HH:MM" [, Zeitzone] "TT" - Tage, die zum aktuellen Datum addiert werden "HH:MM" - Uhrzeit Zeitzone, für die der Zeitstempel umgerechnet werden soll. For "RUNTIME_SRT_NONE": Kein Wert For "RUNTIME_SRT_FIXED": Fixwert im Format "HHHH:MM:SS" For "RUNTIME_SRT_ERT": Prozentsatz For "RUNTIME_ELSE_ACTION": Sonst-Aktion [, Alarmobjekt] Sonst-Aktion - "CANCEL" (Aufgabe abbrechen/beenden) und "NONE" (keine Sonst-Aktion ausführen) Alarmobjekt, das gestartet werden soll, wenn die erwartete Laufzeit überschritten wird.

Anmerkungen

Die Script-Funktion ändert die Laufzeit-Einstellungen einer Workflow-Aufgabe.

Beispiel

Dauert die Durchführung der Aufgabe "DATEI.EINGANG" länger als zwei Stunden, wird das Benachrichtigungsobjekt "TAGSCHICHT" gestartet. Die minimale Laufzeit ist unerheblich.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RETMRT# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, RUNTIME_MRT_FIXED, "2:00:00")
:SET &RETSRT# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, RUNTIME_SRT_NONE)
:SET &RETACT# = MODIFY_TASK(&RUNID#, "FILE.INPUT",, RUNTIME_ELSE_ACTION,"CANCEL", "DAYSHIFT")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte Externe Abhängigkeit

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], EXTERNAL_SATISFACTION,Erfüllungszeitraum, [Dauer])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
EXTERNAL_SATISFACTION	Legt den Erfüllungszeitraum fest.
Erfüllungszeitraum	Gültigkeit des Erfüllungszeitraumes. Format: Script-Literal oder Script-Variable Erlaubte Werte: "LOGICAL_DATE", "LAST_EXECUTION", "BEFORE_START" und "AFTER_START" "LOGICAL_DATE" - Nur gültig, wenn mit gleichem logischem Datum aktiviert "LAST_EXECUTION" - Seit letzter Workflow-Durchführung "BEFORE_START" - Innerhalb eines Zeitraumes vor Workflow-Start "AFTER_START" - Nach Workflow-Start
Dauer	Zeitraum für die Option "BEFORE_START" im Format "HH:MM:SS" Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion legt den Erfüllungszeitraum einer externen Abhängigkeit fest.

Beispiel

Der Erfüllungszeitraum für die externe Abhängigkeit "MAWI.DATEIEN.HOLEN" beginnt mit dem Start des Workflows.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "MM.GET.FILES",, EXTERNAL_SATISFACTION, "AFTER_START")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], EXTERNAL_STATUS , Status)

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
EXTERNAL_STATUS	Setzt bzw. entfernt den erwarteten Status.
Status	Status, der für die externe Aufgabe bei Durchführungsende erwartet wird. Format: Script-Literal oder Script-Variable Erlaubte Werte: "Endestatus" und "NONE" "Endestatus" - z.B: ENDED_OK "NONE" - Es wird nur geprüft, ob die Aufgabe im Erfüllungszeitraum endete. Ihr Status spielt in diesem Fall keine Rolle.

Anmerkungen

Die Script-Funktion setzt den erwarteten Status einer externen Abhängigkeit.

Beispiel

Der Workflow "MAWI.TAG" erwartet den Status "ENDED_OK" für die externe Abhängigkeit auf "MAWI.DATEIEN.HOLEN".

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "MM.GET.FILES",, EXTERNAL_STATUS, "ENDED_OK")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], EXTERNAL_ELSE_ACTION, Action, [Alarmobjekt])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
EXTERNAL_ELSE_ACTION	Bestimmt die Aktion, die ausgeführt werden soll, wenn die externe Aufgabe im Erfüllungszeitraum entweder nicht den erwarteten Status mindestens einmal erreicht hat oder gar nicht endete.
Aktion	Erlaubte Werte: "WAIT", "SKIP" und "CANCEL" "WAIT" - Warten "SKIP" - Überspringen "CANCEL" - Workflow abbrechen
Alarmobjekt	Objekt, das gestartet werden soll, wenn ein Timeout eintritt. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion bestimmt die Sonst-Aktion einer externen Abhängigkeit.

Beispiel

Der Workflow "MAWI.TAG wird abgebrochen, wenn die externe Abhängigkeit auf "MAWI.DATEIEN.HOLEN" nicht wie erwartet eintrifft. Das Benachrichtigungs-Objekt "TAGSCHICHT" soll in diesem Fall gestartet werden.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "MM.GET.FILES",, EXTERNAL_ELSE_ACTION, "CANCEL", "DAYSHIFT")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Syntax

MODIFY_TASK(RunID, [Task name], [Running number], EXTERNAL_TIMEOUT_ACTION,Timeout length, Action, [Alarmobjekt])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
EXTERNAL_TIMEOUT_ACTION	Legt die Zeitspanne fest, die bei der Sonst-Aktion "WAIT" abgewartet werden soll.
Timeoutlänge	Dauer des Timeouts im Format "HH:MM:SS" Format: Script-Literal oder Script-Variable
Aktion	Erlaubte Werte: "WAIT", "SKIP" und "CANCEL" "WAIT" - Warten "SKIP" - Überspringen "CANCEL" - Workflow abbrechen
Alarmobjekt	Objekt, das gestartet werden soll, wenn ein Timeout eintritt. Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion legt die Timeout-Einstellung einer externen Abhängigkeit fest.

Beispiel

Die externe Abhängigkeit auf "MAWI.DATEIEN.HOLEN" wird übersprungen, wenn eine Stunde abgelaufen ist.

:SET &RUNID# = GET_UC_OBJECT_NR("MM.DAY")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &RET# = MODIFY_TASK(&RUNID#, "MM.GET.FILES",, EXTERNAL_TIMEOUT_ACTION, "01:00:00", "SKIP")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Registerkarte Wert

Syntax

MODIFY_TASK(RunID, Task name, Running number, VALUE,PROMPTSET NAME || <VALUE>, VARIABLE || NEW VARIABLE, "VALUE", [SELECT || DESELECT || CLEAR || -> Standard SPACE])

Syntax	Beschreibung/Format
RunID	Laufende Nummer (RunID) des aktivierten Objektes Format: Script-Literal, Zahl oder Script-Variable
Task-Name Laufende Nummer	Name bzw. laufende Nummer der Workflow-Aufgabe. Format: Script-Literal, Zahl oder Script-Variable Eine Aufgabe in einem Workflow wird entweder mit ihrem Namen oder ihrer laufenden Nummer identifiziert. Sie haben die Möglichkeit entweder den Aufgabennamen oder die Nummer innerhalb des Workflows anzugeben. Verwenden Sie beide Parameter, so müssen der Name und die Nummer übereinstimmen. Beachten Sie, dass bei der laufenden Nummer nicht die RunID der Aufgabe, sondern die Nummer innerhalb des Workflows gemeint ist (z.B: "3" für die dritte Aufgabe)! Die laufende Nummer ist im Aufgaben-Kästchen vermerkt.
VALUE	Fester Parameter "VALUE" – ändert den Wert einer Variable: Objektvariable – vorhandenen Wert der Variable ändern oder neue Variable mit Wertangabe erstellen PromptSet Variable – vorhandenen Wert der Variable einer PromptSet Control ändern
PromptSet-Name oder "<VALUE>"	Name des PromptSet = Name des PromptSet-Objekts "<VALUE>" = gibt eine Objektvariable an (z.B. "&myvar#")
Variablenname	Wenn die Variable nicht vorhanden ist, und der vorherige Parameter auf <VALUE> gesetzt ist, wird die Variable erstellt.
Wert	Wert für Variable (optional) Format: Script-Literal oder Script-Variable Dieser Parameter ist für Arrays zwingend erforderlich (bei Verwendung von PromptSets).
SELECT oder DESELECT oder CLEAR oder SPACE (Standardwert)	Dieser Parameter wird verwendet, um die Auswahl eines Arrays (PromptSet Steuerung) zu ändern. (Optional) SELECT = ausgewählte Zeilen eines Arrays markieren (PromptSet Controls: z.B. Checkliste, Kontrollkästchen) DESELECT = Markierung ausgewählter Zeilen eines Arrays aufheben CLEAR = Markierung aller Zeilen eines Arrays aufheben Änderung aller Nicht-Arrays (PromptSet Controls-Wert, Wert von Objektvariablen) SPACE (default) = leerer Text

Anmerkungen

Der Parameter VALUE ändert den Wert einer Variable:

Objektvariable – vorhandenen Wert der Variable ändern oder neue Variable mit Wertangabe erstellen
PromptSet Variable – vorhandenen Wert der Variable einer PromptSet Control ändern

Beispiele

Beispiel 1: Ändert den Wert der Variable &VARIABLE# einer Workflow-Aufgabe SCRI.NEW.01 (SCRI)und setzt ihn auf den Wert "Vienna-City". Wenn die Variable &VARIABLE# nicht vorhanden ist, wird sie mit dem Wert "Vienna-City" erstellt.

:SET &RUNID# = ACTIVATE_UC_OBJECT("JOBP.NEW.01")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &MODIFY# = MODIFY_TASK(&RUNID#, "SCRI.NEW.01", 4, VALUE, "<VALUE>", "&&VARIABLE#", "Vienna-City")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Beispiel 2: Ändert die Workflow-Aufgabe SCRI.NEW.01 (SCRI) durch Setzen ihrer PromptSet-Werte PRPT.NEW.01 (PRPT). Wählen Sie das Element "Test01" aus der PromptSet Control-Checkliste "CKG#".
("CKG#" steht in dieser Checkliste für einen Array von PromptSet Controls; "Test01" ist eines der Elemente in diesem Array, das über Script markiert wird.)

:SET &RUNID# = ACTIVATE_UC_OBJECT("JOBP.NEW.01")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &MODIFY# = MODIFY_TASK(&RUNID#, "SCRI.NEW.01", 4, VALUE, "PRPT.NEW.01", "CKG#", "Test01", "SELECT")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Beispiel 3: Ändert den Wert derPomptSet-Variable "Textfield01#" auf "mytextfieldvalue"

:SET &RUNID# = ACTIVATE_UC_OBJECT("JOBP.NEW.01")
:SET &RETSTOP# = MODIFY_TASK(&RUNID#, STOP_MODIFY)
:SET &MODIFY# = MODIFY_TASK(&RUNID#, "SCRI.NEW.01", 4, VALUE, "PRPT.NEW.01", "Textfield01#", "mytexfieldvalue")
:SET &RETCOMMIT# = MODIFY_TASK(&RUNID#, COMMIT)
:SET &RETGO# = MODIFY_TASK(&RUNID#, GO)

Siehe auch:

Script-Sprachmittel	Beschreibung
MODIFY_UC_OBJECT	Ändert das Attribut eines aktivierten Objektes.

Script-Sprachmittel - Objekte aktivieren

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