Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > PREP_PROCESS_VAR_XML

PREP_PROCESS_VAR_XML

Script-Funktion: Ermittelt mit Auswahlkriterien eine Liste von Werten eines XML-Variablenobjektes und stellt diese als interne Auflistung (Datensequenz) für die weitere Verarbeitung zur Verfügung.

Syntax

PREP_PROCESS_VAR_XML(Variable, Key, Value)

Syntax	Beschreibung/Format
Variable	Name des Variablen-Objektes, dessen Werte ausgelesen werden sollen. Format: AE-Name, Script-Literal oder Script-Variable
Key	Filter für die Spalte Key. Format: Script-Literal oder Script-Variable Bei dynamischen Variablen ist die Key-Spalte immer die erste Wertespalte. Die Result-Spalte wird erst nach der Ermittlung der Variableneinträge gebildet.
Wert	Filter für den Wert. Format: Script-Literal oder Script-Variable Format für Variablen-Objekt XML: XPath (Format: Zeichenkette) Maximal 64 Zeichen. Standardwert: "" Die Wildcardzeichen "" und "?" können verwendet werden. "*" steht dabei für beliebige, "?" für genau ein Zeichen. Das Format des Variablen-Objekts XML muss für beide Script-Funktionen identisch sein.

Syntax

Beschreibung/Format

Variable

Name des Variablen-Objektes, dessen Werte ausgelesen werden sollen.
Format: AE-Name, Script-Literal oder Script-Variable

Key

Filter für die Spalte Key.
Format: Script-Literal oder Script-Variable

Bei dynamischen Variablen ist die Key-Spalte immer die erste Wertespalte. Die Result-Spalte wird erst nach der Ermittlung der Variableneinträge gebildet.

Wert

Filter für den Wert.
Format: Script-Literal oder Script-Variable
Format für Variablen-Objekt XML: XPath (Format: Zeichenkette)
Maximal 64 Zeichen.
Standardwert: "*"

Die Wildcardzeichen "*" und "?" können verwendet werden. "*" steht dabei für beliebige, "?" für genau ein Zeichen.

Das Format des Variablen-Objekts XML muss für beide Script-Funktionen identisch sein.

Rückgabewert
Referenz auf die Datensequenz des Variablen-Objektes.

Kommentare

Die Skript-Funktion liest die Werte eines XML Variablen-Objektes. Dabei können die ausgelesenen Werte durch die Parameter Key und Wert eingeschränkt werden. Groß- und Kleinschreibung wird beachtet!

Wert bezieht sich auf den Inhalt einer Werte-Spalte. Mit Spalte legen Sie dabei die Nummer jener Werte-Spalte fest, die durchsucht werden soll. Wird keine Spalte angegeben, so wird automatisch die erste Werte-Spalte verwendet. Statische Variablen besitzen 5 Werte-Spalten. Die Spalten-Anzahl von dynamischen Variablen ist nicht begrenzt und richtet sich nach der Datenquelle bzw. den Einstellungen im Variablen-Objekt.

Die Script-Funktion PREP_PROCESS_VAR_XML darf nur mit dem Variablen-Objekt XML verwendet werden, das nur eine Werte-Spalte liefert.

Der Rückgabewert der Script-Funktion ist eine Datensequenz-Referenz. Sie wird den Script-Anweisungen :PROCESS und :ENDPROCESS als Startparameter übergeben. In Kombination mit der Script-Funktion GET_PROCESS_LINE kann nun auf jede einzelne Zeile des Variablen-Objektes zugegriffen werden.

Enthält das Variablen-Objekt die gesuchten Werte nicht, führt das zu keiner Fehlermeldung. Die Bearbeitung der Datensequenz, definiert zwischen :PROCESS und :ENDPROCESS, wird einfach nicht durchlaufen.

Namen von VARA-Objekten, die eine Variable enthalten, müssen in Anführungszeichen angegeben werden, sonst wird eine Fehlermeldung ausgegeben.

Der Script-Variable, welche die Datensequenz-Referenz enthält, kann kein neuer Wert zugewiesen werden. Erst wenn Sie die Datensequenz mit der Script-Anweisung :CLOSE_PROCESS explizit verwerfen, kann die Variable erneut verwendet werden.

Beispiel

In diesem Beispiel werden die Werte der Datensequenzzeilen, repräsentiert durch &VALUE# und &GB#, gelesen. Dies führt zur Rückgabe der "A/B"-Werte des Keys "KEY01" des Variablen-Objektes XML, genannt "VARA.XML":

:SET &HND# = PREP_PROCESS_VAR_XML(VARA.XML, "KEY01", "A/B")
:PROCESS &HND#
: SET &GB# = GET_PROCESS_LINE(&HND#,1)
: SET &VALUE# = GET_PROCESS_LINE(&HND#,2)
: PRINT "&GB# &WERT#"
:ENDPROCESS

Siehe auch:

Script-Sprachmittel	Beschreibung
:CLOSE_PROCESS	Verwirft eine Datensequenz innerhalb eines Scripts.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.
PREP_PROCESS_VAR	Ermittelt mit Auswahlkriterien eine Liste von Werten eines Variablenobjektes und stellt diese als interne Auflistung (Datensequenz) für die weitere Verarbeitung zur Verfügung.

Script-Sprachmittel - Datensequenzen

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support