XPath Iterator | X4Documentation

Der Adapter selektiert eine Knotengruppe, einen Knoten oder Knoteninhalt über einen XPath-Ausdruck in einem Input-XML-Dokument und gibt je nach Ausdruck eine Knotengruppe als XML-Dokument oder die Werte als Text-Dokument aus. Der Adapter kann dabei alle zutreffenden Knoten durchlaufen und die Ergebnisse nacheinander ausgeben (ForEach-Schleife) oder das Ergebnis des ersten Treffers ausgeben.

Wenn Sie innerhalb eines Prozess-Kontextes mehrere XPath Iteratoren definieren, dann vergeben Sie in Parameter Id eine eindeutige ID für den jeweiligen Adapter, z.B. 1001, 1002 etc. So wird für das Selektieren im forEach-Modus und für das Zurücksetzen eines Iterators gewährleistet, dass nur der XPath Iterator mit der entsprechenden ID angesprochen wird (siehe Operation Clear).

Wird in Parameter Id der Standardwert 0 belassen, dann wird die Nummer des Prozess-Schritts (Action ID) im aktuellen Prozess als ID verwendet. Diese ID ist möglicherweise nicht eindeutig, wenn sich in einem Subprozess ein XPath Iterator mit der gleichen Action-ID befindet.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

Select: XPath-Ausdruck auf das Input-XML-Dokument anwenden und Ergebnis-Dokument ausgeben (Parameter Id beachten)
Clear: Iterator eines XPath Iterators zurücksetzen, der dieselbe ID besitzt wie der gewünschte XPath Iterator mit der Operation Select (siehe Parameter Id)

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter. xpathselector.XPathSelector`: Hauptklasse (Standard)
XPath	XPath-Ausdruck, der auf das Input-XML-Dokument angewandt wird Mögliche Werte: Beliebiger XPath-Ausdruck (z.B. `/Element[@att="Value"]/text()`)
forEach	Den ersten oder alle zutreffenden Knoten selektieren Mögliche Werte: ja: Alle selektierten Knoten nacheinander durchlaufen und jeweils ein Dokument ausgeben (nützlich in Kombination mit einem Condition-Prozessbaustein) (Standard) nein: Ersten Treffer ausgeben
Id	Eindeutige ID des XPath Iterator-Bausteins innerhalb des Prozess-Kontextes bzw. der Prozess-Instanz (wenn Sie mehrere voneinander unabhängig iterierende XPath Iterator Adapter in demselben Prozess-Kontext verwenden möchten) Mögliche Werte: `0`: Aktuelle Action-ID (Nummer des Prozess-Schritts des XPath Iterators im aktuellen Prozess) als ID verwenden; Beachten Sie hierbei, dass ein XPath Iterator in einem Subprozess die gleiche Action-ID besitzen könnte (Standard) Beliebige ganze Zahl außer `0`, um den jeweiligen XPath Iterator-Baustein innerhalb des Prozess-Kontextes eindeutig zu kennzeichnen; Empfehlung: einen Wert `>1000` verwenden, um nicht zufällig eine bereits bestehende Action-ID zu "erwischen"

Statuswerte

-1 (error)	Fehler bei der Ausführung des Adapters (Details siehe Server-Log)
0 (empty)	Der Adapter gibt keine Daten (mehr) aus. Dieser Status kann im Iterator-Modus als Abbruchbedingung einer Schleife im Technical Process ausgewertet werden und gibt an, dass keine weiteren Datensätze verfügbar sind.
1 (successful)	Der Adapter gibt ein Ergebnis aus. Dieser Status kann im Iterator-Modus als Schleifeneintrittsbedingung im Technical Process ausgewertet werden und gibt an, dass ein weiterer Datensatz verfügbar ist.