Sie sind hier: Dokumentation

Beschreibung der möglichen Funktionen und Java API

Detailierte Beispiele für die Anwendung der Funktionen finden Sie unter Beispiele

$_Variable&

Ersetzen einer Variablen
Der Variablenname wird relativ zum root-Element der XML-Struktur aufgelöst.

Beispiel: Brief.docx

$_BB_

Bedingung mit Alternativzweig
Eine Bedingung wird formuliert aus Start der Bedingung $_BB_1_ Vergleichsausdruck und Abschluss mit & : $_BB_1_elektro<>J& Die Bedingung ist bis zum Ende $_EB_1& gültig. Es kann ein Alternativ-Zweig (else) angegeben werden $_AB_1&. Die Ziffer 1 in der Bedingung verweist auf den Else-Block und das Ende der Bedingung. Damit ist es möglich Bedingungen zu schachteln.

Beispiel: Brief-Bedingung.docx

$_T_ / $_T_L

Einfügen von Tabellen
Zum Einfügen von Tabellen werden zwei Formen unterschieden. Bei einer Tabelle mit Kopfzeile wird eine Word-Tabelle mit zwei Zeilen vorgegeben und mit $_T_ definiert. Die erste Zeile ist die Kopfzeile, in der zweiten Zeile wird der Aufbau der Tabellenwerte vorgegeben. Mit $_T_L_ wird eine Tabelle eingefügt die keine Kopfzeile enthält. Es wird eine Word-Tabelle mit einer Zeile für die Werte definiert. Für den Zugriff auf die Liste innerhalb der XML-Datei enthält der $_T Aufruf noch den Namen der Liste: $_T_Kopf.Vertraege&. In der XML-Datei wird die Liste Kopf.Vertraege relativ zum Root verarbeitet. Die Variablen in der Tabellendefinition beziehen sich relativ zum Listenelement.

Beispiel: Brief-Tabelle.docx

$_L_

Einfügen von Listen
Soll eine Liste nicht in Tabellform sonder in eienr frei wählbaren Form eingefügt werden, wird der $_L Tag verwendet. Im Tag wird wie bei der Tabelle auf die XML-Liste vorgegeben: z.B. $_L_Kopf.Vertraege&. Das Ende der frei definierbaren Liste wird mit $_E abgeschlossen

Beispiel: Brief-Liste.docx

$_EG_

Einfügen von Grafiken
Anhand des Dateinamens aus der XML-Datei wird die Grafik in das Dokument eingefügt.

Beispiel: Brief-Grafik.docx

$_IN_

Einfügen von docx-Dateien
Mit $_IN werden externe docx-Dateien eingefügt. Bei dem $_IN Tag kann optional eine andere XML-Datei für das Mischen der Daten angegeben werden. Wird keine Angabe gemacht, wird die aktuelle XML-Datei benutzt.

Beispiel: Brief-Block.docx

$_Block_

Einfügen von $_IN Blöcken
In der XML-Datei wird eine Liste von Dateien vorgegeben die in das Dokument eingefügt werden sollen. Damit ist es möglich durch den Aufbau der XML-Datei eine Einfügestruktur vorzugeben.

Beispiel: Master.docx

$_NL

Einfügen neue Zeile
Mit dem Tag $_NL& kann eine Zeilenschaltung eingefügt werden

Java API

/*
* Bilden der instance
* Vorgabe der Dateinamen
* und mischen
*/

DOCXMerger docxMerger = new DOCXMerger();

String filename_Input = "docx\\variablen.docx";
String filename_xml = "xml\\daten.xml";
String filename_Ergebnis = "outMerge\\variablen.docx";

docxMerger.merge(filename_Input, filename_xml, filename_Ergebnis);