EXEC-VARA-Objekte

Verwenden Sie EXEC-VARA-Objekte als Mittler, die die von anderen ausführbaren Objekten zurückgegebenen Werte lesen und weitergeben. Diese Werte können die nachfolgende Ausführung von Objekten beeinflussen oder die Ausführung von Objekten auslösen. Die ausgelesenen Werte speichern Sie in den Script-Variablen, die im EXEC VARA-Objekt definiert sind. Das VARA-Objekt selbst hat keine Eingabeparameter.

Vorbedingungen

Die Namen der Parameter im EXEC-VARA-Objekt und im PromptSet des ausführbaren Objekts, das die Rückgabewerte liefert, müssen identisch sein.

PromptSet-Variablen werden in ausgewählten Feldern für Variablen des Typs BACKEND, EXEC, DATEILISTE, SEC_SQLI, SEC_SQL, SQLI, SQL, und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Combobox-Prompts) verwendet wird.

EXEC-VARA-Objekte definieren

Eine EXEC-VARA-Objektdefinition besteht aus den folgenden Seiten:

• Seite „Allgemein“

• Variablen

  Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden für all diese in eigenen Themen beschrieben:

  • Variablen-Einstellungen, siehe unten
  • Parameter
  • Datentypen und Formatierung
  • Scriptzugriff
  • Mandant-0-VARA-Objekte in anderen Mandanten
  • Vorschau, siehe unten
• Seite „Versionsmanagement“
• Seite „Dokumentation“

Abschnitt „Variablen-Einstellungen“

• Typ

  Schreibgeschützt. Sie legen den Variablentyp fest, wenn Sie das Objekt erstellen. Dies kann nicht mehr geändert werden, wenn die Variable einmal definiert ist.

• Ausführbares Objekt

  Name des ausführbaren Automation Engine-Objekts, aus dem dieses EXEC-VARA-Objekt die Werte liest. Geben Sie es ein oder klicken Sie auf das Symbol, um einen Dialog zu öffnen und danach zu suchen.

  Achtung! Schedule-Objekte sollten nicht mit EXEC-VARA-Objekten verwendet werden.

• Ergebnis-Variable

  Name der Script-Variable, die für den Rückgabewert des ausführbaren Objektes genutzt wird (Angabe obligatorisch).

Abschnitt „Parameter“

Liste der Parameter und Variablen, die im ausführbaren Objekt zur Verfügung stehen, das die Rückgabewerte liefert. Die Werte können sein:

• Direkte Werte, z. B. 5342

• Referenzierende Objektvariablen, z. B. &reftext#.

  Nachfolgende Leerzeichen am Ende von Werten werden beim Speichern von EXEC-Variablen entfernt.

  Wenn Sie die Funktion Dynamisch aktualisieren (Combobox-Prompts) für Combobox-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie PromptSet-Variablen in einem dynamischen VARA-Objekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen VARA-Objekten nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.

Behandeln Sie diese Parameter so als wären sie Prompt Set-/Read-Buffer-Werte. Wenn ein VARA-Objekt das ausführbare Objekt aufruft, verwendet es :PUT_PROMPT_BUFFER, um die angegebenen Parameter einzustellen. Um diese Werte im aufgerufenen ausführbaren Objekt lesen und verwenden zu können, verwenden Sie den Befehl :READ, um die Werte von Variablen mit denselben Namen wie die festgelegten Parameter im betreffenden EXEC-Variablenobjekt zu lesen.

Wichtig! Es reicht nicht aus, die Variablen nur auf der Seite Variablen unter Variablen & Prompts für das aufgerufene ausführbare Objekt zu definieren.

Weitere Informationen finden Sie unter :PUT_READ_BUFFER, :PUT_PROMPT_BUFFER.

Vorschau

Klicken Sie auf Vorschau, um eine Vorschau der Variable zu sehen. Vorschau der gespeicherten oder übertragenen Ergebniswerte wird angezeigt.

Beispiele:

Eine EXEC-Variable in einer Pre-Condition verwenden

Gehen Sie wie folgt vor, um eine EXEC-Variable in einer Pre-Condition zu verwenden: 

1. Fügen Sie in einem ausführbaren Objekt einen Code ähnlich dem folgenden ein:

:SET &RET# = "Y"

2. Erstellen Sie eine EXEC-Variable, die auf das ausführbare Objekt verweist.
3. Greifen Sie auf die EXEC-Variable zu, und zwar entweder in:
   • einem Script mit dem folgenden Code, :SET &TEST# = GET_VAR(VARA.EXEC)
   • einer Eingabeaufforderung oder Pre-Condition mit {VARA.EXEC}

Eine EXEC-Variable als Datensequenz verwenden

Wenn die EXEC-Variable eine Liste von Werten weitergeben soll (z. B. um das Ergebnis in einem Prompt Set-Dropdown zu verwenden):

• Zu diesem Zweck können Sie Datensequenzen verwenden (:CREATE_PROCESS, ....).
• Die erste Zeile ist immer eine Kopfzeile.
• Sie müssen die gespeicherte Datensequenz mit SAVE_PROCESS() zurückgeben.
• Der Prozess muss direkt in dem Objekt gespeichert werden, das für die EXEC-Variable verwendet wird (Workflows mit JOBS und erstellte JOBS, die die Datensequenz gespeichert und veröffentlicht haben, funktionieren nicht).

Um in einem ausführbaren Objekt eine Liste von Werten zurückzugeben, müssen Sie etwas analog dem Folgenden eingeben:

:SET &HND# = CREATE_PROECESS(NEW)

! add the header line

:SET &CHECK# = PUT_PROCESS_LINE(&HND#, "Header A;Header B; Header C", ";")

!fill the process with another one!

:PROCESS &HND_SOURCE#

:   SET &CHECK# = PUT_PROCESS_LINE(&HND#, "Value1;Value 2; Value 3", ";")

:ENDPROCESS

! save process

:SET &RET# = SAVE_PROCESS(&HND#)

:PUBLISH &RET#,,TOP

:CLOSE_PROCESS(&HND#)

Verweisen Sie in dem ausführbaren Objekt VARA.EXEC auf das Objekt mit dem Inhalt. Der Wiedergabewert würde auf &RET# gesetzt werden.

Siehe auch:

• VARA-Objekte
• Variablen und VARA-Objekte