XML-VARA-Objekte 

Sie speichern komplexe Daten als XML-Strukturen in VARA-Objekten vom Typ XML. Über das VARA-Objekt vom Typ XML können Sie diese Daten dann in PromptSet-Objekten, in Script-Objekten und in anderen Script-Kontexten systemweit referenzieren und verwenden. XML VARA-Objekte können eine beliebige Anzahl von Schlüsseln enthalten. Der Wert für jeden Schlüssel ist eine strukturierte XML-Datei.

XML VARA-Objekte ermöglicht es Ihnen, eine Liste von Werten für Variablenobjekte abzurufen. Verwenden Sie die Script-Funktionen PREP_PROCESS_VAR und PREP_PROCESS_VAR_XML, um auf alle oder mehrere bestimmte Einträge einer Variablen zuzugreifen. Diese bereitet die Bearbeitung einer Datensequenz vor.

Sie können XPath-Ausdrücke mit den XML VARA-Objekten verwenden. Je nach Datenbank verhalten sich einzelne XPath-Ausdrücke möglicherweise unterschiedlich. Wenden Sie sich in solchen Situationen an den Anbieter der Datenbank.

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.

Script-Elemente für XML VARA-Objekte

Sie können die folgenden Script-Elemente verwenden, um Werte im VARA-Objekt zu speichern:

• :PUT_VAR speichert Werte
• :PUT_VAR_COL speichert einen Wert in einer bestimmten Spalte
• :DELETE_VAR löscht einen oder alle Werte

Einschränkungen für XML-VARA-Objekte

• Bei einer Oracle-Datenbank dürfen die Attributwerte von 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.

Wie alle anderen Objekte haben XML-VARA-Objekte mehrere verschiedene Definitionsseiten. Allgemein, Versionsmanagement und Dokumentation existieren für alle Objekte. Hier werden die Seiten Variablen und "Kommandos" beschrieben, die für XML-VARA-Objekten spezifisch sind.

So definieren Sie ein VARA-Objekt vom Typ XML

1. Fügen Sie auf der Seite Variablen die Schlüssel und Werte des VARA-Objekts vom Typ XML hinzu.

   1. Verwenden Sie die Schaltflächen in der Symbolleiste, um Schlüssel hinzuzufügen, zu bearbeiten, zu duplizieren und zu entfernen.

   2. Geben Sie im Editor die XML-Struktur für diesen Schlüssel im Bereich auf der rechten Seite ein.

      Beispiel:

      Ein XML VARA-Objekt namens SRV.VARA.XML verfügt über einen Schlüssel, der als SERVER NAMES mit dem folgenden Wert aufgerufen wird:

      <SERVERS>

          <SERVER NAME="TestServer1">

              <IP>192.168.0.1</IP>

          </SERVER>

          <SERVER NAME="TestServer2">

              <IP>192.168.0.2</IP>

          </SERVER>

      </SERVERS>

      Um die einzelnen Werte aus der XML-Datei zu lesen, verwenden Sie die Script-Funktion GET_VAR mit XQUERY-Ausdrücken:

      :set &name# = GET_VAR('HAM.VARA.XML','TESTSERVER','/SERVERS/SERVER[1]/@NAME')

      :set &ip# = GET_VAR('HAM.VARA.XML','TESTSERVER','/SERVERS/SERVER[1]/IP/text()')

      :p &name# &ip#

      Die Ausgabe sieht wie folgt aus:

      U00020408 TestServer1 192.168.0.1

