Zum Hauptinhalt springen

Wie erstellt man eine Serienbriefvorlage (Mustache)?

3 min read
PDF4me Team

Was ist Serienbrieffunktion?​

Der Seriendruck ist eine Methode, Daten aus einer Datenquelle zu lesen und entsprechende Variablen in einem anderen Dokument zu ersetzen. Dafür werden üblicherweise zwei Dateien benötigt: eine zum Speichern der Seriendruckfelder – der Variablen für die einzufügenden Daten – und eine weitere, die sowohl die Anweisungen zur Formatierung der Variablendaten als auch die Informationen enthält, die in jedem Ergebnis des Seriendrucks identisch sein sollen.

Beispielsweise werden Daten aus einer Datenbank, JSON-, CSV- oder Excel-Tabellenkalkulationen, Google Sheets oder anderen strukturierten Datenformaten gelesen und in eine bestehende Dokumentvorlage für E-Mails, Rechnungen oder andere Dokumente eingefügt, die dynamische Daten benötigen. Bei den Vorlagen handelt es sich häufig um Word-Dokumente, PDFs, E-Mails, Serienbriefe usw.

Wie erstellt man eine Vorlage mithilfe der Mustache-Syntax?​

Das Erstellen von Word-Vorlagen in Mustache erfordert Grundkenntnisse in Programmierung. Obwohl Mustache keine Vorlagensyntax im eigentlichen Sinne ist, kann sie sich bei der Erstellung komplexer Vorlagen für den Serienbriefversand als nützlich erweisen. Das folgende Beispiel veranschaulicht, wie die Mustache-Syntax zur Erstellung ansprechender Vorlagen beiträgt.

Die obige Rechnungsvorlage wurde vollständig mit der Mustache-Syntax gestaltet. Diese Word-Vorlage verwendet Mustache, um dynamische Kopf-, Fuß- und sogar Tabellen innerhalb der Vorlage zu erstellen.

Schauen wir uns an, wie die einzelnen Syntaxelemente dazu beitragen, Daten für die Erstellung einer dynamischen Rechnung zu generieren.

Kopfzeile​

{} – Markiert den Beginn einer Kopfzeile. Syntax, die innerhalb der Kopfzeile eingefügt werden muss : {{/foreach header}} – Schließt die Kopfzeile.

Körper - Pflichtfeld​

{} - Markiert den Beginn des Inhalts im Dokumentkörper {{/foreach body}} - Markiert das Ende des Dokumentkörpers

Fußzeile​

{} – Legt den Anfang der Dokumentfußzeile fest. Die Syntax muss innerhalb des Fußzeilenbereichs hinzugefügt werden. {{/foreach footer}} – Legt das Ende der Dokumentfußzeile fest.

Sie können die Daten für die obige Beispielrechnung als JSON an die Mustache-Vorlage übergeben. Nachfolgend finden Sie Beispieldaten zum Generieren von Dokumenten für die obige Vorlage.

{ "Dokumente": [ { "header": { "docType": "Originalkopie" }, "body": { "Column1": "Menge", "Column2": "Beschreibung", "Column3": "Einzelpreis", "Column4": "Gesamt", "Rechnung": { "number": 14957, "date": "25.02.2022", "instructions": "Anweisungsrechnung 1", "subTotal": 200150, "tax": "18%", "dueDate": "25.03.2022", "shipping": "200" }, "Biller": { "phone": "989797", "fax": "998463", "email": "[email protected]", "web": "www.doc1.com", "address": { "company": "Organisation 1", "street": "Straße 1", "city": "Stadt 1", "zip": "123456" } }, "Receipient": { "name": "recepeint 1", "address": { "street": "testveien 3 ", "city": "City 1", "zipcode": "0555", "country": "Country 1" } }, "Product": [ { "quantity": 1, "description": "item 1", "unitPrice": 45, "totalPrice": 867 }, { "quantity": 2, "description": "item 2", "unitPrice": 123, "totalPrice": 3464 }, { "quantity": 3, "description": "item 3", "unitPrice": 323, "totalPrice": 6564 } ] }, "footer": { "phone": "phone123", "fax": "fax123", "E-Mail": "[email protected]", "Web": "www.123.com" }

} ] }

IF-Anweisungen in Vorlagen​

Mit Microsoft Word können Sie Seriendruckfelder und Mustache-Tags mithilfe der IF-Anweisung verwenden. Diese sind hilfreich beim Generieren von Dokumenten mit bedingten Werten. Das IF-Seriendruckfeld verhindert unerwünschte Leerzeichen, wenn eine Bedingung nicht erfüllt oder ein Wert leer ist.

{ WENN [Bedingung] [Anzeigewert 1] [Anzeigewert 2] }

Z.B

Beispiele zum Einstieg​

Laden Sie die Beispielvorlage herunter Laden Sie die Beispieldaten-JSON-Datei herunter