X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

XML Iterator

Der Adapter liest ein XML-Dokument von einer beliebigen gültigen URL schrittweise in einen Technical Process ein und gibt bei jeder Iteration ein Kindelement (inklusive sämtlicher Kindknoten) des Wurzel-Elements als XML-Dokument aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

  • Iterate: Kindknoten des Wurzel-Elements einlesen

  • Clear: Iterator eines XML Iterators zurücksetzen, der dieselbe ID besitzt wie der gewünschte XML Iterator mit der Operation Iterate (siehe Parameter id)


Nach Aufruf der Iterate Operation sollten Sie die Clear Operation aufrufen, um Ressourcenlecks zu vermeiden. 

Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte: de.softproject.integration.adapter.xmliterator.XmlIterator: Hauptklasse (Standard)

url

URL zum einzulesenden XML-Dokument

Mögliche Werte:

  • Beliebige gültige URL (z.B. xstore://Project/Folder/File.xml)

  • URL zu einem UNC-Netzlaufwerk (z.B. file://///storage/share_data/Folder/File.xml)

id

Eindeutige ID des XML Iterator-Bausteins innerhalb des Prozess-Kontextes bzw. der Prozess-Instanz (wenn Sie mehrere voneinander unabhängig iterierende XML Iterator Adapter in demselben Prozess-Kontext verwenden möchten)

Mögliche Werte:

  • 0 : Aktuelle Action-ID (Nummer des Prozess-Schritts des XML Iterator Adapters im aktuellen Prozess) als ID verwenden; Beachten Sie hierbei, dass ein XML Iterator Adapter in einem Subprozess die gleiche Action-ID besitzen könnte (Standard)

  • Beliebige ganze Zahl außer 0, um den jeweiligen XML 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-Protokoll)

0 (empty)

Der Adapter gibt keine Daten (mehr) aus. Dieser Status kann 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 als Schleifeneintrittsbedingung im Technical Process ausgewertet werden und gibt an, dass ein weiterer Datensatz verfügbar ist.