Übergeordnete Aufgabe

Ausführen von Objekten

Dialog-Modus

---

Objekt- und PromptSet-Variablen

Fast jedes ausführbare Objekt enthält eine Registerkarte namens "Variablen & Prompts". Diese ist in 2 Bereiche unterteilt: Variablen und PromptSets. In dem Bereich "Variablen" tragen Sie Variablen ein, die Sie in den Script-Registerkarten und in Attributen nutzen wollen. Bei "PromptSets" ist die Zuordnung von PromptSet-Objekten möglich, dessen Variablen ebenfalls für das Objekt zur Verfügung stehen. Die Variablen müssen nicht extra ausgelesen werden, sondern sind direkt als Script-Variablen verwendbar.

Objekt- und PromptSet Variablen stehen in allen Script-Registerkarten und in den Attributen des Objektes zur Verfügung.

In der folgenden Abbildung sehen Sie eine Objektvariable namens "&HOST#".

Im Script kann die Variable sofort genutzt werden. Das folgende Beispiel verwendet die Objektvariable, um die Verbindung zum Agenten zu trennen.

:IF SYS_HOST_ALIVE(&HOST#) = "N"
:   SEND_MSG "ADMIN","AE","Agent &HOST# is not active!"
:ENDIF

Die Werte von Objektvariablen können dabei mit oder ohne Hochkommata angegeben werden. Falls Sie einfache Hochkommata verwenden, muss ein einzelnes Hochkomma innerhalb des Strings doppelt vorkommen, da sonst unter Umständen ein oder mehrere Zeichen entfernt werden. Ein doppeltes Hochkomma dagegen wird immer als normales Zeichen behandelt und nicht entfernt.

Beispiele: 

Objekt- und PromptSet-Variablen haben eine weitere Besonderheit. Sie können vom übergeordneten Objekt geerbt werden. Den Aufgaben eines Schedules ist es beispielsweise möglich, die Objekt- und PromptSet-Variablen des Schedules zu nutzen. Die Wartung wird vereinfacht, da die Werte nicht in den einzelnen Objekten hinterlegt werden müssen.

In der Registerkarte "Variablen & Prompts" stellen Sie ein ob, und wenn ja, welche Objektvariablen geerbt werden sollen.  

Die Vererbung wird immer für Objekte vorgenommen, die mit ACTIVATE_UC_OBJECT und dem Parameter PASS_VALUES aktiviert werden. Dies ist unabhängig von der Einstellung "Von Parent erben"!

PromptSet- und Objekt-Variablen werden nicht geerbt, wenn die untergeordnete Aufgabe eine PromptSet-Variable mit dem selben Namen besitzt! Dieses Verhalten ist unabhängig von der Einstellung "von Parent erben".

Beachten Sie, dass geerbte Objekt- bzw. PromptSet-Variablen bestehende Objektvariablen überschreiben, wenn sie den gleichen Namen besitzen! PromptSet-Variablen hingegen werden nie übersteuert!

Um eine PromptSet-Variable mit einer Variable der übergeordneten Aufgabe zu überschreiben, gibt es allerdings folgende Möglichkeit:

Öffnen Sie die Eigenschaften der Aufgabe im Workflow oder Schedule. Wechseln Sie in die Registerkarte Variablen & Prompts und danach in den Bereich PromptSets. Tragen Sie nun den Namen der Parent-Variable als Wert für das jeweilige PromptSet-Element ein. Handelt sich beim jeweiligen PromptSet-Element nicht um ein Textfeld, so ist es notwendig, dessen Beschriftung anzuklicken.

Beachten Sie, dass die Einstellung "Von Parent erben" auf alle weiteren untergeordneten Aufgaben des Objektes großen Einfluss hat! Die Vererbung erfolgt immer von einer Aufgabe auf die direkt untergeordnete. Entscheiden Sie sich dafür, bei einem Objekt keine oder nur definierte Werte zu erben, so können auch dessen untergeordnete Aufgaben nicht mehr auf alle Variablen der "Großeltern-Objekte" zugreifen. Anhand der Beispiele weiter unten sehen Sie die Auswirkung der Einstellungen.

Objekt- und PromptSet-Variablen werden vererbt an:

• Workflow-Aufgaben
• Schedule-Aufgaben
• Aufgaben, die von ACTIVATE_UC_OBJECT mit dem Parameter PASS_VALUES gestartet werden
• das Child-Post-Script von RemoteTaskManager-Objekten
• das !Script in Ereignis-Objekten
• Aufgaben, die aus dem Objekt heraus gestartet werden

Bei Letzteren handelt es sich beispielsweise um das Objekt, das in der Registerkarte "Ergebnis" in den Eigenschaften einer Workflow-Aufgabe definiert wurde.

Die Vererbung wird nicht vorgenommen für:

• Aufgaben einer Gruppe
• manuell gestartete Aufgaben
• Objekte, die vom Automation Engine System selbst gestartet werden

Zu letzterem zählt beispielsweise das Benachrichtigungs-Objekt, das als Warnung automatisch vor dem Ablauf des Gültigkeitsdatums eines Kalenders gestartet wird.

PromptSet- und Objekt-Variablen können auch dazu verwendet werden, um bestimmte Objektattribute zu setzen, ohne :PUT_ATT verwenden zu müssen.

Die Script-Anweisung :PSET erstellt für die Dauer der Ausführung einen neuen Eintrag in der Registerkarte "Variablen & Prompts", falls die Objektvariable noch nicht existiert. Ist eine Objektvariable mit dem gleichen Namen bereits vorhanden, wird ihr Wert durch den neuen überschrieben.
Wird die Objektvariable durch die Scriptsprachmittel :SET, :RSET oder :READ verändert, steht der Wert, der als letztes zugewiesen wurde, im Objekt zur Verfügung (In den Registerkarten: Script, PostScript, Child PostScript). Eine explizite Übernahme des Wertes durch das Scriptsprachmittel :RSET z.B. an die PostScript-Registerkarte ist nicht notwendig. 

Wird eine Objektvariable mit der Script-Anweisung :PSET erzeugt, so wird diese automatisch an das übergeordnete Objekt weitergegeben. Falls das übergeordnete Objekt bereits ein Objekt oder eine PromptSet-Variable mit dem selben Namen beinhaltet, wird der Wert dieser Variable überschrieben. Nachfolgende Aufgaben des Parents können dann auf diese Variable zugreifen.

Beim Wiederanlauf eines Objektes werden für Objektvariablen die Werte der Registerkarte "Variablen & Prompts" verwendet, sofern Objektvariablen über diese Registerkarte definiert wurden. Die Werte von bestimmten Durchführungen des Objektes haben daher im Wiederanlauf-Fall keine Bedeutung. Grund: Sollte es zu einem Fehler auf Grund der Objektvariable kommen, so kann der Wert im Objekt korrigiert werden und gilt dann auch für den Wiederanlauf.

Objekt- und PromptSet-Variablen besitzen im Gegensatz zu Script-Variablen keinen bestimmten Datentyp.Mit der Script-Funktion CONVERT haben Sie die Möglichkeit, den Variablen einen bestimmten Datentyp zuzuweisen. 

Beispiele

Beispiel 1

Ein FileTransfer wird durch einen Schedule aktiviert. Sie besitzen die folgenden Objektvariablen:

Schedule:

• &DATEI# = Wochenabschluss.txt
• &HOST# = win01

FileTransfer:

• &DATEI# = Tagesergebnis.txt
• &PFAD# = C:\Temp

Das Script des FileTransfers greift auf die Variablen &DATEI#, &HOST# und &PFAD# zu. Abhängig von der Einstellung in der Registerkarte "Variablen & Prompts" des FileTransfer-Objektes ändert sich der Wert, der diesen Variablen zugewiesen wird:

Beispiel 2

Sehen wir uns nun an, wie sich die Weitergabe der Werte verhält, wenn es sich um eine Kette von Aufgaben handelt.

Ein Workflow enthält die beiden Objekte FILETRANSFER01 und PROCESSFLOW01. Zu letzterem gehören zwei Jobs. Die Wertevererbung zwischen dem Haupt-Workflow und dem FileTransfer ist genauso wie im Beispiel 1.

Betrachten wir daher den PROCESSFLOW01 und wie seine Einstellung die beiden Jobs beeinflusst.

• Alle Objekte weisen die Einstellung "Alle Werte (Standard)" auf.
  Die Objektvariablen werden immer an die jeweils untergeordnete Aufgabe weitervererbt. Der JOB03 kann somit sowohl auf die Objektvariablen des PROCESSFLOW01 als auch auf jene des Haupt-Workflows zugreifen. Die Verwendung von &ORDNER# ist somit im Job möglich. Der FILETRANSFER01 erhält die Objektvariablen des Haupt-Workflows, aber nicht die der anderen Objekte, da sie kein Parent von ihm sind.
• PROCESSFLOW01 weist die Einstellung "Nur definierte Werte" auf. Da der PROCESSFLOW01 nicht die Objektvariable &ORDNER# erbt, können auch die beiden Jobs nicht auf deren Wert zugreifen. Erinnern Sie sich: Die Vererbung wird jeweils von einer Aufgabe auf die direkt darunterliegende vorgenommen.
• JOB03 weist die Einstellung "Keine Werte" auf.
  Das Script des Jobs wird keine Objektvariablen erben. Sein Script bleibt somit unbeeinflusst und &HOST# erhält den Wert "unix03".

Beispiel 3

Folgendes Beispiel enthält die verschiedenen Kombinationen und Besonderheiten der Vererbung von Objekt und PromptSet-Variablen. 

In einem Workflow laufen 5 Aufgaben (Aufgabe 1, 2, 3, 4 und 6), die nacheinander durchgeführt werden. Aufgabe 5 wird über das Script der Aufgabe 4 aktiviert.

Der Workflow besitzt die Objektvariablen &VAR1#, &VAR2# und die PromptSet-Variablen &TEXT1#, &COMBO1#.

• 1. Aufgabe: 
  Auf Grund der Einstellung "von Parent erben - Keine Variablen" werden keine Variablen geerbt.
  
  
• 2. Aufgabe:
  Enthält nur Variablen, die im Objekt selbst definiert wurden. Somit wird nur &VAR2# vererbt und auf den Wert "JOBP2" gesetzt.
  
  
• 3. Aufgabe:
  Erbung aller Variablen des Workflows.
  
  
• 4. Aufgabe:
  Es werden alle Parent-Variablen außer &COMBO1# geerbt. Grund: PromptSet-Variablen mit dem selben Namen werden nicht überschrieben.
  Durch das Script-Sprachmittel :PSET wird die Objektvariable &VAR3# an den Workflow weitergegeben. Diese steht dann für nachfolgende Workflow-Aufgaben zur Verfügung.
  Weiters wird Aufgabe 5 über das Script aktiviert (ACTIVATE_UC_OBJECT) und die Variablen werden weitergegeben (Schlüsselwort: PASS_VALUES)
  
  
• 5. Aufgabe:
  Enthält wiederum nur jene Variablen, die selbst im Objekt definiert wurden.
  &VAR1# wird auf den Wert "JOBP1" und &TEXT1# auf "text" gesetzt (Wert des Workflows).
  
  
• 6. Aufgabe:
  Die nächste Workflow-Aufgabe erbt alle Variablen des Workflows, inklusive &VAR3#, die erst durch Aufgabe 4 an den Workflow weitergegeben wurde.

Siehe auch:

Datentypen von Script-Variablen