XmlRootAdderPreparser

Gruppe

Preparser

Funktion

Dieser Preparser kann ein "künstliches" Root-Element um den Inhalt der empfangenen XML-Datei setzen.

Konfigurationsdatei

sample_XmlRootAdderPreparser.properties

Beschreibung


Dieser Preparser kann ein "künstliches" Root-Element um den Inhalt der empfangenen XML-Datei setzen. Er kann dazu verwendet werden ein XML-Dokument mit mehreren Root-Elementen in ein "wohlgeformtes" XML-Dokument zu wandeln. Dazu kann es nötig sein, dass der empfangene XML-Header vorher entfernt wird. Wenn kein Name für das Root-Element definiert ist, wird der Name RootElement verwendet. Im Ergebnis des Preparsers wird kein neuer XML-Header (<?xml …?>) erzeugt. Das Encoding, mit dem der Preparser arbeitet, richtet sich sowieso nach dem Profil-Encoding, nicht nach dem XML-Header.

Eine weitere Betriebsart des Preparsers erlaubt es, einen Header vor den empfangenen Text und/oder einen Footer hinter den Text zu setzen. Dabei handelt es sich nicht um XML-Tags, sondern beliebige Texte (die Tags sein können). Wenn ein Header, ein Footer, oder beide angegeben werden, wird das Root-Element nicht erzeugt, sondern der Header-Text mit abschließendem New Line vor und der Footer-Text hinter den empfangenen Text gesetzt.

Parameterbeschreibung


Parameter

Beschreibung

root.name

(optional) Name des zu erzeugenden Root-Elements. Default: RootElement

Wichtiger Hinweis: Dieser Parameter wird ignoriert, falls einer der Parameter insert.headline oder append.footline verwendet wird.

remove.xmlheader

(optional) Bei true wird der XML-Header entfernt. Default: false

insert.headline

(optional) Textzeile, die als separate Zeile vor das empfangene Dokument gesetzt wird. Default: <Leerzeile>

append.footline

(optional) Textzeile, die als separate Zeile hinter das Dokument gesetzt wird. Default: <Leerzeile>

check.BOM

(optional) Falls true, dann wird das BOM beachtet und entsprechend umkodiert. Default: false. Für Details siehe EncodingByBomOrXmlPreParser.

check.XML

(optional) Falls true, dann wird die XML-Kodierung beachtet und entsprechend umkodiert. Default: false. Für Details siehe EncodingByBomOrXmlPreParser.

Beispiel



sample_XmlRootAdderPreparser.properties
#
# Name des zu erzeugenden Root-Elements. Default: RootElement
root.name=TestRoot
# Soll der XML-Header entfernt werden? true oder false. Default: false
remove.xmlheader=true
#Textzeile, die als separate Zeile vor das empfangene Dokument gesetzt wird.
#insert.headline=
#Textzeile, die als separate Zeile hinter das Dokument gesetzt wird. Default: Leerzeile
#append.footline=