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.

Diese Seite beinhaltet Folgendes:

Voraussetzungen

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, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) verwendet wird.

EXEC VARA-Objekte definieren

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

Seite "Allgemein"

Gemeinsam für alle Objekttypen definieren Sie hier grundlegende Objektinformationen und wenden benutzerdefinierte Werte auf sie an.
Seite Variablen, siehe unten

Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden in jeweils eigenen Themen beschrieben. Dieses Thema beschreibt die EXEC-spezifischen Einstellungen auf der Seite Variablen.
Seite "Versionsmanagement"

Allgemein für alle Objekttypen finden Sie hier eine Liste aller Versionen des Objekts.
Seite "Dokumentation"

Hier geben Sie die Informationen ein, die Sie als wichtig erachten, um die Konfiguration und das Verhalten des Objekts zu verstehen.

Die Seite "Variablen" definieren

Geben Sie im Abschnitt Variableneinstellungen an, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft.
- 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.
  
  Hinweis: Schedule-Objekte dürfen für EXEC VARA-Objekte nicht verwendet werden.
- Ergebnis-Variable
  
  Name der Script-Variablen, die für den Rückgabewert des ausführbaren Objektes genutzt wird
Geben Sie im Abschnitt Parameter die Liste der Parameter und Variablen an, die im ausführbaren Objekt verfügbar sind. Die Werte können sein:
- Direkte Werte, z. B. 5342
- Referenzvariablen, wie z. B. &reftext#
  
  Nachfolgende Leerzeichen am Ende von Werten werden beim Speichern von EXEC-Variablen entfernt
  
  Wenn Sie die Funktion für das Dynamisch aktualisieren (Kombinationsfeld-Prompts) für Kombinationsfeld-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 zu lesen und zu verwenden, müssen Sie den Befehl :READ verwenden. Dieser Befehl liest die Werte von Variablen mit demselben Namen auf. Die Werte hängen von den Parametern ab, die im aufrufenden EXEC-Variablenobjekt festgelegt werden.

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

Weitere Informationen finden Sie unter :PUT_READ_BUFFER, :PUT_PROMPT_BUFFER.
Definieren Sie Datentypen und Formatierung.
Definieren Sie den Script-Zugriff.
Wenn Sie bei Mandant 0 angemeldet sind, ist ein zusätzlicher Abschnitt verfügbar.Weitere Informationen finden Sie unter Mandant-0-VARA-Objekte in anderen Mandanten.
Klicken Sie auf die Schaltfläche Vorschau, um eine Vorschau der gespeicherten oder übertragenen Ergebniswerte anzuzeigen.
Speichern Sie Ihre Änderungen.

Eine EXEC-Variable in einer Vorbedingung verwenden

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

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

:SET &RET# = "Y"

Erstellen Sie eine EXEC-Variable, die auf das ausführbare Objekt verweist.
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 Vorbedingung mit {VARA.EXEC}

Verwendung einer EXEC-Variablen als Datensequenz

Wenn die EXEC-Variable eine Liste von Werten weitergeben soll (z. B. um das Ergebnis in einem PromptSet-Dropdownfeld 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_PROCESS(NEW)

! die Kopfzeile hinzufügen

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

! Füllen Sie den Prozess mit einem anderen aus!

:PROCESS &HND_SOURCE#

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

:ENDPROCESS

! Prozess speichern

: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 Rückgabe würde auf &RET# gesetzt.

Siehe auch: