Text to Lines Converter

Dieser Adapter liest alle Zeilen eines Textdokuments oder bestimmte Zeilen ein und gibt ein XML-Dokument aus, das für jede Zeile ein XML-Element enthält.

Als Input verwendet der Adapter ein Textdokument aus dem vorhergehenden Prozess-Schritt. Mit der Operation Iterate kann der Adapter das Input-Dokument schrittweise durchlaufen und für jede Iteration im Technical Process wird ein Ergebnis-Dokument ausgegeben.

Hinweis:

Wenn Sie innerhalb eines Prozesskontextes mehrere Text to Lines Converter definieren, dann vergeben Sie im Parameter id eine eindeutige ID für den jeweiligen Adapter, z. B. 1001, 1002 etc. So wird für das Selektieren im Iterator-Modus und für das Zurücksetzen eines Iterators sichergestellt, dass nur der Text to Lines Converter Adapter mit der entsprechenden ID angesprochen wird (siehe Operation Clear).
Das gilt auch, wenn Sie innerhalb eines Prozesskontexts einen oder mehrere Text to Lines Converter und einen oder mehrere Text to Lines Converter from URL verwenden.
Wenn Sie im Parameter id den Standardwert 0 belassen, dann wird eine zufällige ID generiert, die im aktuellen Prozess als ID verwendet wird. Diese ID ist möglicherweise nicht eindeutig, wenn sich in einem Subprozess ein Text to Lines Converter mit der gleichen ID befindet.
Daher empfehlen wir, immer eine id ungleich 0 zu setzen.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

Parse: Zeilen des Textdokuments einlesen
Iterate: Iterator-Modus aktivieren und Textdokument zeilenweise einlesen
Clear: Iterator eines Text to Lines Converter Adapters zurücksetzen, der dieselbe ID besitzt wie der gewünschte Text to Lines Converter Adapter mit der Operation Iterate (siehe Parameter id)

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter. text2lines.TextToLinesAdapter`: Hauptklasse (Standard)
start	Erste Zeile, die eingelesen werden soll (Zählweise beginnt bei 0) Mögliche Werte: Beliebige ganze Zahl `0`: Ab einschließlich der ersten Zeile einlesen (Standard)
count	Anzahl der Zeilen, die eingelesen werden sollen Hinweis: Bei der Operation `Iterate` werden die Zeilen pro Durchgang eingelesen. Mögliche Werte: Beliebige positive ganze Zahl `0`: Keine Beschränkung, d. h. alle Zeilen auf einmal einlesen (Standard)
id	Eindeutige ID des Text to Lines Converter Adapter -Bausteins innerhalb des Prozess-Kontextes bzw. der Prozess-Instanz (wenn Sie mehrere voneinander unabhängig iterierende Text to Lines Converter Adapter in demselben Prozess-Kontext verwenden möchten) Mögliche Werte: `0`: Aktuelle Action-ID (Nummer des Prozess-Schritts) als ID verwenden; Beachten Sie hierbei, dass ein Text to Lines Converter Adapter in einem Subprozess die gleiche Action-ID besitzen könnte. (Standard) Beliebige ganze Zahl außer `0`, um den jeweiligen Text to Lines Converter Adapter -Baustein innerhalb des Prozess-Kontextes eindeutig zu kennzeichnen; Empfehlung: einen Wert `>1000` verwenden, um nicht zufällig eine bereits bestehende Action-ID zu "erwischen"

Ausgabe

Dieser Adapter gibt ein UTF-8-kodiertes XML-Dokument mit folgender Struktur aus. Für jede Zeile wird ein XML-Element <Line/> erzeugt, das die Zeilennummer und den Inhalt der jeweiligen Zeile enthält:

HTML/XML

<Text>
  <Line lineNo="Zeilennummer"><!--Inhalt der Zeile--></Line>
</Text>

Statuswerte

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