Text to Lines Converter from URL

Dieser Adapter liest Zeilen eines Textdokuments von einer beliebigen gültigen URL ein und gibt ein XML-Dokument aus, das die gewünschten Zeilen enthält. 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 from URL 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 from URL und einen oder mehrere Text to Lines Converter 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: Gesamtes Textdokument einlesen
Iterate: Iterator-Modus aktivieren und Textdokument zeilenweise einlesen
Clear: Iterator eines Text to Lines Converter from URL Adapters zurücksetzen, der dieselbe ID besitzt wie der gewünschte Text to Lines Converter from URL mit der Operation Parse (siehe Parameter id)

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter. text2lines.TextToLinesUrlAdapter`: 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 from URL-Bausteins innerhalb des Prozess-Kontextes bzw. der Prozess-Instanz (wenn Sie mehrere voneinander unabhängig iterierende Text to Lines Converter from URL 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 from URL in einem Subprozess die gleiche Action-ID besitzen könnte. (Standard) Beliebige ganze Zahl außer `0`, um den jeweiligen Text to Lines Converter from URL-Baustein innerhalb des Prozess-Kontextes eindeutig zu kennzeichnen; Empfehlung: einen Wert `>1000` verwenden, um nicht zufällig eine bereits bestehende Action-ID zu "erwischen"
url	URL zum einzulesenden Textdokument Mögliche Werte: Beliebige gültige URL (z.B. `xstore://Project/Folder/File.txt`)
encoding	Zeichenkodierung des Input-Textdokuments Mögliche Werte: Beliebige gültige Zeichenkodierung (z.B. `UTF-8`) `(leer)`: Standard-Zeichenkodierung des Systems verwenden

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>

Beispiel

Das Beispiel TextToLinesConverterFromURL.wrf für den Iterator-Modus sowie für den einfachen Einlesemodus finden Sie im Demosystem X4 Experience.

Statuswerte

-1	Fehler bei der Ausführung des Adapters (Details siehe Server-Log)
0	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	Der Adapter gibt ein Ergebnisdokument aus. Dieser Status kann im Iterator-Modus als Schleifeneintrittsbedingung im Technical Process ausgewertet werden und gibt an, dass ein weiterer Datensatz verfügbar ist.