Dokumente (mehrere) generieren in n8n
Mehrere Dokumente generieren Die PDF4me-Knotenaktion in n8n, im Knoten als „Dokumente generieren (Mehrere)“ angezeigt, erzeugt in einem Durchlauf mehrere fertige Dateien aus einer einzigen Vorlage und einem Array von Datensätzen. Sie eignet sich beispielsweise für Stapelverarbeitungen von Rechnungen, Kundenbriefen oder regionalen Berichten. Jedes Dokument wird als eigenes n8n-Element zurückgegeben.
Was dieser Knoten bewirkt
PDF4me: Dokumente generieren (Mehrere) benötigt eine Vorlage und eine Liste von Datensätzen und erzeugt in einem Schritt viele fertige Dokumente. n8n Führen Sie aus. Stellen Sie eine bereit. Wort, HTML, oder PDF Vorlage über Binärdaten, Base64, HTML Code oder URL plus Massendaten als JSON oder XML (Array von Datensätzen oder Wiederholungen) XMLJede generierte Datei wird als separates Ausgabeelement zurückgegeben, sodass Sie sie einzeln verarbeiten, speichern, per E-Mail versenden oder hochladen können. Verwenden Sie diesen Knoten anstelle von Dokument generieren (Einzeln) Immer dann, wenn Sie eine Liste von Kunden, Rechnungen oder Datensätzen haben und für jede Zeile ein fertiges Dokument in einem einzigen Durchlauf erstellen möchten.
Authentifizierung Ihres API Anfrage
Jeder PDF4me Knoten in n8n erfordert eine gültige Anmeldeinformationen zum Verbinden mitErstellen oder wählen Sie einen Eintrag aus, der Ihre Daten enthält. PDF4me API Schlüssel, damit der Workflow Batch-Dokumentgenerierungsanforderungen sicher authentifizieren kann.
Wichtige Fakten, die Sie nicht verpassen sollten
/generate-documents-multiple-full.png)
Vollständiges Knotenpanel. Word-Vorlage + JSON Textdaten + PDF Die Ausgabe entspricht dem typischen Serienbrief-Setup.
Dokumente generieren (mehrere) vs Dokument generieren (einzeln)
Die häufigste Fehlerquelle bei dieser Aufgabe ist die Wahl der falschen der beiden Optionen. Die Aufteilung hängt davon ab, wie viele Dateien zurückgegeben werden und welche Vorlagen und Datenformate angeboten werden.
| Aspekt | Dokumente generieren (mehrere) | Dokument generieren (Einzeln) |
|---|---|---|
| Files returned | Many, one n8n item per generated document | Exactly one |
| Template types | Word, HTML, PDF | Word, HTML, PDF, plus Mail Merge and Google Docs |
| Data formats | JSON or XML only | JSON, XML, and CSV |
| Output types | PDF, Word, or Excel (HTML templates output HTML) | PDF, Word (no Excel option) |
| Reach for it when | You have a list of records and want one document per row | You have a single record, CSV data, or a Mail Merge template |
Welche Parameter benötigt die Funktion „Dokumente generieren (Mehrere)“?
Erforderlich in der n8n Benutzeroberfläche: Anmeldeinformationen für die Verbindung, Vorlagendateityp, Vorlagendatei-Eingabetyp, Dokumentdatentyp, Dokumentdaten-Eingabetyp und Ausgabetyp (wird immer angezeigt; die Auswahlmöglichkeiten hängen vom Vorlagendateityp ab). Bedingt erforderliche Felder (Binäre Eigenschaften der Vorlage, Vorlage). Base64 Inhalt, HTML Code, Vorlagendatei URLDokumentdaten (Text), Dokumentbinäreigenschaft usw.) werden nur angezeigt, wenn der entsprechende übergeordnete Eingabetyp ausgewählt ist. Ausgabedateiname beibehalten PDF Die Optionen „Bearbeitbar“ und „Binärdatenausgabename“ sind optional und verwenden sinnvolle Standardwerte.
| Parameter | Erforderlich | Was es tut | Beispiel |
|---|---|---|---|
| Template File Type | Required | Format of the template the node will render. Word for .docx templates, HTML for HTML templates (including pasted code), PDF for PDF templates. There is no Mail Merge, Google Docs, or PDF form option here; use Generate Document (Single) for those. | Word |
| Output Type | Required | Format of every generated document. Word and PDF templates accept PDF, Word, or Excel. HTML templates accept HTML only. Default is PDF when available. | PDF |
| Template File Input Type | Required | How the template is supplied. Binary Data reads from a previous node (most common). Base64 String accepts an encoded template. HTML Code accepts pasted raw HTML (only valid when Template File Type is HTML). URL downloads the template from a public link. | Binary Data |
| Template Binary Property | Conditional | Name of the binary property on the incoming n8n item that holds the template. Required when Template File Input Type is Binary Data. Defaults to data. | data |
| Template Base64 Content | Conditional | Base64-encoded template content. Required when Template File Input Type is Base64 String. | UEsDBBQAAAAI... |
| HTML Code | Conditional | Raw HTML body (mustache placeholders such as {{title}} are supported). Required when Template File Input Type is HTML Code, which is only valid for Template File Type HTML. The node wraps the snippet in a basic <html> shell if missing. | <h1>{{title}}</h1> |
| Template File URL | Conditional | Publicly reachable HTTPS URL to the template file. Required when Template File Input Type is URL. | https://example.com/template.docx |
| Template File Name | Conditional | Filename of the template. Optional with Binary Data (falls back to the uploaded filename or a sensible default such as template.docx, template.html, template.pdf). Required for Base64 String, HTML Code, and URL. | template.docx |
| Document Data Type | Required | Format of the bulk records you are sending. JSON for arrays of objects (most common). XML for repeating-record XML. CSV is not available on this operation. | JSON |
| Document Data Input Type | Required | How the bulk data is supplied. Text is the default (paste JSON or XML directly). Binary Data reads from a previous node. Base64 String accepts an encoded data file. URL downloads the data file from a public link. | Text |
| Document Data Text | Conditional | Raw bulk JSON or XML payload. Required when Document Data Input Type is Text. The node validates that JSON parses; XML is sent as-is. Use an array of objects in JSON so the API renders many files. | [{"name":"Alice"},{"name":"Bob"}] |
| Document Binary Property | Conditional | Name of the binary property on the incoming n8n item that holds the data file. Required when Document Data Input Type is Binary Data. Defaults to data. | data |
| Document Data File Name | Conditional | Filename for the bulk data file. Optional with Binary Data (falls back to data.json). Required when Document Data Input Type is Base64 String or URL. | customers.json |
| Document Base64 Content | Conditional | Base64-encoded data file. Required when Document Data Input Type is Base64 String. | W3sibmFtZSI6... |
| Document Data File URL | Conditional | Publicly reachable HTTPS URL to the bulk data file. Required when Document Data Input Type is URL. | https://example.com/customers.json |
| Output File Name | Optional | Prefix for the generated filenames. The node appends _1, _2, ... and the correct extension. Example: invoice becomes invoice_1.pdf, invoice_2.pdf. Leave blank to use API-provided names or generated_document_1, generated_document_2, ... | invoice |
| Keep PDF Editable | Optional | Only shown when Output Type is PDF. Keeps AcroForm fields editable on every generated PDF when enabled. Default is off (flattened output). | Off |
| Binary Data Output Name | Optional | Name of the binary property each output item exposes. Default is data. Placeholder suggests generated-documents. | data |
Optionen für den Vorlagendateityp
Wählen Sie das Vorlagenformat. Die Ausgabetypen ändern sich mit dieser Auswahl.
/generate-documents-multiple-template-file-type.png)
Dropdown-Menü „Vorlagendateityp“. Word, HTML, oder PDF (Hier werden weder Serienbriefe noch Google Docs verwendet)
WortStandard: .docx-VorlagenHTMLHTML Vorlagen und eingefügt HTML CodePDFPDF VorlagenAusgabetyp nach Vorlage
| Vorlagendateityp | Auswahlmöglichkeiten für den Ausgabetyp | Standard |
|---|---|---|
| Word | PDF, Word, Excel | |
| PDF, Word, Excel | ||
| HTML | HTML only | HTML |
Vorlagendatei Eingabetypoptionen
Wählen Sie aus, wie die Vorlage in den Knoten eingefügt wird. Die Folgefelder ändern sich je nach dieser Auswahl.
/generate-documents-multiple-template-file-input-type.png)
Eingabetyp der Vorlagendatei: Binärdaten. Base64 Zeichenkette HTML Code oder URL
BinärdatenStandardwert: Datei vom vorherigen KnotenVorlage Binäre Eigenschaft zum Namen des Binärfelds (Standardwert) Daten). Vorlagendateiname ist optional und verwendet ansonsten den Namen der hochgeladenen Datei.Base64-ZeichenketteBase64-kodierte VorlageVorlage Base64-InhaltDie Vorlagendateiname ist erforderlich, damit die Dateierweiterung mit dem Dateityp der Vorlage (.docx, .html, .pdf) übereinstimmt.HTML-CodeRohpaste HTML im Einklang (HTML nur){{Titel}}, {{Inhalt}} hinein HTML-CodeDer Knoten kapselt es in eine einfache <html> Shell, falls fehlt. Vorlagendateiname ist erforderlich (z.B. template.html).URLVon einem öffentlichen Link herunterladenURL der VorlagendateiDie PDF4me Ruft die Vorlage direkt ab. URL muss offen sein (keine Authentifizierung erforderlich) und Vorlagendateiname ist erforderlich, damit die Erweiterung zum Vorlagentyp passt.Optionen für Dokumentdatentypen
Wählen Sie das Datenformat aus, das Sie senden möchten.
/generate-documents-multiple-document-data-type.png)
Dokumentdatentyp. JSON oder XML (NEIN CSV bei diesem Vorgang)
JSONStandardwert: Array von Datensätzen (am häufigsten)[{"name":"Alice"}, {"name":"Bob"}]Der Knoten prüft, ob die Nutzdaten korrekt geparst werden. Ein einzelnes Objekt erzeugt ein Dokument. Übergeben Sie ein Array, wenn Sie mehrere Dokumente benötigen.XMLWiederholungsaufnahme XMLOptionen für den Dokumentdaten-Eingabetyp
Wählen Sie aus, wie die Massendaten in den Knoten gelangen.
/generate-documents-multiple-document-data-input-type.png)
Dokumentdaten-Eingabetyp: Text, Binärdaten. Base64 Zeichenkette oder URL
TextStandardmäßig werden Massendaten inline eingefügt.Dokumentdaten TextDieses Feld ist bei der Mehrfachauswahl zwingend erforderlich, wenn „Text“ ausgewählt ist (strenger als bei der Einzelauswahl).BinärdatenVerwenden Sie eine Datendatei von einem vorherigen Knoten.Dokument-Binär-Eigenschaft zum Namen des Binärfelds (Standardwert) DatenAchten Sie darauf, dass die Namen der Vorlagen- und Datenbinäreigenschaften nicht kollidieren, wenn beide vom selben Element stammen.Base64-ZeichenketteBase64-kodierte Datendatei.json oder .xml Datei als Base64 in Dokument Base64-InhaltDie Dokumentdatendateiname ist erforderlich.URLVon einem öffentlichen Link herunterladenURL der Dokumentdatendatei an eine Öffentlichkeit HTTPS URL der JSON oder XML Datendatei. Dokumentdatendateiname ist erforderlich, damit die Dateiendung zum Datentyp passt.Verhalten des Ausgabedateinamens
| Szenario | Name der Ausgabedatei | Generierte Dateinamen |
|---|---|---|
| One document returned | invoice | invoice.pdf (extension added if missing) |
| Many documents returned | invoice | invoice_1.pdf, invoice_2.pdf, invoice_3.pdf, ... |
| Many documents, name left empty | (empty) | API-provided names or generated_document_1, generated_document_2, ... |
Ausgabefelder
Ein erfolgreicher Lauf bringt eins zurück n8n Ein Element pro generiertem Dokument. Jedes Element enthält beides. JSON Metadaten und die Binärdatei.
| Feld | Typ | Was es enthält |
|---|---|---|
success | Boolean | True when the document was generated successfully. Use to route error handling branches. |
fileName | String | Filename of this generated document, e.g. invoice_2.pdf. Map into upload or email nodes. |
mimeType | String | MIME type of the output file, e.g. application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/html. |
fileSize | Number | Size of the generated file in bytes. |
documentIndex | Number | Index of this document within the batch (1-based). Useful for filenames or logging. |
totalDocuments | Number | How many documents were produced in this run. Same on every item. |
Binary (data) | Binary | The generated document under Binary Data Output Name (default data). Pass to Write Binary File, Email, or any cloud-storage upload. |
Wie richte ich die Option „Mehrere Dokumente generieren“ in n8n ein?
- Hinzufügen PDF4me zu Ihrem n8n Workflow. Festlegen Ressource Zu Erzeugen Und Operationen generieren Zu Dokumente generieren (mehrere)Die
- In Anmeldeinformationen zum Verbinden mit, wählen Sie Ihre PDF4me Anmeldeinformationen oder klicken Neue Anmeldeinformationen erstellen und fügen Sie Ihren ein API Schlüssel.
- Satz Vorlagendateityp Zu Wort (Standard), HTML, oder PDFDie
- Satz AusgabetypDie PDF, Word oder Excel für Word / PDF Vorlagen; HTML nur für HTML Vorlagen.
- Satz Eingabetyp der Vorlagendatei Zu Binärdaten (Standard), Base64 Zeichenkette, HTML Code (HTML nur), oder URL und füllen Sie das entsprechende Vorlagenfeld aus. Vorlagendateiname falls erforderlich.
- Satz Dokumentdatentyp Zu JSON (Standardeinstellung) oder XMLDie
- Satz Dokumentdaten-Eingabetyp Zu Text (Standardeinstellung) und fügen Sie Ihre ein JSON Array in Dokumentdaten Text. oder wählen Sie Binärdaten, Base64 Zeichenkette oder URL und die Datendatei bereitstellen.
- Satz Name der Ausgabedatei zu etwas Lesbarem wie
invoiceDie Dateien werden also zurückgeliefert alsinvoice_1.pdf,invoice_2.pdf, ... - Wenn Ausgabe PDF und Ihre Vorlage Formularfelder enthält, aktivieren Sie diese. Halten PDF BearbeitbarDie
- Verlassen Name der Binärdatenausgabe als
dataSofern ein nachgelagerter Knoten keinen anderen Eigenschaftsnamen benötigt, führen Sie den Knoten aus und leiten Sie die verschiedenen Ausgabeelemente an „In Stapeln aufteilen“, „Binärdatei schreiben“, „E-Mail“ oder „Cloud-Speicher-Upload“ weiter.
Typische Konfigurationen
Workflow-BeispieleCommon n8n workflow patterns using Generate Documents (Multiple).
- Ein Google Sheets-Knoten importiert eine Liste von Kunden mit Namen, Adresse und Kontostand in den Workflow.
- Ein Code- oder Set-Knoten verpackt die Zeilen in ein JSON Array von Objekten (ein Objekt pro Kunde).
- PDF4me Mehrere Durchläufe zum Generieren von Dokumenten mit der Vorlage Dateityp Word, Ausgabetyp PDFDie Vorlagendatei hat den Eingabetyp Binärdaten, die Dokumentdaten den Eingabetyp Text. Der Ausgabedateiname lautet:
KundenbriefDie - Der Knoten gibt einen Artikel pro Kunde zurück, der benannt ist
Kundenbrief_1.pdf,Kundenbrief_2.pdf, und so weiter. - Ein Schleifenknoten sendet jedes Element PDF an den entsprechenden Kunden per Gmail oder Upload auf Google Drive.
- Ein Knoten lädt die .docx-Vorlage herunter, ein anderer die .json-Kundendatei. Ein Merge-Knoten kombiniert die Dateien, sodass beide Binärdateien in einem Eintrag landen.
- PDF4me Die Funktion „Dokumente generieren (Mehrere)“ ist mit dem Eingabetyp „Binärdaten“ für Vorlagendateien konfiguriert.
Vorlage Binäre Eigenschaftauf den Vorlagenfeldnamen festgelegt) und Dokumentdaten-Eingabetyp Binärdaten (Dokument-Binär-Eigenschaft(auf den Namen des Datenfelds setzen). - Satz
Dokumentdatendateinamewenn die Datendatei nicht benannt istdata.jsonDie - Die generierten Dateien werden als separate Elemente zurückgegeben und in ein Verzeichnis geschrieben. SharePoint Dokumentenbibliothek, benannt nach der Kunden-ID.
- Ein nächtlicher Zeitplan-Trigger löst die Stapelverarbeitung der Rechnungen aus.
- PDF4me Die Option „Dokumente generieren (Mehrere)“ ist auf den Eingabetyp „Vorlagendatei“ eingestellt. URL (
URL der Vorlagendatei(verweist auf die .docx-Rechnungsvorlage auf S3) und Dokumentdaten-Eingabetyp URL (URL der Dokumentdatendateiverweist auf ein generiertesbilling-cycle.jsonDatei). VorlagendateinameIstRechnung.docxUndDokumentdatendateinameIstbilling-cycle.jsonDie- Ausgabetyp ist PDFDer Name der Ausgabedatei lautet:
Rechnungund behalten PDF Die Bearbeitungsfunktion ist deaktiviert. - Jeder zurückgesendete Artikel wird in den Ordner des Kunden in Dropbox hochgeladen und per Outlook-E-Mail versendet.
- Ein Webhook-Trigger wird ausgelöst, wenn eine Marketingkampagne startet.
- PDF4me Die Option „Dokumente generieren (Mehrere)“ ist auf den Dateityp „Vorlage“ eingestellt. HTML und Vorlagendatei-Eingabetyp HTML Code. der HTML wird direkt in den Knoten mit Schnurrbart-Platzhaltern eingefügt.
- Der Dokumentdatentyp ist JSONDer Dokumentdaten-Eingabetyp ist Text, und ein Ausdruck ordnet die Lead-Liste der Kampagne einem Text zu. JSON Array.
- Ausgabetyp ist HTMLDer Knoten gibt einen Wert zurück HTML Akte pro Lead.
- Ein Write Binary File-Knoten speichert jede generierte Datei. HTML in einen öffentlichen Webordner; ein anderer Knoten sendet den personalisierten Link an jeden Lead.
- Ein täglicher Zeitplan-Trigger ruft KPI-Zahlen aus PostgreSQL ab.
- Ein Set-Knoten gruppiert die Zeilen nach Region in eine JSON Array, ein Datensatz pro Region.
- PDF4me Mehrere Durchläufe zum Generieren von Dokumenten mit der Vorlage Dateityp Word, Ausgabetyp Excel, Dokumentdatentyp JSONDokumentdaten-Eingabetyp: Text. Ausgabedateiname:
RegionsberichtDie - Der Knoten gibt pro Region mit dem Namen eine .xlsx-Datei zurück.
region_report_1.xlsx,region_report_2.xlsx, und so weiter. - Ein Microsoft OneDrive-Knoten lädt jede Datei in den entsprechenden Regionsordner für das Analyseteam hoch.
Praktische Tipps
Spickzettel
| Feld | Wert |
|---|---|
| Resource | Generate |
| Operation | Generate Documents (Multiple) |
| Template File Type | Word |
| Output Type | PDF |
| Template File Input Type | Binary Data |
| Template Binary Property | data |
| Document Data Type | JSON |
| Document Data Input Type | Text |
| Document Data Text | (bulk JSON array with multiple records) |
| Output File Name | my_document (optional, becomes prefix) |
| Binary Data Output Name | data |
| Credentials | PDF4me API credential |
Häufig gestellte Fragen
Verwandte Aktionen
Dieselbe Aufgabe auf anderen Plattformen
POST /api/v2/GenerateDocumentMultiple Endpunkt. Für benutzerdefinierten Backend-Code oder Postman-Tests.