Untervorlagen

Einleitung

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

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

Note

Dank dem OneOffixx Vererbungssystem ist es möglich, über eine Word-Vorlage die komplette Kopf- bzw. Fusszeile zu steuern, sodass man die ensprechenden Angaben jeweils zentral in den dafür vorgesehenen Vorlagentypen verwalten kann.

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:

Verknüpfungsarten:

OneOffixx 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 OneOffixx-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.

Important

Ist eine Vorlage einmal als "Untervorlage" markiert, kann das nicht mehr rückgängig gemacht 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:

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 OneOffixx Dokument-Pipeline: