Einleitung

In primedocs kann eine Vielzahl von unterschiedlichen Dateitypen als Vorlage hinterlegt werden. Eine der Hauptstärken von primedocs liegt im Verwalten von Microsoft Office-Dateiformaten und insbesondere dem Word bzw. dem Open XML for Word Processing-Format.

Wird in primedocs eine Vorlage erstellt und wird daraus ein Dokument generiert, wird der komplette Inhalt samt Kopf- und Fusszeile als ein einziger Abschnitt eingefügt.

Möchte man nun aber unterschiedliche Abschnitte einfügen, z. B. um unterschiedliche Hoch-/Querformate oder unterschiedliche Kopf- und Fusszeilen umzusetzen, werden die Untervorlagen benötigt.

Aufbau

Eine Untervorlage entspricht vom Aufbau her einer normalen Vorlage. Sie verwendet denselben Vererbungsmechanismus, allerdings kann man einer Untervorlage keine eigenen Dokumentfunktionen anhängen. Benötigte Daten aus Dokumentfunktionen, z. B. Profildaten, müssen über die entsprechende Inhaltsvorlage hinzugefügt werden. Die Verknüpfung zwischen Untervorlagen und Inhaltsvorlagen erfolgt über den Vorlageneditor:

Open

Verknüpfungsarten

primedocs kennt zwei verschiedene Verknüpfungsarten für Untervorlagen:

• "Bei Generierung": Diese Untervorlagen werden in der entsprechenden Reihenfolge automatisch beim Generieren des Dokumentes eingefügt. Es kann zusätzlich eine Bedingung angegeben werden, sodass z. B. je nach Option im Dokument-Parameter eine Untervorlage hinzugefügt wird oder nicht.

• "Optional": Diese Untervorlagen stehen im generierten Dokument im primedocs-Ribbon unter "Weitere Inhalte" zur Verfügung.

Jede Inhaltsvorlage kann mit mehreren Untervorlagen verküpft werden, wobei eine Untervorlage stets einem eigenen Abschnitt entspricht. Um eine Untervorlage zu erstellen, muss eine normale Word-Vorlage erstellt und diese als "Untervorlage" markiert werden.

Dokumentfunktionen

Um Daten aus Dokumentfunktionen zu nutzen, wie z. B. Profildaten, muss sichergestellt werden, dass die Dokumentfunktion "Profildaten" an der Inhaltsvorlage angehängt ist. Wird danach der Vorlageneditor der Untervorlage geöffnet, kann der Word-Editor der Untervorlage mittels Auswahl einer Inhaltsvorlage aufgerufen werden:

Open

Bedingungen

Über den Vorlageneditor können auch Untervorlagen verknüpft werden, die nur integriert werden, falls eine entsprechende Bedingung erfüllt ist. Dafür ist es erforderlich, die Bedingung in JavaScript zu formulieren. Daten aus dem Dokument-Parameter können über eine API abgefragt werden, sodass z. B. eine Checkbox im Dokument-Parameter platziert werden kann. Nur wenn diese aktiv ist, wird ein bestimmtes Unterdokument eingefügt.

Dokumentgenerierungsprozess

Das System der Untervorlagen ergänzt die bestehende primedocs Dokument-Pipeline: