Google Docs
Ce guide couvre
Ce guide vous accompagne tout au long du processus de fusion d'un Google Docs exporté .docx modèle dans n8n en utilisant google-docs-template.docx et google-docs-data.jsonLe modèle utilise emplacements réservés pour les moustaches ({{nom}}, {{cours}}, etc.). Les données sont un JSON tableau avec un objet par ligne. Pour Générer un document (unique), utilisez un objet dans le tableau. La sortie peut être PDF ou Word.
Avant de commencer
google-docs-template.docx est un certificat de cours avec {{nom}}, {{cours}}, {{date}}, et {{instructeur}}.google-docs-data.json (recommandé), test.xml, ou test.csvComme la fusion et le publipostage, Google Docs les données sont un tableau d'objetsPour un certificat, collez un tableau contenant un seul objet.Google Docs est pour .docx fichiers exportés depuis Google Docs avec moustache {{champ}} espaces réservés. PDF4me Word Modèle utilise <<[fieldName]>> Syntaxe LINQ. publipostage utilise des classiques Word Codes MERGEFIELD. Choisissez le type correspondant à la structure de votre modèle.
Pack de fichiers d'exemple
Téléchargez les quatre fichiers ci-dessous. Un fichier exporté Google Docs modèle plus trois formats de données équivalents.
Que contiennent les fichiers d'exemple ?
Espaces réservés dans google-docs-template.docx
L'échantillon est un certificat de réussite du cours avec quatre champs de fusion Mustache :
| Mustache placeholder | Certificate label in template | Sample value (google-docs-data.json) |
|---|---|---|
{{name}} | Participant name | Alice Johnson |
{{course}} | Course title | Intro to Automation |
{{date}} | Completion date | 2026-03-10 |
{{instructor}} | Instructor name | Mr. Smith |
Saisissez directement les espaces réservés dans Google Docs par exemple, en texte brut {{nom}}Après l'exportation vers .docx, PDF4me remplace chaque étiquette par l'étiquette correspondante JSON clé. C'est le même style de moustache que HTML des modèles, mais le format de fichier est Word, pas HTML.
Cartographie des champs dans tous les fichiers de données
| Placeholder | JSON key (google-docs-data.json) | XML element (test.xml) | CSV column (test.csv) | Sample value |
|---|---|---|---|---|
{{name}} | name | name | name | Alice Johnson |
{{course}} | course | course | course | Intro to Automation |
{{date}} | date | date | date | 2026-03-10 |
{{instructor}} | instructor | instructor | instructor | Mr. Smith |
Contrairement à PDF4me Word Modèle, il n'y en a pas <<[champ]>> balises. Contrairement au publipostage, il n'y a pas de codes MERGEFIELD. Clés dans votre JSON Les objets de tableau sont mappés sur {{champ}} espaces réservés un à un.
Aperçu du flux de travail
Manual Trigger → Read Binary File (google-docs-template.docx) → PDF4me Generate Document (Single) → (optional) Write Binary File
| Étape | nœud n8n | But |
|---|---|---|
| 1 | Déclencheur manuel | Démarrer le flux de travail à la demande |
| 2 | Lire le fichier binaire | Charges google-docs-template.docx en propriété binaire data |
| 3 | PDF4me → 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 |
/generate-document-single-template-file-type.png "Cliquez pour agrandir")
Ensemble Type de fichier modèle à Google Docs. Choisir PDF ou Word pour Type de sortie.
Étape 1 : Téléchargez et placez les fichiers d’exemple
- Télécharger
google-docs-template.docxetgoogle-docs-data.jsonde la Pack de fichiers d'exemple au-dessus de. - 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).
- Téléchargement facultatif
test.xmloutest.csvpour tester d'autres types de données.
Pour utiliser votre propre document Google : ouvrez-le dans Google Docs, choisir Fichier → Télécharger → Microsoft Word (.docx)et utilisez ce fichier comme modèle.
Étape 2 : Créer le n8n Flux de travail
- Dans n8n, créez un nouveau flux de travail.
- Ajouter un Déclencheur manuel nœud.
- Ajouter un Lire le fichier binaire nœud après le déclencheur.
- Ajouter PDF4me → Générer un document (unique) après la lecture du fichier binaire.
- 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 HTML. Pour Google Docs, utiliser Binary Data, Base64 Chaîne, ou URL.
:::
Étape 3 : Charger le modèle (Read Binary File)
Configurer le Lire le fichier binaire nœud :
| Champ | Valeur |
|---|---|
| Chemin du fichier | Chemin complet vers votre fichier téléchargé google-docs-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 google-docs-template.docx.
É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 | Google Docs | Exporté Google Docs .docx avec des étiquettes de moustache |
| Type de sortie | PDF ou Word | PDF pour le partage ; Word si le destinataire doit modifier le document fusionné |
Modèle d'entrée (à partir de la lecture du fichier binaire)
| Champ | Valeur |
|---|---|
| Type de fichier modèle | Binary Data |
| Propriété binaire du modèle | data |
| Nom du fichier modèle | google-docs-template.docx |
Données du document (coller le tableau JSON depuis google-docs-data.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 google-docs-data.json (voir bloc ci-dessous) |
[
{
"name": "Alice Johnson",
"course": "Intro to Automation",
"date": "2026-03-10",
"instructor": "Mr. Smith"
}
]
Google Docs Les données du modèle sont un JSON tableau, même pour un seul certificat. Un objet du tableau produit un document fusionné avec Générer un document (unique).
Options de sortie
| Champ | Valeur |
|---|---|
| Conserver le PDF modifiable | Désactivé (par défaut) lorsque le type de sortie est PDF |
| Nom de la sortie de données binaires | data (défaut) |
Étape 5 : Exécuter et vérifier le résultat
- Cliquez Exécuter le flux de travail.
- Ouvrez le PDF4me Sortie du nœud. Sous Binaire, propriété ouverte
data(generated_document_output.pdfou.docx). - Vérifiez que les quatre champs sont remplis :
- nom → Alice Johnson
- cours → Introduction à l'automatisation
- date → 10/03/2026
- instructeur → M. Smith
Si un champ est vide, comparez votre JSON clés avec les balises moustache dans les fichiers exportés .docx personnage par personnage.
Étape 6 : Enregistrer ou envoyer le résultat (facultatif)
Écrire un fichier binaire :
| Champ | Valeur |
|---|---|
| Nom de fichier | certificate-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 ou Word pièce jointe.
Formats de données alternatifs
Option A : Fichier JSON au format binaire (google-docs-data.json)
- Ajouter Lire le fichier binaire pour
google-docs-data.json(utiliser un Fusionner nœud si le modèle et les données partagent l'élément de flux de travail). - Ensemble Type de saisie de données du document à Binary Data, 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 à
google-docs-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 rowData) 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 collez un enregistrement (le fichier d'exemple en contient deux ; utilisez le premier pour une seule exécution) :
<?xml version="1.0" encoding="UTF-8"?>
<Records>
<Record>
<name>Alice Johnson</name>
<course>Intro to Automation</course>
<date>2026-03-10</date>
<instructor>Mr. Smith</instructor>
</Record>
</Records>
Les noms des éléments correspondent aux clés de la moustache et JSON propriété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) :
name,course,date,instructor
"Alice Johnson","Intro to Automation","2026-03-10","Mr. Smith"
Les en-têtes de colonnes correspondent directement aux noms des espaces réservés aux moustaches.
Modèle de saisie alternatif : URL
Hôte google-docs-template.docx dans un public HTTPS URL, puis définissez :
| Champ | Valeur |
|---|---|
| Type de fichier modèle | URL |
| URL du fichier modèle | Lien public vers google-docs-template.docx |
| Nom du fichier modèle | google-docs-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 de génération de documents à partir de modèles Google Docs en productionOnce the sample test works, replace the Manual Trigger with these patterns.
- Les feuilles se déclenchent lors de la création d'une nouvelle ligne de fin.
- Code Le nœud enveloppe la ligne dans un JSON tableau:
[{"name": "...", "course": "...", ...}]. - PDF4me Google Docs avec fixe
google-docs-template.docxà partir de binaire ou URL. - Envoyer par e-mail le contenu fusionné PDF au participant.
- Nouveau JSON Le fichier est déposé dans un dossier surveillé.
- Charger le fixe Google Docs modèle du même dossier ou un URL.
- Transmettre le contenu du fichier en tant que données de document (Binary Data ou du texte).
- Téléverser la sortie PDF vers un dossier de sortie. Voir la section Zapier blog déclencheur pour un modèle similaire.
- Les participants à l'exportation en tant que JSON tableau (un objet par personne).
- Passer à Générer des documents (multiples) pour un PDF par rangée.
- 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
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
- PDF4me Word Modèle:
<<[fieldName]>>syntaxe au lieu de moustache - publipostage: classique Word Modèles MERGEFIELD
- Générer des documents (multiples): un fichier de sortie par ligne dans votre JSON tableau
- Google Docs flux de travail (Make): flux manuel en quatre étapes Make