Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog
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

publipostage

Ce guide couvre

Ce guide vous accompagne tout au long du processus de fusion d'un Modèle de publipostage classique Word dans n8n en utilisant modèle_de_fusion_de_courrier_simple.docx et sample_mail_merge_data.jsonLe modèle utilise Word. MERGEFIELD espaces réservés (non <<[champ]>> ou moustache {{champ}}). Les données sont un JSON tableau avec un objet par destinataire. Pour générer un document (unique), utilisez une rangée dans le tableau. La sortie peut être PDF ou Word.

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​

Champs de fusion de publipostage Word
L'échantillon modèle_de_fusion_de_courrier_simple.docx a été créé avec la fonction de publipostage de Word (Insérer un champ de fusion). Les noms des champs sont : prénom, nom de famille, genre, et membreIls doivent correspondre JSON clés exactement.
JSON données de tableau
Utiliser sample_mail_merge_data.json (recommandé), test.xml, ou test.csvLes données de fusion et publipostage sont un tableau d'objetsPour un document, collez un tableau contenant un seul objet.
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.
Fusion et publipostage vs Modèle Word PDF4me

publipostage est destiné aux documents Word créés avec des champs de fusion classiques (MERGEFIELD). Modèle PDF4me Word utilise <<[fieldName]>> Syntaxe LINQ dans un contexte régulier .docxChoisissez le type qui correspond à la façon dont votre modèle a été conçu. Pour plusieurs destinataires dans un seul API appel, utiliser Générer des documents (multiples) plutôt.

Pack de fichiers d'exemple​

Téléchargez les quatre fichiers ci-dessous : un modèle de publipostage Word et trois formats de données équivalents.

Que contiennent les fichiers d'exemple ?​

Fusionner les champs dans simple_mail_merge_template.docx​

L'échantillon est simple lettre d'adhésion avec quatre champs de fusion classiques de Word :

Merge field nameTypical label in templateSample value (sample_mail_merge_data.json)
firstnameGiven nameJohn
lastnameFamily nameAdams
genderGenderFemale
memberMembership tierBasic
Comment inspecter les noms des champs de fusion

Dans Microsoft Word, appuyez sur Alt+F9 pour activer/désactiver les codes de champ. Les champs de fusion et publipostage apparaissent comme { MERGEFIELD prénom } codes de style. Le nom après MERGEFIELD doit correspondre à votre JSON clé.

Cartographie des champs dans tous les fichiers de données​

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

Contrairement au modèle Word de PDF4me, il n'y a pas <<[champ]>> étiquettes. Contrairement à HTMLIl n'y a pas de syntaxe Mustache. Le moteur lie JSON Clés pour les noms de champs de fusion Word un à un.

Aperçu du flux de travail​

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File
Étapen8n nœudBut
1Déclencheur manuelDémarrer le flux de travail à la demande
2Lire le fichier binaireCharges simple_mail_merge_template.docx en propriété binaire data
3PDF4me → Générer un document (unique)Fusionne le modèle + JSON tableau, sorties PDF ou Word
4Écrire un fichier binaire ou Envoyer un e-mail (facultatif)Enregistre ou envoie generated_document_output.pdf
Dans le nœud « Générer un document (unique) » de n8n PDF4me, le menu déroulant « Type de fichier modèle » affiche les options de fusion et publipostage : Word, HTML, Formulaire PDF et Google Docs.

Ensemble Type de fichier modèle à publipostage. Choisir PDF ou Word pour Type de sortie.

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

  1. Télécharger simple_mail_merge_template.docx et sample_mail_merge_data.json de la Pack de fichiers d'exemple au-dessus de.
  2. Enregistrez le modèle 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 publipostage, utilisez Données binaires, Base64 Chaîne, ou URL.

:::

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

Configurer le Lire le fichier binaire nœud :

ChampValeur
Chemin du fichierChemin complet vers votre fichier téléchargé simple_mail_merge_template.docx
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 simple_mail_merge_template.docx.

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

Paramètres principaux​

ChampValeurNotes
Identifiant pour se connecter avecTon PDF4me titreObtenir API clé
RessourceGenerate
Générer des opérationsGénérer un document (unique)
Type de fichier modèlepublipostageModèle de champ de fusion Word classique
Type de sortiePDF ou WordPDF pour le partage ; Word si le destinataire doit modifier le document fusionné

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

ChampValeur
Type de fichier modèleDonnées binaires
Propriété binaire du modèledata
Nom du fichier modèlesimple_mail_merge_template.docx

Données du document (coller le tableau JSON depuis sample_mail_merge_data.json)​

ChampValeur
Type de saisie de données du documentTexte
Type de données du documentJSON
Texte des données du documentCollez l'intégralité du contenu de sample_mail_merge_data.json (voir bloc ci-dessous)
[
  {
    "firstname": "John",
    "lastname": "Adams",
    "gender": "Female",
    "member": "Basic"
  }
]
Le JSON doit être un tableau

Les données de publipostage sont un JSON tableau, même pour un seul destinataire. Un objet du tableau produit un document fusionné avec Générer un document (unique).

Options de sortie​

ChampValeur
Garder PDF ModifiableDésactivé (par défaut) lorsque le type de sortie est PDF
Nom de la sortie de données binairesdata (défaut)

Étape 5 : Exécuter et vérifier le résultat​

  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 ou .docx).
  3. Vérifiez que les quatre champs de fusion sont bien renseignés :
    • prénom → Jean
    • nom de famille → Adams
    • genre → Femme
    • membre → Basique

Si un champ est vide, comparez votre JSON touches avec les noms MERGEFIELD dans le modèle Word (Alt+F9 dans Word).

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

Écrire un fichier binaire :

ChampValeur
Nom de fichiermail-merge-output.pdf
Nom de la propriété de donnéesdata
Chemin de sortieDossier cible sur votre n8n hôte

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

Formats de données alternatifs​

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

  1. Ajouter Lire le fichier binaire pour sample_mail_merge_data.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 à sample_mail_merge_data.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 mergeData) 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 de fusion et aux clés JSON.

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 de fusion.

Modèle de saisie alternatif : URL​

Hôte simple_mail_merge_template.docx dans un public HTTPS URL, puis définissez :

ChampValeur
Type de fichier modèleURL
URL du fichier modèleLien public vers simple_mail_merge_template.docx
Nom du fichier modèlesimple_mail_merge_template.docx

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 pour effectuer un publipostage en productionOnce the sample test works, replace the Manual Trigger with these patterns.
Google Sheets : convertir une ligne en lettre
  1. Les feuilles se déclenchent sur une nouvelle ligne.
  2. Code ou Ensemble Le nœud enveloppe la ligne dans un JSON tableau: [{"prénom": "...", ...}].
  3. PDF4me Fusion et publipostage avec correction modèle_de_fusion_de_courrier_simple.docx.
  4. Envoyer par e-mail le contenu fusionné PDF au destinataire.
Formulaire d'inscription au webhook
  1. Le webhook reçoit la charge utile du formulaire.
  2. Associer les champs du corps aux clés de fusion (prénom, nom de famille, etc.).
  3. Construire un objet à un seul élément JSON tableau pour le texte des données du document.
  4. Stockez ou envoyez par courriel le résultat PDF.
Fusion en masse (plusieurs destinataires)
  1. Exporter les contacts en tant que JSON tableau (un objet par personne).
  2. Passer à Générer des documents (multiples) pour un PDF par rangée.
  3. Conservez l'option Générer un document (unique) lorsque vous n'avez besoin que d'un seul fichier fusionné par exécution.

Foire aux questions​

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.

Guides associés​

Back to overviewGenerate Documents (Multiple)