←Générer un document (unique)

Retour au guide principal : tous les types de modèles, les paramètres de nœuds et les champs de sortie

Formulaire PDF

Ce guide couvre

Ce guide vous accompagne dans le remplissage d'un formulaire. PDF Modèle AcroForm dans n8n en utilisant modèle.pdf et formdata.jsonCarte des clés de données directement aux noms de champs de formulaire (prénom, nom de famille, etc.). Le résultat est PDF seulement. Utiliser Garder PDF Modifiable pour laisser les champs modifiables après remplissage, ou désactiver cette option pour aplatir le formulaire.

Articles de blog connexes

Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.

En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.

Consultez le blog →

Avant de commencer

PDF avec les champs AcroForm

L'échantillon modèle.pdf est un formulaire d'adhésion comportant quatre champs. JSON Les clés doivent correspondre Nom interne d'AcroForm, et non l'étiquette visible à l'écran. Les noms sont sensibles à la casse.

objet de données plat

Utiliser formdata.json (recommandé), test.xml, ou test.csvLes trois fournissent les mêmes quatre valeurs. Les données du formulaire PDF sont un objet plat unique, non imbriqués comme le HTML Exemple de facture.

PDF4me diplôme en n8n

Créer un PDF4me diplôme en n8n et collez votre API clé. La même clé fonctionne pour tout PDF4me nœuds dans votre instance.

→ Obtenez votre API clé

Remarque : Formulaire PDF vs Remplir un formulaire PDF Générer un document (unique) avec Formulaire PDF utilise le moteur de génération de modèles avec un PDF formulaire comme modèle. Pour remplir tout formulaire existant PDF AcroForm sans le flux de travail de génération, voir Remplissez un PDF FormulairePour découvrir les noms de champs sur un système inconnu PDF, courir Extraire les données du formulaire PDF d'abord sur le modèle.

:::

Pack de fichiers d'exemple

Téléchargez les quatre fichiers ci-dessous. Un PDF Modèle de formulaire plus trois formats de données équivalents.

modèle.pdf

PDF Modèle AcroForm (4 champs)

formdata.json

Plat JSON indexé par nom de champ (recommandé)

test.xml

Mêmes valeurs de formulaire que XML

test.csv

Mêmes valeurs de formulaire que CSV (une rangée)

Que contiennent les fichiers d'exemple ?

Champs de formulaire dans template.pdf

L'exemple de PDF est simple formulaire d'adhésion/d'inscriptionChaque nom de champ AcroForm correspond à une clé dans vos données :

Nom du champ AcroForm	Utilisation typique dans le modèle	Valeur de l'échantillon (formdata.json)
firstname	Prénom	John
lastname	Nom de famille	Adams
gender	Sélection du sexe	Femelle
member	Niveau d'adhésion	Basique

Noms de champs vs étiquettes visibles

Les noms AcroForm sont souvent en minuscules sans espaces (firstname), même lorsque le PDF affiche « Prénom ». Si une valeur apparaît vide, la clé dans votre JSON ne correspond presque jamais au nom du champ interne. Utilisez Extraire les données du formulaire PDF pour lister les noms exacts à partir de votre propre modèle.

Cartographie des champs dans tous les fichiers de données

AcroForm field	JSON key (formdata.json)	XML element (test.xml)	CSV column (test.csv)	Sample value
firstname	firstname	firstname	firstname	John
lastname	lastname	lastname	lastname	Adams
gender	gender	gender	gender	Female
member	member	member	member	Basic

Contrairement à Word ou HTML modèles, il y a pas de placeholders pour les moustachesLe moteur correspond clés de données correspondant aux noms de champs AcroForm un à un.

Aperçu du flux de travail

Manual Trigger  →  Read Binary File (template.pdf)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

Étape	n8n nœud	But
1	Déclencheur manuel	Démarrer le flux de travail à la demande
2	Lire le fichier binaire	Charges template.pdf en propriété binaire data
3	PDF4me → Générer un document (unique)	Remplit les champs AcroForm à partir de JSON/XML/CSV, sorties PDF
4	Écrire un fichier binaire ou Envoyer un e-mail (facultatif)	Enregistre ou envoie generated_document_output.pdf

Ensemble Type de fichier modèle à Formulaire PDF. Type de sortie est PDF uniquement pour ce type de modèle.

---

Étape 1 : Téléchargez et placez les fichiers d’exemple

1. Télécharger template.pdf et formdata.json de la Pack de fichiers d'exemple au-dessus de.
2. Sauvegarder template.pdf quelque part n8n peut le lire (chemin local sur un serveur auto-hébergé ou stockage cloud pour les déclencheurs de production).
3. Téléchargement facultatif test.xml ou test.csv pour tester d'autres types de données.

---

Étape 2 : Créer le n8n Flux de travail

1. Dans n8n, créez un nouveau flux de travail.
2. Ajouter un Déclencheur manuel nœud.
3. Ajouter un Lire le fichier binaire nœud après le déclencheur.
4. Ajouter PDF4me → Générer un document (unique) après la lecture du fichier binaire.
5. Connectez votre PDF4me titre.

Attention : le code HTML n'est pas valide ici. Type d'entrée de fichier modèle : HTML Code ne fonctionne que lorsque Type de fichier modèle est HTMLPour le formulaire PDF, utilisez Données binaires, Base64 Chaîne, ou URL.

:::

---

Étape 3 : Charger le modèle PDF (Read Binary File)

Champ	Valeur
Chemin du fichier	Chemin complet vers votre fichier téléchargé template.pdf
Nom de la propriété	data (par défaut ; utilisé comme Propriété binaire du modèle dans PDF4me)

Exécutez ce nœud une fois et vérifiez que l'élément de sortie est binaire. data avec nom de fichier template.pdf.

---

Étape 4 : Configurer PDF4me Générer un document (unique)

Paramètres principaux

Champ	Valeur	Notes
Identifiant pour se connecter avec	Ton PDF4me titre	Obtenir API clé
Ressource	Generate
Générer des opérations	Générer un document (unique)
Type de fichier modèle	Formulaire PDF	PDF avec les champs AcroForm
Type de sortie	PDF	Seule option disponible pour le formulaire PDF

Modèle d'entrée (à partir de la lecture du fichier binaire)

Champ	Valeur
Type de fichier modèle	Données binaires
Propriété binaire du modèle	data
Nom du fichier modèle	template.pdf

Données du document (coller le JSON depuis formdata.json)

Champ	Valeur
Type de saisie de données du document	Texte
Type de données du document	JSON
Texte des données du document	Collez l'intégralité du contenu de formdata.json (voir bloc ci-dessous)

{
  "firstname": "John",
  "lastname": "Adams",
  "gender": "Female",
  "member": "Basic"
}

Options de sortie

Champ	Valeur	Quand utiliser
Garder PDF Modifiable	Sur	Le destinataire doit encore modifier les champs du formulaire rempli. PDF
Garder PDF Modifiable	Désactivé (défaut)	Transformer les champs de formulaire en contenu statique
Nom de la sortie de données binaires	data (défaut)	Propriété binaire de la sortie PDF

---

Étape 5 : Exécuter et vérifier PDF

1. Cliquez Exécuter le flux de travail.
2. Ouvrez le PDF4me Sortie du nœud. Sous Binaire, propriété ouverte data (generated_document_output.pdf).
3. Veuillez vérifier que les quatre champs sont remplis :
   • prénom → Jean
   • nom de famille → Adams
   • genre → Femme
   • membre → Basique

Si un champ est vide, comparez votre JSON clés avec les noms AcroForm dans template.pdf personnage par personnage.

---

Étape 6 : Enregistrer ou envoyer le résultat (facultatif)

Écrire un fichier binaire :

Champ	Valeur
Nom de fichier	filled-form-output.pdf
Nom de la propriété de données	data
Chemin de sortie	Dossier cible sur votre n8n hôte

Envoyer un courriel : attacher le binaire data depuis PDF4me comme le PDF pièce jointe.

---

Formats de données alternatifs

Option A : JSON fichier en tant que binaire (formdata.json)

1. Ajouter Lire le fichier binaire pour formdata.json (utiliser un Fusionner nœud si le modèle et les données partagent l'élément de flux de travail).
2. Ensemble Type de saisie de données du document à Données binaires, Type de données du document à JSON, Propriété binaire du document à votre champ de données, Nom du fichier de données du document à formdata.json.

Attention : conflit de noms de propriétés binaires

Si le modèle et les données utilisent tous deux la même propriété data, l'un écrase l'autre. Utilisez des noms distincts (par exemple, template et formData) ou fusionner les éléments de deux nœuds de lecture de fichier binaire.

:::

Option B : XML (test.xml)

Ensemble Type de données du document à XML et coller :

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

Les noms des éléments correspondent aux noms des champs AcroForm et JSON clés.

Option C : CSV (test.csv)

Ensemble Type de données du document à CSV et coller (ligne d'en-tête + une ligne de données) :

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

Les en-têtes de colonnes correspondent directement aux noms des champs AcroForm.

---

Modèle de saisie alternatif : URL

Hôte template.pdf dans un public HTTPS URL, puis définissez :

Champ	Valeur
Type de fichier modèle	URL
URL du fichier modèle	Lien public vers template.pdf
Nom du fichier modèle	template.pdf

Aucun nœud de lecture de fichier binaire n'est requis. Les données peuvent toujours être collées comme Texte des données du document ou chargé à partir d'un URL.

---

Modèles de flux de production

Méthodes courantes de remplissage des formulaires PDF en productionOnce the sample test works, replace the Manual Trigger with these patterns.

soumission de formulaire Webhook

1. Le webhook reçoit la charge utile d'enregistrement.
2. Les champs du corps de la carte JSON clés correspondant aux noms AcroForm.
3. PDF4me remplit fixe modèle.pdf à partir de binaire ou URL.
4. Envoyez par courriel ou enregistrez le formulaire rempli PDF.

Ligne Google Sheets à PDF

1. Les feuilles se déclenchent sur une nouvelle ligne.
2. Ensemble ou Code constructions de nœuds {"prénom": "...", ...}.
3. PDF4me Générer un document (unique) avec un modèle de formulaire PDF.
4. Téléverser le résultat sur Drive ou SharePoint.

CRM contact pour l'adhésion PDF

1. Déclencheur HubSpot / Salesforce lors de la création d'un nouveau contact.
2. Carte CRM propriétés à prénom, nom de famille, etc.
3. Ensemble Garder PDF Modifiable Je vais les aplatir avant de les archiver.

Foire aux questions

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.

Guides associés

• Aperçu de la génération de documents (unique): tous les paramètres, champs de sortie et types de modèles
• Remplissez un PDF Formulaire: remplissage AcroForm dédié sans moteur de génération de modèles
• Extraire les données du formulaire PDF: lister les noms de champs de n'importe quel PDF formulaire

Back to overviewFill a PDF Form