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

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

PDF-Formular

Was dieser Leitfaden umfasst

Diese Anleitung führt Sie durch das Ausfüllen eines PDF AcroForm-Vorlage In n8n Verwendung template.pdf Und formdata.jsonDatenschlüsselzuordnung direkt zu Formularfeldnamen (Vorname, NachnameAusgabe ist PDF nur. Verwenden Halten PDF Bearbeitbar Die Felder können nach dem Ausfüllen weiterhin bearbeitbar bleiben. Alternativ kann diese Funktion deaktiviert werden, um das Formular zu vereinfachen.

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​

PDF mit AcroForm-Feldern
Das Muster template.pdf ist ein Mitgliedschaftsformular mit vier Feldern. JSON Die Schlüssel müssen übereinstimmen interner AcroForm-Name, nicht die sichtbare Beschriftung auf dem Bildschirm. Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden.
Flaches Datenobjekt
Verwenden formdata.json (empfohlen), test.xml, oder test.csvAlle drei liefern dieselben vier Werte. PDF-Formulardaten sind ein einzelnes flaches Objektnicht verschachtelt wie die HTML Rechnungsbeispiel.
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: PDF-Formular vs. Ausfüllen eines PDF-Formulars

Ein PDF-Formular ausfüllen Dokument generieren (Einzeln) mit PDF-Formular verwendet die Engine zum Generieren von Vorlagen mit einem PDF Formular als Vorlage verwenden. Zum Ausfüllen vorhandener Formulare PDF AcroForm ohne den Generierungs-Workflow, siehe Füllen Sie ein PDF BildenUm Feldnamen auf einem unbekannten System zu ermitteln PDF, laufen Formulardaten extrahieren PDF Zuerst auf der Vorlage.

:::

Beispieldateipaket​

Laden Sie alle vier Dateien unten herunter. PDF Formularvorlage plus drei gleichwertige Datenformate.

Was ist in den Beispieldateien enthalten?​

Formularfelder in template.pdf​

Das PDF-Beispiel ist ein einfaches Mitgliedschafts-/RegistrierungsformularJeder Feldname in AcroForm ist einem Schlüssel in Ihren Daten zugeordnet:

AcroForm-FeldnameTypische Verwendung in der VorlageBeispielwert (formdata.json)
firstnameVornameJohn
lastnameNachnameAdams
genderGeschlechtsauswahlWeiblich
memberMitgliedschaftsstufeBasic

:::Tipp Feldnamen vs. sichtbare Beschriftungen AcroForm-Namen sind oft kleingeschrieben und enthalten keine Leerzeichen (firstname), selbst wenn die PDF zeigt "Vorname" an. Wenn ein Wert leer erscheint, ist der Schlüssel in Ihrem JSON Stimmt fast nie mit dem internen Feldnamen überein. Verwenden Sie Formulardaten extrahieren PDF Um die genauen Namen aus Ihrer eigenen Vorlage aufzulisten.

:::

Feldzuordnung über alle Datendateien hinweg​

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

Im Gegensatz zu Word oder HTML Vorlagen gibt es keine Schnurrbart-PlatzhalterDer Motor passt Datenschlüssel zu AcroForm-Feldnamen eins zu eins.

Der Arbeitsablauf im Überblick​

Manual Trigger  →  Read Binary File (template.pdf)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Schrittn8n KnotenZweck
1Manueller AuslöserStarten Sie den Workflow bei Bedarf
2Binärdatei lesenLasten template.pdf in binäre Eigenschaften data
3PDF4me → Dokument generieren (Einzeln)Füllt AcroForm-Felder aus JSON/XML/CSV, Ausgaben PDF
4Binärdatei schreiben oder E-Mail senden (optional)Speichert oder sendet generated_document_output.pdf
Im Dropdown-Menü „Vorlagendateityp“ des Knotens „Dokument generieren (Einzeln)“ in n8n PDF4me wird neben den Optionen „Word“, „HTML“, „Seriendruck“ und „Google Docs“ auch die Option „PDF-Formular“ angezeigt.

Satz Vorlagendateityp Zu PDF-FormularDie Ausgabetyp Ist PDF nur für diesen Vorlagentyp.

Schritt 1: Beispieldateien herunterladen und platzieren​

  1. Herunterladen template.pdf Und formdata.json von Beispieldateipaket über.
  2. Speichern template.pdf 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 das PDF-Formular verwenden Sie Binärdaten, Base64 Zeichenkette, oder URL.

:::

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

FeldWert
DateipfadVollständiger Pfad zu Ihrer heruntergeladenen Datei template.pdf
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 template.pdfDie

Schritt 4: Konfigurieren PDF4me Dokument generieren (Einzeln)​

Kerneinstellungen​

FeldWertAnmerkungen
Anmeldeinformationen zum Verbinden mitDein PDF4me BerechtigungErhalten API Schlüssel
RessourceGenerate
Operationen generierenDokument generieren (Einzeln)
VorlagendateitypPDF-FormularPDF mit AcroForm-Feldern
AusgabetypPDFNur Option für PDF-Formular

Vorlageneingabe (aus „Binärdatei lesen“)​

FeldWert
Eingabetyp der VorlagendateiBinärdaten
Vorlage Binäre Eigenschaftdata
Vorlagendateinametemplate.pdf

Dokumentdaten (JSON einfügen von formdata.json)​

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

Ausgabeoptionen​

FeldWertWann verwenden?
Halten PDF BearbeitbarAnDer Empfänger sollte die Felder im ausgefüllten Dokument weiterhin bearbeiten. PDF
Halten PDF BearbeitbarAus (Standard)Formularfelder in statischen Inhalt umwandeln
Name der Binärdatenausgabedata (Standard)Binäre Eigenschaft für die Ausgabe PDF

Schritt 5: Ausführen und Überprüfen PDF​

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

Wenn ein Feld leer ist, vergleichen Sie Ihre JSON Schlüssel mit den AcroForm-Namen in template.pdf Charakter für Charakter.

Schritt 6: Ausgabe speichern oder senden (optional)​

Binärdatei schreiben:

FeldWert
Dateinamefilled-form-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 Anhang.

Alternative Datenformate​

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

  1. Hinzufügen Binärdatei lesen für formdata.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 formdata.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 formData) 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 Feldnamen des AcroForms und JSON Schlüssel.

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 Feldnamen des AcroForms.

Alternative Vorlageneingabe: URL​

Gastgeber template.pdf bei einer öffentlichen HTTPS URLdann einstellen:

FeldWert
Eingabetyp der VorlagendateiURL
URL der VorlagendateiÖffentlicher Link zu template.pdf
Vorlagendateinametemplate.pdf

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üllen von PDF-Formularen in der ProduktionOnce the sample test works, replace the Manual Trigger with these patterns.
Webhook-Formularübermittlung
  1. Webhook empfängt Registrierungsnutzdaten.
  2. Ordnen Sie die Body-Felder den folgenden Feldern zu: JSON Schlüssel, die mit AcroForm-Namen übereinstimmen.
  3. PDF4me Füllen fixiert template.pdf aus Binär- oder URLDie
  4. Senden Sie die ausgefüllte Datei per E-Mail oder speichern Sie sie. PDFDie
Google Sheets Zeile zu PDF
  1. Die Tabellen werden bei einer neuen Zeile ausgelöst.
  2. Satz oder Code Node-Builds {"firstname": "...", ...}Die
  3. PDF4me Dokument (Einzeln) mit PDF-Formularvorlage erstellen.
  4. Ausgabe in Drive hochladen oder SharePointDie
CRM Kontakt zur Mitgliedschaft PDF
  1. HubSpot-/Salesforce-Trigger bei neuem Kontakt.
  2. Karte CRM Eigenschaften zu Vorname, Nachname, usw.
  3. Satz Halten PDF Bearbeitbar Zum Glätten vor der Archivierung.

Häufig gestellte Fragen​

How is Pdf Form different from Fill a PDF Form?+
Generate Document (Single) with Pdf Form is part of the generate template workflow (same node as Word and HTML). Fill a PDF Form is a dedicated Forms operation for any PDF with AcroForm fields. Both map keys to field names; choose Generate when Pdf Form is your Template File Type in a generate pipeline.
Why are some fields blank in the output?+
JSON keys must match AcroForm field names exactly, including case. firstname works; FirstName or first_name usually does not. Run Extract Form Data From PDF on template.pdf to list internal names before mapping CRM or webhook data.
Should I turn Keep PDF Editable on or off?+
On: fields remain editable (useful for review workflows). Off: fields are flattened into static text (better for final archival or when recipients should not change values). Default is Off.
Can Pdf Form output Word or HTML?+
No. When Template File Type is Pdf Form, Output Type is PDF only.
JSON vs XML vs CSV: which should I use?+
JSON is simplest for n8n expressions and webhooks. XML and CSV in the sample pack use the same four keys. All formats map one value per AcroForm field name.

Verwandte Leitfäden​

Back to overviewFill a PDF Form