X4 Help Center

COBOL Copybook Reader

Dieser Adapter liest ein Textdokument im COBOL Copybook-Format, parst es gemäß den Regeln der Deskriptordatei und gibt ein XML-Dokument aus.

Zeichen, die keine gültigen XML-Zeichen sind, werden durch den Unicode Replacement Character #xFFFD ersetzt. Gültige XML-Zeichen sind folgende Unicode-Zeichen:

  • #x9

  • #xA

  • #xD

  • #x20#xD7FF

  • #xE000#xFFFD

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

Execute: Textdokument im COBOL Copybook-Format einlesen

Parameter

DescFile

Erforderlich

Name der Deskriptordatei, die das Textdokument im COBOL Copybook-Format in seiner Datenstruktur beschreibt. Die Deskriptordatei sollte im Benutzerordner des X4 Repositorys abgelegt sein (z. B. X4DB/1/Project/Descr.ad). Mehrere Deskriptordateien können durch ein Semikolon getrennt werden.

Mögliche Werte:

Pfad und Dateiname mit dem Suffix .ad oder .xml (z. B. /Project/Descr.ad)

Strict

Bestimmt, ob der Datenstrom aus dem vorangehenden Prozess-Schritt entsprechend lang sein muss, um die vollständige Struktur zu lesen

Mögliche Werte:

  • true: Vollständige Struktur muss gelesen werden

  • false: Datenstrom kann beliebig lang sein (Standard)

encoding

Legt die Zeichencodierung des eingelesenen Dokuments im Cobol Copybook-Format fest.

Mögliche Werte:

Beliebiger gültiger Java-Zeichensatz, wie z. B.:

  • windows-1252 – Western European (ANSI)

  • ISO-8859-1 – Latin-1

  • IBM437 – OEM US (DOS)

  • UTF-8 – Unicode

Verhalten:

  • Codierung angegeben: Der Adapter verwendet die angegebene Codierung, um die Eingabedaten zu interpretieren – unabhängig von den im Dokument hinterlegten Codierungsinformationen.

  • Keine Kodierung angegeben: Der Adapter greift auf die Standardcodierung der JVM zurück (Charset.defaultCharset()). Dieses Verhalten entspricht dem des COBOL Copybook Writer Adapters. Zusätzlich wird eine Warnung protokolliert, die angibt, welche Systemcodierung verwendet wird.

Wann sollten Sie diesen Parameter verwenden?

  • Wenn Sie Dateien mit ANSI-/Windows-1252- oder anderen Nicht-UTF-8-Codierungen verarbeiten

  • Wenn Sonderzeichen (z. B. ä, ö, ü, ß) in der Ausgabe falsch dargestellt werden

  • Wenn die Eingabedatei aus einem System mit einer spezifischen Zeichencodierung stammt