XmlRootAdderPreparser
Gruppe |
|
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
#
# 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=