XML-VARA-Objekte speichern einen Wert für einen oder mehrere Keys. Ihre Daten müssen eine wohlgeformte XML-Struktur haben. Diese Art von Objekt kann dazu genutzt werden, um komplexe Daten vorübergehend als XML-Strukturen im CA Automic Workload Automation-System zu speichern. Diese Daten können referenziert und in PromptSet-Objekten, Script-Objekten und anderen Script-Kontexten systemweit verwendet werden.
Ein XML-VARA-Objekt ermöglicht es Ihnen, eine Liste von Werten für Variablenobjekte abzurufen. Möchten Sie auf alle bzw. mehrere bestimmte Einträge einer Variablen zugreifen, können Sie von der Script-Funktion PREP_PROCESS_VAR_XML Gebrauch machen. Diese bereitet die Bearbeitung einer Datensequenz vor.
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.
Dieses Thema beinhaltet Folgendes:
Wichtige Überlegungen zur Datenbank
Es ist möglich, XPath-Ausdrücke gemeinsam mit dem XML-Variablenobjekt zu verwenden, wie in den einzelnen Abschnitten der jeweiligen Script-Funktionen beschrieben. Abhängig von der Datenbank, mit der das CA Automic Workload Automation-System verwendet wird, können einzelne XPath-Ausdrücke unterschiedlich funktionieren. Wenden Sie sich in diesem Fall an den Datenbankhersteller.
Wenn Sie CA Automic Workload Automation mit einer Oracle-Datenbank verwenden, sollten die Attributwerte der in diesem VARA-Objekt verwendeten XML-Daten nicht mehr als 4000 Zeichen enthalten.
XML-Daten können nur eine Zeichenkodierung verwenden, die mit der Zeichenkodierung in der Datenbankverbindung kompatibel ist.
-
Typ
Schreibgeschützt, immer STATIC.
-
Gültigkeitsbereich
Diese Einstellung dient dazu, das Script zu vereinfachen, mit dem Werte in das VARA-Objekt geschrieben oder aus diesem gelesen werden sollen.
Normalerweise muss der Key als Parameter im Script-Sprachmittel :PUT_VAR oder GET_VAR angegeben werden. Dadurch wird es jedoch schwieriger, sicherzustellen, dass die Werte mit eindeutigen Keys gespeichert sind. Mit Angabe eines bestimmten Gültigkeitsbereichs können Sie die Erstellung von Scripts vereinfachen, die in ein VARA-Objekt schreiben oder dieses auslesen.
Bei allen Werten für den Gültigkeitsbereich außer Frei gewählt ist der Key optional. Welcher Standard-Key für den Zugriff auf das VARA-Objekt verwendet wird, wenn kein Key angegeben ist, hängt von den Eigenschaften der Aufgabe ab, die auf das Objekt zugreift.
Folgende Optionen stehen zur Verfügung:
-
Kein Gültigkeitsbereich
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: *
-
Frei gewählt
Die Angabe eines Key ist erforderlich.
Standard-Key, wenn keiner angegeben ist: N/A. Da ein Key erforderlich ist, tritt Laufzeitfehler U00003712 auf, wenn kein Key spezifiziert ist.
Hat das VARA-Objekt den Bereich Frei gewählt, müssen Sie den Key beim Schreiben oder Lesen aus dem VARA-Objekt angeben.
Beispiel:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, &$USER#, "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Host - je Host-Name:
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des Agenten, auf dem die Aufgabe läuft.
-
Aufgabe - je Aufgabenname
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des laufenden ausführbaren Objekts.
-
Workflow-Name - je Workflow-Name
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Der Name des Parent-Workflows, innerhalb dessen die Aufgabe ausgeführt wird.
-
Workflow-Session - je Workflow-Aktivierung
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Die RunID des Parent-Workflows, innerhalb dessen die Aufgabe ausgeführt wird.
-
Benutzer - je Benutzer-Name
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des ausführenden Benutzers.
Hat das VARA-Objekt den Bereich Benutzer - je Benutzer-Name, müssen Sie den Key bei Zugriff auf das VARA-Objekt nicht angeben.
Beispiel:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Benutzer-Session - je Benutzersitzung
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Die RunID der Benutzer-Session. Der Eintrag (die Zeile) für die Benutzer-Session wird gelöscht, sobald die Benutzer-Session beendet wird.
Die beiden nützlichsten Bereiche sind Benutzer-Session - je Benutzersitzung und Workflow-Session - je Workflow-Aktivierung. Ist bei diesen beiden Bereichen kein Standard-Key angegeben, wird die Session-ID des Benutzers bzw. die RunID des Workflows verwendet. Bei diesen beiden Bereichen werden zudem die Zeilen gelöscht, wenn die entsprechende RunID deaktiviert wird.
Beispiel:
Sie möchten einige Informationen in einem VARA-Objekt speichern, solange ein Benutzer angemeldet ist, diese jedoch entfernen, wenn sich der Benutzer abmeldet. Sie können den Bereich des VARA-Objekts auf Benutzer-Session - je Benutzersitzung setzen und Werte in das VARA-Objekt eingeben, ohne, wie hier dargestellt, einen Key anzugeben:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERSESSION"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
Der Key zum Schreiben der Werte ist die Session-ID des Benutzers, der das Script ausführt. In diesem Beispiel wurde dem VARA-Objekt beim Ausführen des Scripts die folgende Zeile hinzugefügt:
Key 1168010
Wert 1 Merkur
Wert 2 Venus
Wert 3 Erde
Wert 4 Mars
Wert 5 Jupiter
1168010 ist die ID der Benutzer-Session. Session-IDs der Benutzer sind in der Perspektive „Administration“ unter Benutzer sichtbar. Sobald sich der Benutzer abmeldet, wird diese Zeile aus dem VARA-Objekt entfernt.
Der Bereich Workflow-Session - je Workflow-Aktivierung funktioniert auf ähnliche Weise. Jede Zeile, die in ein solches VARA-Objekt geschrieben wird (ohne einen angegebenen Key), wird automatisch entfernt, sobald der ausführende Workflow deaktiviert ist.
-
Siehe auch: