Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog
Dokument generieren (Einzeln)

Zurück zur Hauptübersicht: Alle Vorlagentypen, Knotenparameter und Ausgabefelder

Serienbrief

Was dieser Leitfaden umfasst

Diese Anleitung führt Sie durch das Zusammenführen eines klassische Word-Serienbriefvorlage In n8n Verwendung simple_mail_merge_template.docx Und sample_mail_merge_data.jsonDie Vorlage verwendet Word. MERGEFIELD Platzhalter (nicht <<[Feld]>> oder Schnurrbart {{Feld}}Daten sind ein JSON Array mit einem Objekt pro Empfänger. Für „Dokument generieren (Einzeln)“ verwenden Sie eine Reihe im Array. Die Ausgabe kann sein PDF oder WordDie

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog →

Bevor Sie beginnen​

Serienbrieffelder in Word
Das Muster simple_mail_merge_template.docx wurde mit der Word-Serienbrieffunktion (Seriendruckfeld einfügen) erstellt. Die Feldnamen lauten: Vorname, Nachname, Geschlecht, Und MitgliedSie müssen zusammenpassen JSON Tasten genau.
JSON Array-Daten
Verwenden sample_mail_merge_data.json (empfohlen), test.xml, oder test.csvSerienbriefdaten sind ein Array von ObjektenFügen Sie für ein Dokument ein Array mit einem einzelnen Objekt ein.
PDF4me Berechtigung in n8n
Erstellen Sie einen PDF4me Berechtigung in n8n und fügen Sie Ihren ein API Schlüssel. Derselbe Schlüssel funktioniert für alle PDF4me Knoten in Ihrer Instanz.

:::Hinweis Serienbriefe vs. PDF4me Word-Vorlage

Serienbriefe vs. PDF4me Word-Vorlage Serienbrief ist für Word-Dokumente gedacht, die mit klassischen Seriendruckfeldern (MERGEFIELD) erstellt wurden. PDF4me Word-Vorlage Verwendung <<[fieldName]>> LINQ-Syntax in einem regulären .docxWählen Sie den Typ, der zu Ihrer Vorlage passt. Für viele Empfänger in einem API Anrufen, verwenden Dokumente generieren (mehrere) stattdessen. :::

Beispieldateipaket​

Laden Sie alle vier Dateien unten herunter. Eine Word-Serienbriefvorlage sowie drei äquivalente Datenformate.

Was ist in den Beispieldateien enthalten?​

Zusammenführen von Feldern in simple_mail_merge_template.docx​

Das Beispiel ist ein einfaches Mitgliedschaftsschreiben mit vier klassischen Word-Seriendruckfeldern:

Merge field nameTypical label in templateSample value (sample_mail_merge_data.json)
firstnameGiven nameJohn
lastnameFamily nameAdams
genderGenderFemale
memberMembership tierBasic

:::Tipp: So prüfen Sie Seriendruckfeldnamen Drücken Sie in Microsoft Word die entsprechende Taste Alt+F9 Feldcodes umschalten. Seriendruckfelder werden wie folgt angezeigt: { MERGEFIELD firstname } Stilcodes. Der Name danach MERGEFIELD muss mit Ihrem übereinstimmen JSON Schlüssel. :::

Feldzuordnung über alle Datendateien hinweg​

Merge fieldJSON key (sample_mail_merge_data.json)XML element (test.xml)CSV column (test.csv)Sample value
firstnamefirstnamefirstnamefirstnameJohn
lastnamelastnamelastnamelastnameAdams
gendergendergendergenderFemale
membermembermembermemberBasic

Im Gegensatz zu PDF4me Word Template gibt es keine <<[Feld]>> Tags. Anders als bei anderen Tags. HTMLEs gibt keine Mustache-Syntax. Die Engine bindet JSON Schlüssel zu Word-MERGEFIELD-Namen eins zu eins.

Der Arbeitsablauf im Überblick​

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Schrittn8n KnotenZweck
1Manueller AuslöserStarten Sie den Workflow bei Bedarf
2Binärdatei lesenLasten simple_mail_merge_template.docx in binäre Eigenschaften data
3PDF4me → Dokument generieren (Einzeln)Zusammenführungsvorlage + JSON Array, Ausgaben PDF oder Word
4Binärdatei schreiben oder E-Mail senden (optional)Speichert oder sendet generated_document_output.pdf
Die Dropdown-Liste „Vorlagendateityp“ im Knoten „Dokument generieren (Einzeln)“ von n8n PDF4me zeigt die Optionen „Seriendruck“ sowie „Word“, „HTML“, „PDF-Formular“ und „Google Docs“ an.

Satz Vorlagendateityp Zu Serienbrief. Wählen PDF oder Word für AusgabetypDie

Schritt 1: Beispieldateien herunterladen und platzieren​

  1. Herunterladen simple_mail_merge_template.docx Und sample_mail_merge_data.json von Beispieldateipaket über.
  2. Speichern Sie die Vorlage irgendwo n8n kann es lesen (lokaler Pfad bei selbst gehosteten Systemen oder Cloud-Speicher für Produktionsauslöser).
  3. Optionaler Download test.xml oder test.csv um andere Datentypen zu testen.

Schritt 2: Erstellen Sie die n8n Workflow​

  1. In n8n, einen neuen Workflow erstellen.
  2. Füge ein Manueller Auslöser Knoten.
  3. Füge ein Binärdatei lesen Knoten nach dem Auslöser.
  4. Hinzufügen PDF4me → Dokument generieren (Einzeln) nach dem Lesen der Binärdatei.
  5. Verbinden Sie Ihr PDF4me BerechtigungDie

:::Achtung: HTML-Code ist hier ungültig.

Dieser HTML-Code ist hier ungültig. Eingabetyp der Vorlagendatei: HTML Code Funktioniert nur wenn Vorlagendateityp Ist HTMLFür den Serienbrief verwenden Sie Binärdaten, Base64 Zeichenkette, oder URL.

:::

Schritt 3: Laden Sie die Word-Vorlage (Read Binary File)​

Konfigurieren Sie die Binärdatei lesen Knoten:

FeldWert
DateipfadVollständiger Pfad zu Ihrer heruntergeladenen Datei simple_mail_merge_template.docx
Name der Immobiliedata (Standardeinstellung; verwendet als Vorlage Binäre Eigenschaft In PDF4me)

Führen Sie diesen Knoten einmal aus und überprüfen Sie, ob das Ausgabeelement Binärdaten anzeigt. data mit Dateinamen simple_mail_merge_template.docxDie

Schritt 4: Konfigurieren PDF4me Dokument generieren (Einzeln)​

Kerneinstellungen​

FeldWertAnmerkungen
Anmeldeinformationen zum Verbinden mitDein PDF4me BerechtigungErhalten API Schlüssel
RessourceGenerate
Operationen generierenDokument generieren (Einzeln)
VorlagendateitypSerienbriefKlassische Word-Vorlage für Seriendruckfelder
AusgabetypPDF oder WordPDF zum Teilen; Word wenn der Empfänger das zusammengeführte Dokument bearbeiten soll

Vorlageneingabe (aus „Binärdatei lesen“)​

FeldWert
Eingabetyp der VorlagendateiBinärdaten
Vorlage Binäre Eigenschaftdata
Vorlagendateinamesimple_mail_merge_template.docx

Dokumentdaten (JSON-Array einfügen von sample_mail_merge_data.json)​

FeldWert
Dokumentdaten-EingabetypText
DokumentdatentypJSON
Dokumentdaten TextFügen Sie den vollständigen Inhalt ein von sample_mail_merge_data.json (siehe unten stehenden Block)
[
  {
    "firstname": "John",
    "lastname": "Adams",
    "gender": "Female",
    "member": "Basic"
  }
]

:::Wichtig: JSON muss ein Array sein. Serienbriefdaten sind ein JSON ArrayAuch für einen einzelnen Empfänger. Ein Objekt im Array erzeugt mit „Dokument generieren (Einzeln)“ ein zusammengeführtes Dokument.

:::

Ausgabeoptionen​

FeldWert
Halten PDF BearbeitbarAus (Standardeinstellung), wenn Ausgabetyp PDF
Name der Binärdatenausgabedata (Standard)

Schritt 5: Ausführen und Ausgabe überprüfen​

  1. Klicken Workflow ausführenDie
  2. Öffne die PDF4me Knotenausgabe. Unter Binäroffenes Grundstück data (generated_document_output.pdf oder .docx).
  3. Prüfen Sie, ob alle vier Seriendruckfelder ausgefüllt sind:
    • Vorname → Johannes
    • Nachname → Adams
    • Geschlecht → Weiblich
    • Mitglied → Grundlagen

Wenn ein Feld leer ist, vergleichen Sie Ihre JSON Tasten mit den MERGEFIELD-Namen in der Word-Vorlage (Alt+F9 in Word).

Schritt 6: Ausgabe speichern oder senden (optional)​

Binärdatei schreiben:

FeldWert
Dateinamemail-merge-output.pdf
Name der Dateneigenschaftdata
AusgabepfadZielordner auf Ihrem n8n Gastgeber

E-Mail senden: Hängen Sie die Binärdatei an. data aus PDF4me als die PDF oder Word Anhang.

Alternative Datenformate​

Option A: JSON Datei als Binärdatei (sample_mail_merge_data.json)​

  1. Hinzufügen Binärdatei lesen für sample_mail_merge_data.json (verwenden Sie ein Verschmelzen Knoten, falls Vorlage und Daten das Workflow-Element gemeinsam nutzen).
  2. Satz Dokumentdaten-Eingabetyp Zu Binärdaten, Dokumentdatentyp Zu JSON, Dokument-Binär-Eigenschaft zu Ihrem Datenfeld, Dokumentdatendateiname Zu sample_mail_merge_data.jsonDie

:::Vorsicht: Namenskonflikt bei binären Eigenschaften Wenn sowohl Vorlage als auch Daten diese Eigenschaft verwenden dataDer eine überschreibt den anderen. Verwenden Sie separate Namen (z. B. template Und mergeData) oder Elemente aus zwei Read Binary File-Knoten zusammenführen.

:::

Option B: XML (test.xml)​

Satz Dokumentdatentyp Zu XML und einfügen:

<?xml version="1.0" encoding="UTF-8"?>
<Person>
    <firstname>John</firstname>
    <lastname>Adams</lastname>
    <gender>Female</gender>
    <member>Basic</member>
</Person>

Die Elementnamen entsprechen den Namen der Zusammenführungsfelder und den JSON-Schlüsseln.

Option C: CSV (test.csv)​

Satz Dokumentdatentyp Zu CSV und einfügen (Kopfzeile + eine Datenzeile):

firstname,lastname,gender,member
"John","Adams","Female","Basic"

Die Spaltenüberschriften entsprechen direkt den Namen der Seriendruckfelder.

Alternative Vorlageneingabe: URL​

Gastgeber simple_mail_merge_template.docx bei einer öffentlichen HTTPS URLdann einstellen:

FeldWert
Eingabetyp der VorlagendateiURL
URL der VorlagendateiÖffentlicher Link zu simple_mail_merge_template.docx
Vorlagendateinamesimple_mail_merge_template.docx

Es wird kein Knoten zum Lesen von Binärdateien benötigt. Daten können weiterhin eingefügt werden als Dokumentdaten Text oder geladen von einem URLDie

Produktionsablaufmuster​

Gängige Methoden zum Ausführen von Serienbriefen in der ProduktionOnce the sample test works, replace the Manual Trigger with these patterns.
Google Tabellen Zeile zu Buchstabe
  1. Die Tabellen werden bei jeder neuen Zeile ausgelöst.
  2. Code oder Satz Der Knoten umschließt die Zeile mit einem JSON Array: [{"firstname": "...", ...}]Die
  3. PDF4me Serienbrief mit festen simple_mail_merge_template.docxDie
  4. Die zusammengeführte Datei per E-Mail senden PDF an den Empfänger.
Webhook-Registrierungsformular
  1. Der Webhook empfängt die Formularnutzdaten.
  2. Ordnen Sie die Textfelder den Zusammenführungsschlüsseln zu (Vorname, Nachname, usw.).
  3. Baue ein Ein-Element-Produkt JSON Array für Dokumentdaten-Text.
  4. Speichern oder versenden Sie die Ausgabe per E-Mail. PDFDie
Massenzusammenführung (viele Empfänger)
  1. Kontakte exportieren als JSON Array (ein Objekt pro Person).
  2. Wechseln zu Dokumente generieren (mehrere) für einen PDF pro Zeile.
  3. Behalten Sie die Option „Dokument generieren (Einzeln)“ bei, wenn Sie pro Durchlauf nur eine zusammengeführte Datei benötigen.

Häufig gestellte Fragen​

How is Mail Merge different from PDF4me Word Template?+
Mail Merge uses classic Word MERGEFIELD placeholders created in Word mail merge. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a regular .docx. Pick the type that matches how your template was authored. Data for Mail Merge is typically a JSON array.
Why must JSON be an array?+
Mail merge is designed for one or more recipient rows. Generate Document (Single) uses the first row when you pass one object in the array. Generate Documents (Multiple) processes every row and returns multiple output files.
Why is a merge field blank?+
JSON keys must match MERGEFIELD names exactly, including case. firstname works; FirstName or first_name usually does not. Toggle field codes in Word (Alt+F9) to read the internal name.
PDF or Word output?+
Choose PDF for emailing, archiving, or printing. Choose Word when the recipient needs to edit the merged document after generation. Both work with the same template and JSON array.
JSON vs XML vs CSV: which should I use?+
JSON arrays are the most natural fit for mail merge in n8n. XML and CSV in the sample pack carry the same four values for a single recipient. All formats map one value per merge field name.

Verwandte Leitfäden​

Back to overviewGenerate Documents (Multiple)