2. Definieren Sie auf der Seite Attribute Folgendes:

   1. Wählen Sie unter Variableneinstellungen den Gültigkeitsbereich der Variablen aus.

      Normalerweise muss der Schlüssel als Parameter im Script-Element :PUT_VAR oder GET_VAR angegeben werden. Dadurch wird es jedoch schwieriger, sicherzustellen, dass die Werte mit eindeutigen Schlüsseln gespeichert sind. Geben Sie einen bestimmten Gültigkeitsbereich an, um die Erstellung von Scripts zu vereinfachen, die in ein VARA-Objekt schreiben oder dieses auslesen.

      Der Schlüssel ist optional für alle Werte des Bereichs, mit Ausnahme der Option Frei gewählt. 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 Schlüssels ist optional.

        Standardschlüssel, wenn keiner angegeben ist: *

      • Frei gewählt

        Die Angabe eines Schlüssels ist erforderlich. Laufzeitfehler U00003712 tritt auf, wenn der Schlüssel fehlt.

        Standardschlüssel, wenn keiner angegeben ist: N/A

        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 Schlüssels ist optional.

        Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des Agenten, auf dem die Aufgabe ausgeführt wird.

      • Aufgabe - je Aufgabenname

        Die Angabe eines Schlüssels ist optional.

        Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des laufenden ausführbaren Objekts.

      • Workflow-Name - jeder Workflow-Name

        Die Angabe eines Schlüssels ist optional.

        Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des übergeordneten Workflows, in dem die Aufgabe ausgeführt wird.

      • Workflow-Session - je Workflow-Session

        Die Angabe eines Schlüssels ist optional.

        Standardschlüssel, wenn kein Schlüssel angegeben ist: Die RunID des übergeordneten Workflows, in dem die Aufgabe ausgeführt wird.

      • Benutzer - je Benutzer-Name

        Die Angabe eines Schlüssels ist optional.

        Standardschlüssel, wenn kein Wert angegeben ist: Der Name des ausführenden Benutzers

        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 Benutzer-Session

        Die Angabe eines Schlüssels ist optional

        Standardschlüssel, wenn kein Schlüssel angegeben wird: Die RunID der Benutzer-Session. Der Eintrag (die Zeile) für die Benutzer-Session wird gelöscht, sobald die Benutzer-Session beendet wird.

      Tipp:

      Die beiden nützlichsten Bereiche sind Benutzer-Session - je Benutzersitzung und Workflow-Session - je Workflow-Aktivierung. Ist bei diesen beiden Bereichen kein Standardschlüssel 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 Benutzer-Session setzen und Werte in das VARA-Objekt eingeben, ohne, wie hier dargestellt, einen Schlüssel 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 Schlüssel 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:

      • Schlüssel 1168010
      • Wert 1 Merkur
      • Wert 2 Venus
      • Wert 3 Erde
      • Wert 4 Mars
      • Wert 5 Jupiter

      1168010 ist die ID der Benutzer-Session. Diese IDs sind unter Benutzer in der Administration-Perspektive 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 Schlüssel), wird automatisch entfernt, sobald der ausführende Workflow deaktiviert ist.

   2. Alle VARA-Objekte haben den Abschnitt Script-Zugriff auf ihren Definitionsseiten, der die Fehlerbehandlung festlegt, wenn Scripts das VARA-Objekt lesen. In diesem Bereich entscheiden Sie, was passieren soll, wenn Scripts auf das VARA-Objekt zugreifen und der Schlüssel, auf den sie verweisen, nicht verfügbar ist.

      Folgende Optionen stehen zur Verfügung:

      • Fehler zurückliefern

        Das Script wird nicht ordnungsgemäß beendet, und auf der Meldungen-Konsole wird eine Laufzeitfehlermeldung angezeigt.

      • Anfangswerte zurückgeben (Standard)

        Das Script wird weiterhin ausgeführt, obwohl der Schlüssel nicht verfügbar ist. Es wird kein Laufzeitfehler angezeigt. Der Report enthält einen leeren String, woran zu erkennen ist, dass kein Schlüssel gefunden wurde.

        Tipp: Stellen Sie sicher, dass die Schlüssel von VARA-Objekten immer einen Wert zurückgeben, wenn Sie diese Option verwenden möchten.

   3. Speichern Sie das Objekt.