Sie sind Template-Administrator und möchten eine Vorlage bearbeiten oder eine neue Vorlage erstellen? In diesem Artikel erfahren Sie die Grundlagen der Vorlagenbearbeitung.

Falls Sie den Vorlageneditor noch nicht kennen, informieren Sie sich hier: Vorlageneditor

Vorlage im Editor öffnen

Um eine Vorlage in der entsprechenden Office-Applikation (z. B. Word) zu bearbeiten, wählen Sie im Vorlageneditor die Schaltfläche Editor oder nutzen Sie Ctrl+E.

In diesem Beispiel wird die Vorlage Brief bearbeitet, also eine Inhaltsvorlage. Wenn Sie mehrere Sprachversionen der Vorlage haben, wählen Sie zuerst noch aus, welche Sprachversion Sie bearbeiten möchten.

Open

Die Vorlage wird nun in der jeweiligen Office-Applikation, im diesem Beispiel Word, geöffnet.

Im Editor

Open

Inhalt bearbeiten

(1) Da wir in diesem Beispiel eine Inhaltsvorlage bearbeiten, können Sie bei der Bearbeitung die Kopf- und Fusszeilen komplett ignorieren - diese sind ja bereits im Layout definiert. Lesen Sie hier mehr über die Vorlagenhierarchie: Vorlagen und Vorlagentypen | Word Vorlagen

Bei allen Angaben in eckigen Klammern, z. B. [Salutation] handelt es sich um primedocs Felder. Bei einem Klick auf das Feld [Salutation] steht dort Salutation (Field, unmapped). Das bedeutet, dass es sich um ein primedocs-Feld handelt, das nicht in der Dokumentfunktion Platzhalterzuordnung definiert wurde sondern es ist ein Feld, das direkt von der Fields-Dokumentfunktion stammt.

Gruppe Vorlagenbearbeitung

(2) Die Gruppe “Vorlagenbearbeitung” bietet die primedocs-eigenen Werkzeuge, um die Vorlage zu dynamisieren. Es gibt die folgenden Schaltflächen:

Feld binden

Das geöffnete Pop-up-Fenster ermöglicht die Auswahl von Profil-Feldern und von Fields, die in der Dokumentfunktion Felder konfiguriert wurden.

Textbausteinplatzhalter einfügen

Ein Textbausteinplatzhalter wird in Textbausteinen vom Typ Word Inhalt (WordContent) eingefügt, um anschliessend im WordContent-Field zu definieren, was abgefüllt wird (ein Forms-Feld, ein Field oder direkt Profildaten). Textbausteinplatzhalter können befüllt werden mit Text. Dazu gibt es hier mehr Informationen: Code | snippets API.

Platzhalter einfügen

Der Platzhalter ist das Gefäss, um in einer Kopf- oder Fusszeile einer Layoutvorlage dynamisierten Inhalt, z. B. Profil-Felder oder ein in der Felder-Dokumentfunktion definiertes Field, einzufügen.

Entwicklerwerkzeuge

Siehe Beschreibung weiter unten: Entwicklerwerkzeuge (Test)

Dokument testen

Wenn Sie die Vorlage bearbeitet haben, möchten Sie prüfen, ob Ihre Änderungen in einem generierten Dokument korrekt sind.

Kehren Sie zum Vorlageneditor zurück und klicken Sie auf “Dokument testen“ oder nutzen Sie Ctrl+T. Füllen Sie nun alle Parameter aus, als ob Sie ein Benutzer wären. Das Dokument wird anschliessend im Test-Modus generiert.

Gruppe Vorlagenbearbeitung

Der Vorteil am Testen eines Dokuments ist, dass Ihnen im offenen Word-Dokument anschliessend die Gruppe Vorlagenbearbeitung zur Verfügung steht, dies mit folgenden Optionen:

Vorschau generieren

Es wird ein “Screenshot” des Dokuments gemacht in diesem Moment und dieser als Vorschaubild dieser Vorlage gesetzt.

Demonstration

Schauen Sie sich die Demo bis zur Minute 0:40 an:

Mehrsprachige Vorschauen generieren

Generieren Sie ein Vorschaubild je nach Dokumentsprache.

Entwicklerwerkzeuge (Test)

Beim Lösen von Problemen beim Vorlagenbau ist es oft wertvoll eine Übersicht zu haben, welche Daten beim Erstellen eines Dokuments von Forms oder Fields zurückgegeben worden waren und welche Styles genau verfügbar sind. Die Entwicklertools zeigen diese Daten übersichtlich an:

Register in priorisierter Reihenfolge

• Register “FieldPart”: enthält alle Daten, die nach Fertigstellung des Dokuments hinterlegt sind, so z. B. Forms und Fields-Werte

• Register “DocData - WordStyles”: eine Liste aller Word-Styles in diesem Dokument und deren normalisierte StyleId.

• Register “TestingPart”: wird nur beim Erstellen eines Dokuments die "Dokument testen"-Schaltfläche befüllt und enthält dann genauere Informationen, welche Vorlagenversion genau genutzt wurde.

• Register “BasicPart”: Grundlegende Daten, wie z. B. die TemplateId

• Register “DocData”: ein sogenanntes "FlatOpc": eine flache Repräsentation des gesamten Word Dokuments als XML

Schauen Sie sich die Demo oben ab der Minute 0:40 an.