Datenfeld

Derzeit  gibt es folgende Datenfeld-Elemente:

<text>: Ein Textfeld, das sich über die gesamte Tabellenbreite erstreckt. Es kann z.B. für einzelne Bilder oder längere (HTML-)Texte genutzt werden.

<d>: Ein Datenfeld, das in der zugewiesenen Tabellenspalte angezeigt wird. Datenfeldinhalte werden abhängig vom Datentyp umgewandelt.

<dtext>: Ein Textfeld an einer Tabellenspaltenposition mit der Formatierung des Datenfeldes, es kann z.B. genutzt werden, um einen benutzerdefinierten Text anstelle eines Datenfeldinhalts <d> einzutragen.

Inhalte werden nicht datentypabhängig umgewandelt.

<ctext>: Ein Textfeld an einer Tabellenspaltenposition mit der Formatierung des Spaltenkopfes, es kann z.B. für einen benutzerdefinierten Spaltenkopf genutzt werden.

Inhalte werden nicht datentypabhängig umgewandelt.

<nl>: Eine Leerzeile, diese kann bei Seitenumbrüchen entfernt werden, sofern sie am Seitenanfang steht.

<vs>: Ein vertikaler Platzhalter, im Prinzip identisch mit <nl>, aber mit dem Unterschied, dass das <vs>-Element bei Seitenumbrüchen nicht entfernt wird.

<np>: Ein Seitenumbruch.

Die Datenfeld-Elemente müssen sich in einem Element des Typs <r> befinden.

Beispiel:

<table>

<r><text>Erläuterung</text></r>

<r><d>Text 1</d><d>2000-01-01</d></r>

<r><d>Text 2</d><d>2000-01-02</d></r>

<r><d>Text 3</d><d>2000-01-03</d></r>

<r><d>Text 4</d><d>2000-01-04</d></r>

<r><nl border-width="0"></nl></r>

<r><np/></r>

</table>

Innerhalb der Objekte Tabellenkopf und Tabellenfuß ist pro Zeile nur ein Element der Typen <text>, <nl>, <vs> zulässig. Diese dürfen ansonsten beliebig oft auftauchen.

Zusätzlich können Elemente des Typs <dtext> und <ctext> genutzt werden, diese müssen aber in ein <r>-Tag eingebettet werden.

Beispiel:

<table>

<header>

<text>HEADER</text>

</header>

<header>

<nl/>

</header>

<footer>

<text>FOOTER</text>

</footer>

<r><d>Text 1</d><d>2000-01-01</d></r>

<r><d>Text 2</d><d>2000-01-02</d></r>

<r><d>Text 3</d><d>2000-01-03</d></r>

<r><d>Text 4</d><d>2000-01-04</d></r>

<footer-end/>

</table>

Allen Elementen können Attribute zugewiesen werden.

Beispiel:

<header>

<text text-color="191,239,255">HEADER LIGHTBLUE</text>

</header>

Alle Texte in den Elemente müssen UTF-8 -kodiert sein. Sofern HTML-Text eingetragen wird, muss dieser encoded werden und das Attribut rich-text auf 1 gesetzt werden.

Zum Escapen gibt es z.B. zahlreiche Online-Tools (google online html encoder).

Beispiel:

HTML-Tabelle:

<table border="1">

<tbody>

<tr>

<td><strong>Name</strong></td>

<td><strong>City</strong></td>

</tr>

<tr>

<td>John Doe</td>

<td>Dublin</td>

</tr>

</tbody>

</table>

In mod_print:

<r>

<d text-rich="1">&lt;table&gt;

&lt;table border=&quot;1&quot;&gt;

&lt;tbody&gt;

&lt;tr&gt;

&lt;td&gt;&lt;strong&gt;Name&lt;/strong&gt;&lt;/td&gt;

&lt;td&gt;&lt;strong&gt;City&lt;/strong&gt;&lt;/td&gt;

&lt;/tr&gt;

&lt;tr&gt;

&lt;td&gt;John Doe&lt;/td&gt;

&lt;td&gt;Dublin&lt;/td&gt;

&lt;/tr&gt;

&lt;/tbody&gt;

&lt;/table&gt;</d>

<d>2000-01-02</d>

</r>

Alternativ dazu kann das Attribut include-text verwendet werden, es erwartet eine Textdatei im UTF-8-Format,  der Text wird automatisch encoded.

Sofern kein Pfad angegeben wird, wird die Datei im Ordner des Dokumentes erwartet.

Beispiel:

<r>

<text include-text="include.html" text-rich="1"></text>

</r>

Pfadvariablen sind dabei ebenfalls nutzbar:

Beispiel:

<r>

<text include-text="{HTMLPATH}include.html" text-rich="1"></text>

</r>

Erweiterte Möglichkeiten bei bestimmten Datenfeldtypen:

Pfadvariablen:

Bei Bildfeldern sind Pfadvariablen nutzbar:

<r><d>Bild</d><d>{IMAGEPATH}1.png</d></r>

Eingebetteter Wert:

Bei den Datenfeldern vom Typ:

Datum

Datum und Zeit

Bool

Gleitkommazahl

Währungsbetrag

würde ein zusätzlicher Text bei der Konvertierung des Wertes in die eingestellte Lokalisierung normalerweise einen falschen Ausgabewert hervorrufen, durch Einbetten des Wertes in geschweifte Klammern kann das Problem umgangen werden, der Wert wird korrekt konvertiert und der zuvor vorhandene Text bleibt erhalten.

Beispiel:

<r><d>Text 4</d><d>Before {2000-01-04} After</d></r>

Überspannen einer Tabellenzeile über mehrere Spalten:

Sofern sich rechts in einer Tabellenzeile leere Spalten befinden, kann der Platz optional für das Feld links davon mit dem Attribut autospan genutzt werden.

Mit dem Attribut nospan kann das Überspannen für eine bestimmte Spalte ausgesetzt werden.

Beispiel:

<r autospan="1">

       <d>Zeile 1 Dies ist ein laengerer Text Dies ist ein laengerer Text Dies ist ein laengerer Text Dies ist ein laengerer Text</d>

       <d></d>

       <d nospan="1"></d>

       <d>Textinhalt</d>

</r>