Content

Einordnung

Bereich: Dokumentstruktur

Schwierigkeitsgrad: ⭐⭐☆☆☆

Vorkenntnisse: Block

Empfohlener nächster Artikel: Dokumentelemente → Text

Zweck

Das XML-Element <Content> enthält den eigentlichen Inhalt eines Dokumentblocks.

Innerhalb des <Content> werden sämtliche XML-Elemente eingefügt, die während der Dokumenterzeugung Inhalte erzeugen oder den Dokumentfluss beeinflussen.

Der <Content> bildet damit den Arbeitsbereich eines <Block> und stellt die Verbindung zwischen der Dokumentstruktur und den eigentlichen Dokumentelementen her.

Eigenschaften

Position innerhalb der Dokumentvorlage

Ein <Content> befindet sich grundsätzlich innerhalb eines <Block>.

Der grundsätzliche Aufbau lautet:

<Block>

    <Content>

        ...

    </Content>

    <BlockProperties>

        ...

    </BlockProperties>

</Block>

Ein Block enthält in der Regel genau einen <Content>.

Aufgabe des Content

Der <Content> dient als Container für alle XML-Elemente, die den Inhalt eines Dokumentabschnitts beschreiben.

Er enthält beispielsweise:

• Texte
• Variablen
• Bilder
• Barcodes
• Tabellen
• Bedingungen
• Referenzen
• Formatierer
• weitere XML-Elemente

Der <Content> selbst erzeugt dabei keine Ausgabe.

Er dient ausschließlich der strukturierten Zusammenfassung der enthaltenen XML-Elemente.

Typische XML-Elemente

Je nach Dokumentvorlage können innerhalb eines <Content> unter anderem folgende XML-Elemente verwendet werden.

Diese XML-Elemente werden in den jeweiligen Fachartikeln ausführlich beschrieben.

Verarbeitung

Alle XML-Elemente innerhalb eines <Content> werden in der Reihenfolge verarbeitet, in der sie definiert sind.

Dadurch entspricht die Reihenfolge der XML-Elemente grundsätzlich auch der späteren Darstellung innerhalb des erzeugten Dokuments.

Ein vereinfachtes Beispiel:

<Content>

    <Text Content="Sehr geehrte"/>

    <Variable Name="Empfänger"/>

    <Text Content=","/>

</Content>

Die Inhalte werden später in genau dieser Reihenfolge ausgegeben.

Content und Dokumentelemente

Der <Content> enthält keine Formatinformationen.

Eigenschaften wie Einzüge, Rahmen, Ausrichtungen oder Absatzformate werden grundsätzlich außerhalb des <Content> innerhalb der <BlockProperties> definiert.

Hierdurch werden Inhalt und Darstellung voneinander getrennt.

Diese Trennung erleichtert sowohl die Entwicklung als auch die spätere Wartung einer Dokumentvorlage.

XML-Wissen

Der <Content> beschreibt ausschließlich den Inhalt eines Dokumentabschnitts.

Die Darstellung dieses Inhalts wird überwiegend durch die zugehörigen <BlockProperties> bestimmt.

Typische Verwendung

Jeder Block besitzt einen eigenen <Content>.

Innerhalb dieses Bereichs werden alle XML-Elemente eingefügt, die Bestandteil des jeweiligen Dokumentabschnitts sein sollen.

Hierzu gehören sowohl einfache Textausgaben als auch komplexe XML-Strukturen mit Bedingungen, Berechnungen oder Referenzen.

Typische Nachbarn

Ein <Content> befindet sich immer innerhalb eines <Block>.

Häufig verwendete XML-Elemente innerhalb des <Content> sind:

• Text
• Variable
• PictureFormatter
• MetaFormatter
• Barcode
• Reference
• If
• Case

Best Practices

• Verwenden Sie den <Content> ausschließlich für XML-Elemente, die Inhalte erzeugen oder den Dokumentfluss steuern.
• Legen Sie Formatierungen möglichst in den zugehörigen <BlockProperties> ab.
• Strukturieren Sie umfangreiche Inhalte durch mehrere kleinere Blöcke anstatt durch einen sehr großen <Content>.
• Halten Sie den XML-Code innerhalb des <Content> übersichtlich eingerückt.

Hinweis

Eine klare Trennung zwischen Inhalt (<Content>) und Darstellung (<BlockProperties>) erhöht die Lesbarkeit der Dokumentvorlage und erleichtert spätere Erweiterungen.

Technischer Hinweis

Der <Content> besitzt keine eigenen Attribute.

Er dient ausschließlich als Container für die XML-Elemente eines Dokumentabschnitts.

Während der Dokumenterzeugung verarbeitet die Render-Engine sämtliche XML-Elemente innerhalb des <Content> in ihrer definierten Reihenfolge.