Variablen und VARA-Objekte

Mit Variablen und VARA-Objekten können Sie Platzhalter für Werte definieren, die in ausführbaren Objekten verwendet werden sollen. In diesem Thema werden die verschiedenen Arten von Variablen und VARA-Objekten unterschieden, die Sie in Ihrem System finden können. Als Entwickler und Objektdesigner erstellen Sie Variablen und VARA-Objekte und verwenden sie in ausführbaren Objekten. Als Systemadministrator pflegen Sie Mandanten- und Systemvariablen sowie VARA-Objekte.

Diese Seite beinhaltet Folgendes:

Übersicht

Wenn eine Aufgabe generiert wird, löst das System Variablen und Referenzen auf VARA-Objekte auf, um Werte aus verschiedenen Quellen abzurufen. Die Werte von Variablen und VARA-Objekten werden bei Aktivierung oder zur Laufzeit aufgelöst, wie auf der Seite Attribute in der Objektdefinition definiert. Weitere Informationen finden Sie unter Generierung zum Aktivierungszeitpunkt oder zur Laufzeit.

VARA-Objekte

VARA-Objekte sind Entities mit eigenen Attributen wie jedes andere Objekt in Ihrem System. Die folgenden Arten von VARA-Objekten sind verfügbar:

Als Administrator definieren Sie Systemeinstellungen, die festlegen, was passieren soll, wenn VARA-Objekte nicht aufgelöst werden können. Weitere Informationen finden Sie unter VARA_ERROR_ON_REPLACEMENT in UC_CLIENT_SETTINGS - Verschiedene Mandanteneinstellungen.

Vordefinierte VARA-Objekte für System- und Mandantenwerte

Ihr System enthält im Mandanten 0 vordefinierte VARA-Objekte, die System- und Mandantenwerte speichern. Diese Objekte steuern das Verhalten des Systems und der Mandanten. Der Zugriff auf diese Art von VARA-Objekten ist in der Regel auf Administratoren beschränkt.

VARA-Objekte, die systemweite Parameter enthalten, müssen im Mandanten 0 verbleiben.

VARA-Objekte, die das Verhalten von Mandanten und deren Prozessen steuern, können in den jeweiligen Mandanten gespeichert werden.

Weitere Informationen finden Sie unter Liste der VARA-Objekte für System- und Mandantenwerte.

Hinweis: In Job-Formularen können Sie keine vordefinierten VARA-Objekte verwenden.

Benutzerdefinierte VARA-Objekte

Als Entwickler und Objektdesigner erstellen Sie VARA-Objekte, um Werte zu speichern und zu verwenden. Ihre VARA-Objekte können Werte aus verschiedenen Quellen (Datenbanken, Verzeichnissen usw.) dynamisch abrufen. Sie können ihnen auch statische Werte zuweisen. Benutzerdefinierte VARA-Objekte werden bei der Installation nicht mitgeliefert. Ihr System enthält jedoch Vorlagen für verschiedene Typen benutzerdefinierter VARA-Objekte.

Verwenden Sie VARA-Objekte, um Objektkonfiguration von der Automatisierungslogik in Workflows, Aktionen und Action Packs zu trennen. Normalerweise benötigen Workflows Eingabeparameter für die Verarbeitung. Diese Parameter sind Konfigurationswerte wie Agenten, Anmeldeobjekte usw. Diese Werte können sich im Laufe der Zeit ändern, und sie können auch unterschiedlich sein, je nachdem, in welchem System Ihre Workflows ausgeführt werden (z. B. Entwicklung, Test oder Produktion).

Statt die Konfigurationswerte in allen Workflows und Systemen manuell zu ändern, können Sie diese Werte in Variablen (VARA-Objekten) speichern. Anschließend verweisen Sie in Ihren Workflows auf die VARA-Objekte. Es gibt verschiedene Möglichkeiten zum Verweisen auf VARAs in Workflows.

Weitere Informationen finden Sie unter Benutzerdefinierte VARA-Objekte.

Weitere Informationen zum effizienten Konfigurieren von Workflows mithilfe von VARA-Objekten finden Sie in diesem Video: Sehen Sie sich das Video an: Konfigurieren von Workflows mit VARA-Objekten

Virtuelle Agenten-VARA-Objekte

Agentenvariablen speichern Agenteninformationen und -einstellungen. Sie sind entweder im Mandant 0 oder in der Datenbank verfügbar. Eine Liste aller verfügbaren Agentenvariablen finden Sie unter Liste der Agentenvariablen.

Hinweis: Sie können keine Werte in Agentenvariablen per Script setzen.

Geben Sie als Administrator alle Agentenvariablen im Abschnitt [VARIABLES] der INI-Datei des Agenten an. Auf diese Weise stellen Sie sicher, dass die Variablenwerte entsprechend der Umgebung gesetzt werden.

Beispiel

[VARIABLES]
UC_HOST_CODE=UC_CODE
UC_HOST_JCL_VAR=NSK
UC_EX_PATH_BIN=$data01.uc4

UC_EX_PATH_CACHE=c:\AE11\agents\windows\CACHE\0100\
UC_EX_PATH_JOBREPORT=$data01.
UC_EX_JOB_MD=$data01.uc4.ucxjns1r

Verwenden Sie Script-Elemente wie GET_VAR, um Werte aus der Agentenvariable abzurufen.

Syntax

GET_VAR (Agenten-Variable, Agenten-Name)

Variablen

Es werden verschiedene Arten von Variablen verwendet, um Werte zu speichern und zu übergeben. Einige Variablen sind vordefiniert und können von Benutzern nicht gesetzt werden, während Sie andere frei erstellen können. Variablen werden bei der Generierung der Aufgabe aufgelöst. Im Gegensatz zu VARA-Objekten werden Variablen in Scripts gespeichert und sind keine eigenständigen Objekte.

Vordefinierte Variablen

Vordefinierte Systemvariablen haben immer denselben Wert für den gesamten Mandanten oder das gesamte Automation Engine-System. Auf sie kann von allen Aufgaben aus zugegriffen werden. Die folgenden Typen vordefinierter Variablen sind verfügbar:

Sie können diese vordefinierten Variablen in Scripts und Objektdefinitionen verwenden. In Scripts werden Variablen aufgelöst und durch Werte ersetzt, wenn das Script verarbeitet wird. In Objektdefinitionen werden die Werte dieser Variablen nach der Verarbeitung des Scripts ersetzt. Sie können vordefinierte Variablen verwenden, um Objektattribute zu modifizieren.

Vordefinierte Variablen werden im Script-Editor blau dargestellt.

Hinweise:

Weitere Informationen finden Sie unter Variablen für System- und Objektwerte.

Script-Variablen

Script-Variablen spielen eine grundlegende Rolle beim Schreiben von Scripts. Erstellen Sie sie, um Werte in den Scripts zu speichern und zu übergeben, die Sie auf den Prozess-Seiten von ausführbaren Objekten definieren. Sie können auch einige Objekteigenschaften mit Script-Variablen definieren.

Script-Variablen können nur Text enthalten. Ihre Werte dürfen nicht mehrere Zeilen enthalten. Als Arrays deklarierte Variablen können mehrere Werte enthalten.

Sie verwenden Script-Anweisungen wie :SET, :PSET oder :RSET, um Script-Variablen zu setzen und zu deklarieren, und um einer Script-Variablen Werte zuzuweisen. Sie verwenden :DEFINE, um die Variable als ein Array zu definieren. Mit GET_SCRIPT_VAR und :SET_SCRIPT_VAR setzen und lesen Sie die Werte von Script-Variablen per indirekter Referenz.

Script-Variablen werden im Script-Editor violett dargestellt.

Beispiele

Einer Script-Variablen wird ein numerischer Wert zugewiesen:

:SET&NUMBER# = 1

Der Wert einer Script-Variablen wird einer anderen Variablen zugewiesen:

:SET&NR# = &NUMBER#

Weitere Informationen finden Sie hier:

Objektvariablen

Objektvariablen rufen Werte aus Objekteigenschaften ab (Werte in den Eingabefeldern), oder aus der Laufzeitinstanz des Objekts (der Aufgabe). Sie definieren Objektvariablen auf der Seite "Variablen" ausführbarer Objekte. Alternativ können Sie die Script-Anweisung :PSET auf den Prozess-Seiten verwenden. Diese Objektvariablen werden in der Objektdefinition gespeichert. Child-Aufgaben können Objektvariablen von Parent-Objekten erben.

Objektvariablen können mehrzeiligen Text enthalten. Sie werden im Script-Editor violett dargestellt.

Weitere Informationen finden Sie hier:

PromptSet-Variablen

Wenn Sie in einem PromptSet Werte definiert haben, werden diese Werte als PromptSet-Variablen gespeichert. Wenn das PromptSet einem Objekt zugewiesen wird, werden diese Werte während der Ausführung verwendet. Sie können jedoch auf eine der folgenden Arten überschrieben werden:

Der Typ der Daten, die PromptSet-Variablen enthalten können, hängt vom Elementtyp im PromptSet ab, in dem sie definiert wurden. Nachdem eine PromptSet-Variable definiert wurde, ist der Wert schreibgeschützt und kann nicht geändert werden.

PromptSet-Variablen können auch mit: :READ-Anweisungen in Scripts definiert werden. Sie werden im Script-Editor violett dargestellt.

Weitere Informationen finden Sie hier:

Variablen im Read-Buffer ablegen

Der Read-Buffer speichert Werte temporär, damit andere Aufgaben sie verwenden können. Diese Werte werden gelöscht, nachdem sie verbraucht wurden. Wenn ein Prozess mehrere Aufgaben enthält, speichern die Read-Buffer-Variablen ihre Werte in chronologischer Reihenfolge. Diese Werte werden auch in chronologischer Reihenfolge verwendet. Beispielsweise werden in einem Prozess mit drei Aufgaben die Werte bei der ersten Verwendung der Funktion ACTIVATE_UC_OBJECT durch die erste verwendete Aufgabe gespeichert.

Verwenden Sie Script-Anweisungen, um Werte von Script-Variablen oder PromptSet-Variablen im Read-Buffer zu speichern, wenn Sie ein Objekt über ein Script mithilfe von ACTIVATE_UC_OBJECT aktivieren.

Ihr System beinhaltet vordefinierte Variablen (UC_CAUSE*-Variablen), die Details einer Aufgabe abrufen und die Werte im Read-Buffer zwischenspeichern. Werte werden im Read-Buffer gespeichert, wenn Sie Folge- oder Alternativ-Aktionen (die Ausführung eines anderen Objekts) angeben, falls eine Bedingung oder ein Status nicht erfüllt ist.

Weitere Informationen finden Sie hier:

Variablennamen

Variablennamen haben die folgende Syntax:

Beispiele:

Werte abrufen

In ausführbaren Objekten rufen Sie Werte aus Variablen und VARA-Objekten wie folgt ab:

Objektattribute mit Werten aus VARA-Objekten definieren

Geben Sie in das Eingabefeld, in dem Sie das VARA-Objekt verwenden möchten, den Namen in geschweiften Klammern ein. Geben Sie optional Schlüssel- und Spaltenparameter an, um einen bestimmten Wert im VARA-Objekt auszuwählen.

Syntax

{ Variablenobjekt [, Schlüssel [, Spaltennummer ]] }.

Beispiel

Der folgende Ausdruck wird bei der Generierung der Aufgabe durch einen Wert aus einem VARA-Objekt ersetzt:

{MONITOR_SP1, 2, 3}

wobei

Die Parameter Schlüssel und Spalte sind optional. Wenn Sie die Parameter nicht angeben, wählt das System den Wert je nach Typ des VARA-Objekts wie folgt aus.

Werte aus Variablen und VARA-Objekten in Scripts abrufen

Rufen Sie in Scripts Werte aus Variablen und VARA-Objekten auf die folgende Weise ab:

Siehe auch: