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.

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

Verwenden Sie hier PromptSet-Variablen, wenn Sie die Funktion Dynamisch aktualisieren für Kombinationsfeld-Eingabeaufforderungen verwenden. Die PromptSet-Variablen werden aufgelöst, wenn das Objekt, das die Eingabeaufforderung enthält, ausgeführt wird.

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.

  • 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:

  • 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.

Ein EXEC VARA-Objekt definieren

  1. 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

  2. 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 dynamische Aktualisieren 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 PromptSet-/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.

  3. Definieren Sie Datentypen und Formatierung.

  4. Definieren Sie den Script-Zugriff.

  5. Klicken Sie auf die Schaltfläche Vorschau, um eine Vorschau der gespeicherten oder übertragenen Ergebniswerte anzuzeigen.

  6. Um den Inhalt der Vorschautabelle in eine CSV-Datei zu exportieren, klicken Sie auf Tabelleexportieren. Alle Zeilen und Spalten werden exportiert. Verwenden Sie diese Funktion, wenn Sie den Inhalt der CSV-Datei weiter verarbeiten müssen (ihn in eine andere Anwendung zur weiteren Verarbeitung einfügen usw.).

  7. Um eine oder mehrere Zeilen in der Vorschautabelle zu kopieren, klicken Sie auf die Schaltfläche Kopieren. Die ausgewählten Zeilen werden in die Zwischenablage kopiert und Sie können sie in ein Drittanbieter-Tool (Google, Sheets, Excel, Texteditor usw.) einfügen.

    Hinweis: Diese Funktion ist nur verfügbar, wenn https auf Automic Web Interface verwendet wird.

  8. Speichern Sie Ihre Änderungen.

Ein EXEC VARA-Objekt in einer Vorbedingung verwenden

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

    2. :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 Vorbedingung mit {VARA.EXEC}

Ein EXEC VARA-Objekt als Datensequenz verwenden

Wenn die EXEC-Variable verwenden möchten, um eine Liste von Werten weiterzugeben (z. B. für die Verwendung des Ergebnisses in einem PromptSet-Dropdownfeld), gehen Sie wie folgt vor:

  • 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 wie das Folgende eingeben:

:SET &HND# = CREATE_PROCESS(NEW)

! Die Kopfzeile hinzufügen

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

! Den Prozess mit einem anderen ausfüllen!

:PROCESS &HND_SOURCE#

:   SET &CHECK# = PUT_PROCESS_LINE(&HND#, "Wert1;Wert 2; Wert 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: