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

:ATTACH_SYNC

Script-Anweisung: Weist einer Aufgabe ein Sync-Objekt zu.

Syntax

:ATTACH_SYNC [Object type], [RunID], Sync Object, [Start Action], [Abend Action], [End Action], Other, [NEXT_OBJECT]

Syntax	Beschreibung/Format
Objekttyp	Kurzbezeichnung eines aktivierbaren Objektes Format: Script-Literal oder Script-Variable
RunID	Laufende Nummer (RunID) des Objektes. Format: Script-Literal, Script-Variable oder Zahl
Sync-Objekt	Name eines Sync-Objektes, mit dem die Aufgabe synchronisiert werden soll. Format: Script-Literal oder Script-Variable
Start-Aktion	Aktion, die beim Start der Aufgabe durchgeführt werden soll. Format: Script-Literal oder Script-Variable
Abend-Aktion	Aktion, die beim Abbruch der Aufgabe durchgeführt werden soll. Format: Script-Literal oder Script-Variable
End-Aktion	Aktion, die beim Beenden der Aufgabe durchgeführt werden soll. Format: Script-Literal oder Script-Variable
Sonstige	Behandlung der Aufgabe, wenn weder Start-Aktion, Abend-Aktion noch End-Aktion ausgeführt werden können. Format: Script-Literal oder Script-Variable Erlaubte Werte: "A", "W" oder "S" "A" - Abgebrochen (Abend) "W" - Warten (Wait) "S" - Überspringen (Skip)
NEXT_OBJECT	Das Sync-Objekt soll dem direkten Nachfolger in einem Workflow zugewiesen werden. Format: Script-Literal oder Script-Variable

Kommentare

Die Script-Anweisung ermöglicht es, einer bereits aktivierten Aufgabe ein Sync-Objekt hinzuzufügen. Die Zuweisung erfolgt temporär, d.h. nur für die Dauer ihrer Durchführung. Objekttyp ist ein optionaler Parameter, da der Objekttyp durch die laufende Nummer (RunID) eindeutig zugeordnet werden kann.

Die Script-Anweisung kann dazu verwendet werden, um beispielsweise in einem Workflow einer der nachfolgenden Aufgaben ein Sync zuzuweisen, und so die weitere Verarbeitung zu beeinflussen. Bei der Aufgabe, deren Script die Script-Anweisung enthält, muss die Option Zur Laufzeit generieren gesetzt sein. Die nachfolgende Aufgabe, der ein Sync zugewiesen werden soll, muss bereits aktiviert worden sein und somit eine RunID besitzen.Sie darf daher nicht die Option Zur Laufzeit generieren gesetzt haben. Mit dem Parameter NEXT_OBJECT kann dem direkten Nachfolger einer Aufgabe in einem Workflow ein Sync zugewiesen werden. Als Einschränkung gilt dabei, dass nur ein Nachfolger existieren darf.

Mit der Script-Anweisung kann auch der eigenen Aufgabe ein Sync zugewiesen werden. Die Sync-Bedingungen könnten dabei beispielsweise variabel gebildet werden. Der Parameter RunID muss hier nicht angegeben werden. Es ist jedoch das Komma für diesen nicht verwendeten Parameter zu setzen. Die Option Zur Laufzeit generieren darf in diesem Fall nicht aktiviert sein, da die Prüfung auf Sync-Objekte zu dem Zeitpunkt, an dem das Script durchgeführt wird, bereits abgeschlossen ist.

Das Script-Sprachmittel besitzt keine Wirkung auf Script-Objekte, da diese Objekte mit der Generierung bereits abgeschlossen sind, die Synchronisation jedoch erst danach erfolgt.

Soll einer anderen, bereits aktivierten Aufgabe ein Sync zugewiesen werden, ist das generell nur bei bestimmten Status möglich. Die Aufgabe darf entweder noch nicht gestartet sein (System-Rückgabewert < 1540) oder sie befindet sich in einem Wartezustand (System-Rückgabewert zwischen 1600 und 1700). Hat die Aufgabe einen anderen Zustand, führt dies zu einem Laufzeitfehler und zum Abbruch des Scripts.

Beispiele

Im ersten Beispiel wird dem Job "ARCHIV01" das Sync-Objekt "SYSTEM_0001_EXCLUSIVE_SYNC" hinzugefügt. Sollten die angegebenen Aktionen nicht ausgeführt werden können, wird der Job abgebrochen.

:SET &RUNNR# = GET_UC_OBJECT_NR(ARCHIVE01)
:ATTACH_SYNC &RUNNR#,"SYSTEM_0001_EXCLUSIVE_SYNC","USE","RELEASE","RELEASE","A"

Im zweiten Beispiel wird das Sync-Objekt der direkt nachfolgenden Aufgabe im Workflow zugewiesen.

:ATTACH_SYNC ,"SYSTEM_0001_EXCLUSIVE.SYNC","USE","RELEASE","RELEASE","A","NEXT_OBJECT"

Siehe auch:

Script-Sprachmittel	Beschreibung
SET_SYNC	Führt die definierte Aktion eines Sync-Objektes aus.
GET_SYNC	Fragt den aktuellen Zustand oder Wert eines Sync-Objektes ab.

Script-Sprachmittel - Objekte lesen oder verändern

Sync-Objekte
System-Rückgabewerte von aktivierbaren Objekten

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