Dokumentenverwaltung und Vorlagen

Wann sollten Dokumentvorlagen verwendet werden?

Wenn Sie nicht vorhaben, verschiedene Dokumentvorlagen für denselben Dokumenttyp zu verwenden, oder keine tiefgreifenden Änderungen benötigen (Änderungen, die nicht in den Ressourceneinstellungen vorgenommen werden können), empfehlen wir, sich vollständig auf die Konfiguration in den Ressourceneinstellungen zu verlassen. Wenn Sie für verschiedene Fälle mehrere unterschiedliche Dokumenttypen verwenden möchten, empfehlen wir Ihnen die Verwendung der Vorlagenoption, bei der Sie Ihre Vorlage im Ressourcen-Editor anpassen können.

So verwenden Sie Vorlagen

Bei den Dokumentvorlagen haben Sie zwei Möglichkeiten:

1. Erstellen Sie Ihre eigenen Vorlagen von Grund auf neu.
2. Überschreiben Sie vorhandene Vorlagen – allerdings kann in diesem Fall pro Dokumenttyp nur eine aktive Version vorhanden sein (z. B. eine Rechnungsvorlage, eine Lieferscheinvorlage).

Wenn Sie mehrere Versionen benötigen, beispielsweise für den internationalen Einsatz oder um bestimmten Konnektoren unterschiedliche Vorlagen zuzuweisen, müssen Sie Vorlagen anlegen.

So erstellen Sie Vorlagen

Sie können für jeden Dokumenttyp eine Vorlage erstellen. Klicken Sie hier, um eine Vorlage zu erstellen. Wählen Sie beim Erstellen einer Vorlage den Dokumenttyp aus und definieren Sie je nach Ihrer Auswahl zusätzliche Entitäten. Klicken Sie unter „Vorlagenressource“ auf „Auswählen“ und wählen Sie im Pfad des Ressourcen-Editors die gewünschte Vorlagendatei aus. Sie können entweder eine komplett neue Twig-Datei erstellen oder die Standard-Twig-Vorlage duplizieren. Nach der Erstellung können Sie Ihre Vorlage Konnektoren und weiteren Elementen zuweisen. Die Twig-Datei muss vor der Erstellung einer Vorlage geändert oder erstellt werden.

Tipps zur Gestaltung von Vorlagen

Benutzerdefinierte Schriftarten in Dokumenten verwenden

Sie können benutzerdefinierte Schriftarten in Ihren Vorlagen verwenden, indem Sie die .ttf-Dateien in den Ordner „fonts“ hochladen und in Ihrem CSS darauf verweisen.

@font-face {
    font-family: "OpenSans";
    font-weight: normal;
    src: url('resource:/document/fonts/OpenSans-Regular.ttf');
    -fs-pdf-font-embed: embed;
    -fs-pdf-font-encoding: Identity-H;
}

Vorlage für den Dokumenthintergrund ändern

Beim Erstellen eines Dokuments wird der dynamische Inhalt über den Hintergrund gedruckt, der in der Datei /documents/css/base.css in Ihrem Space festgelegt ist. Diese Vorlage gilt für alle Dokumente.

@page {
	background-image: url('resource:/document/images/document-background.pdf');
	padding: 0;

	/* Border of the Document */
	margin:  30mm 10mm 20mm 10mm;
	size: A4;
}

Um das Dokument anzupassen, können Sie entweder den Pfad hier ändern oder /document/images/document-background.pdf durch Ihre eigene Vorlage ersetzen. Sie können außerdem unterschiedliche Vorlagen für die erste Seite und die folgenden Seiten verwenden, indem Sie den Selektor @page:first zu Ihrer base.css-Datei hinzufügen. Dadurch wird für die folgenden Seiten die Datei „document-background.pdf“ und für die erste Seite die Datei „first-document-background.pdf“ verwendet.

@page {
	background-image: url('resource:/document/images/document-background.pdf');
	padding: 0;

	/* Border of the Document */
	margin:  30mm 10mm 20mm 10mm;
	size: A4;
}

@page:first {
	background-image: url('resource:/document/images/first-document-background.pdf');
}

Variablen in den Vorlagen verwenden

Sie können in Ihren Vorlagendateien Variablen verwenden. Alle im jeweiligen Kontext verfügbaren Variablen sind zusammen mit ihren Beschreibungen auf der unteren Registerkarte des Ressourcen-Editors aufgelistet. Verwenden Sie die Syntax twig, um diese Variablen auszugeben.

Abbildung 1: Der Editor zeigt die im aktuellen Kontext verfügbaren Variablen an.