Aller au contenu principal

Générer des documents dans Make

PDF4me Générer des documents est un Make module qui fusionne JSON ou XML des données dans un Word ou HTML modèle et renvoie un produit fini PDF, Word, ou Excel fichier. Placer {{fieldName}} Dans votre modèle, insérez des espaces réservés, fournissez des données clé-valeur correspondantes, et le module effectuera la substitution côté serveur. Il s'agit de l'ancien module de génération de documents ; pour les nouveaux scénarios avec une logique conditionnelle complexe, utilisez plutôt « Générer un document unique ».

Que fait ce module ?

PDF4meGénérer des documents fusions JSON ou XML des données dans un Word ou HTML modèle et renvoie le résultat comme un produit fini PDF, Word document, ou Excel fichier, prêt à être envoyé par courriel, stocké ou traité ultérieurement. Placer {{fieldName}} Dans votre modèle, insérez des espaces réservés, fournissez des données clé-valeur correspondantes, et le module effectue la substitution entièrement côté serveur. module de génération de documents héritésPour les nouveaux scénarios comportant une logique conditionnelle complexe ou des structures de boucle, utilisez Générer un document unique au contraire, ce qui prend en charge l'intégralité PDF4me LINQ Syntaxe du modèle.

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

Authentification de votre API Demande

Chaque PDF4me module dans Make nécessite un numéro valide ConnexionCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au scénario d'authentifier de manière sécurisée les demandes de génération de documents.

Informations importantes à ne pas manquer

Le nom du modèle correspond au nom du fichier, et non à l'identifiant d'un modèle de tableau de bord.
Le Nom du modèle ce champ attend le nom du fichier modèle (par exemple, modèle_de_facture.docx), mappé à partir du nom de fichier généré lors de votre étape de téléchargement Dropbox, Google Drive ou OneDrive. Il ne s'agit pas d'un ID de modèle provenant de PDF4me tableau de bord, le fichier binaire du modèle proprement dit est fourni séparément via Fichier de données du document.
Les données peuvent être du texte ou un fichier, les deux fonctionnent
Vous pouvez fournir des données de fusion de deux manières : coller ou mapper un JSON/XML chaîne directement dans Texte des données du document (idéal pour les petites charges utiles construites à partir des sorties de modules précédents), ou mapper un binaire JSON/XML fichier d'un module de stockage vers Fichier de données du document (Préférable pour les fichiers de données volumineux ou gérés en externe). Si les deux champs sont renseignés, le fichier renseigné est prioritaire.
Pour plusieurs enregistrements, utilisez plutôt Générer plusieurs documents
La fonction Générer des documents produit un seul document de sortie par exécution. Si vos données contiennent un tableau d'enregistrements (par exemple, 50 enregistrements de factures) et que vous avez besoin d'un document par enregistrement, utilisez Générer plusieurs documentsIl parcourt le tableau et renvoie un fichier ZIP contenant tous les fichiers générés en un seul appel de module, éliminant ainsi le besoin d'une boucle d'itération.
Le module « Générer des documents » de PDF4me affiche la connexion définie sur testuser01@pdf4me.com, le type de fichier modèle sélectionné dans la liste déroulante, le type de sortie également sélectionné, le fichier défini sur « Map » avec le nom du modèle mappé depuis 7. Nom du fichier et le fichier de données du document mappé depuis 7. Données, le type de données du document défini sur JSON, le champ « Texte » avec un exemple de tableau JSON et le champ « Métadonnées JSON ».

Ensemble Type de fichier modèle et Type de sortie d'abord, puis le fil Nom du modèle et Fichier de données du document à partir de l'étape qui a téléchargé le modèle. Fournir les données de fusion via Texte des données du document ou Fichier de données du document.

Paramètres

Requis: Connexion, Type de fichier modèle, Type de sortie, Nom du modèle, et Type de données de document. Ensemble Déposer à Carte premier à révéler le nom du modèle et le fichier de données du document.

ParamètreRequisCe que cela faitExemple
ConnectionRequiredPDF4me API connection. Click Add and paste your API key to create one.[email protected]
Template File TypeRequiredFormat of the template file. Options: Word (DOCX) or html. Has a Map toggle for dynamic scenarios. Hint: "Select Template file type."Word
Output TypeRequiredFormat of the generated output. Options: Pdf, Word, or Excel. Has a Map toggle. Choose based on the recipient's needs.Pdf
FileConditionalHow the template is supplied. Choose Map to wire Template Name and Document Data File from a prior module. Choose Dropbox, Download a File for a direct Dropbox trigger.Map
Template NameRequiredFilename of the template including extension (e.g. invoice_template.docx). Hint: "Template file name." Map from the File Name output of your download step.7. File Name
Document Data FileConditionalBinary content of a JSON or XML data file from a storage module. Hint: "Map source document file content from the previous action." If both this and Document Data Text are supplied, this file takes precedence.7. Data
Document DataTypeRequiredFormat of the data source. Options: Json or Xml. Has a Map toggle. Hint: "Choose Document Data Type."Json
Document Data TextConditionalJSON or XML data as a text string: paste a literal payload or map from a prior module output. Hint: "Input Data text to generate document." Example: [{"name":"John"},{"name":"Jane"}][{"name":"John"}]
Meta Data JsonConditionalOptional JSON for field formatting. Use FieldType 2 for date fields, FieldType 0 for checkboxes, FieldType 1 for HTML content. Hint: "MetaData for Fields."{"FieldsMetaData":[...]}

Champs de sortie

ChampTaperCe qu'il contient
NameStringFilename of the generated document. Map into the file name field of your storage upload or email step.
Doc DataBufferBinary content of the generated PDF, Word, or Excel file. Wire directly into a Create file action in SharePoint, Google Drive, Dropbox, or OneDrive, or attach it to a Gmail send action.

Comment configurer la génération de documents dans Make

  1. Ajouter PDF4meGénérer des documents à votre Make scénario.
  2. Sélectionner Connexion (ou cliquez Ajouter pour en créer un avec votre API clé).
  3. Ensemble Type de fichier modèle à Word ou du HTML pour correspondre au format de votre modèle.
  4. Ensemble Type de sortie vers PDF, Word, ou Excel pour obtenir le résultat souhaité.
  5. Ensemble Déposer à Carte, puis câble Nom du modèle au nom de fichier de sortie et Fichier de données du document au contenu binaire de votre étape de téléchargement de modèle.
  6. Ensemble Type de données de document au format JSON ou XML. Saisissez ou mappez vos données dans Texte des données du document, ou laissez ce champ vide si les données sont déjà transmises via un fichier de données de document.
  7. Sauvegarder et cliquez Exécuter une fois. Le Date du document Le fichier de sortie contient le document final : connectez-le à une étape de téléchargement vers un système de stockage ou d’envoi par e-mail.

Quelle est la différence entre Générer des documents et Générer un document unique ?

Générer des documents est le module hérité utilisant le style Mustache {{fieldName}} espaces réservés avec JSON ou XML données, à l'appui PDF, Word, ou Excel sortir. Générer un document unique est le remplacement recommandé avec une pleine LINQ Syntaxe du moteur de rapports : <<foreach>> boucles, <<if>> conditionnelles, et <<var>> variables. Utilisez Générer des documents pour les modèles Mustache existants ou XML sources de données ; utilisez « Générer un document unique » pour les nouveaux modèles comportant une logique complexe. Voir la documentation. Make PDF4me intégration et PDF4me API documentation pour plus de détails.

Exemples de flux de travail

Exemples de flux de travailCommon Make scenario patterns using Generate Documents.
Nouvelle commande → générer PDF facture → envoyer un courriel au client
  1. Un webhook se déclenche lorsqu'une nouvelle commande est confirmée dans Shopify ou WooCommerce.
  2. Google Drive télécharge les modèle_de_facture.docx stocké sur le lecteur d'équipe.
  3. Générer des documents fusionne les données de la commande (nom du client, articles, total, date d'échéance) dans le modèle dont le type de fichier de modèle est défini sur Word et le type de sortie est défini sur PDF.
  4. Les données du document PDF est joint à un message Gmail envoyé immédiatement au client.
  5. Un deuxième compte Gmail télécharge une copie dans un dossier « Factures/2026 » de Google Drive à des fins de comptabilité.
Rapport hebdomadaire → générer Word document → distribuer à l'équipe
  1. Un scénario programmé se déclenche tous les lundis matin et interroge Google Sheets pour obtenir les données KPI de la semaine précédente.
  2. UN Make Le module texte assemble les données de la feuille dans un JSON objet contenant des champs correspondant aux espaces réservés du modèle de rapport.
  3. Générer des documents fusionne le JSON dans le Word Modèle de rapport avec le type de sortie défini sur Word.
  4. Les données du document Word Le document est envoyé par courriel à l'équipe de direction sous forme de pièce jointe modifiable avant la réunion debout de 9 h.
Soumission du formulaire → générer un certificat PDF → archives
  1. Un formulaire de fin de formation Typeform déclenche le scénario avec le nom du participant, le cours et la date.
  2. Dropbox télécharge les HTML Modèle de certificat enregistré dans le compte de l'équipe.
  3. Générer des documents fusionne les données des participants dans le HTML Modèle avec le type de fichier modèle défini sur html et le type de sortie défini sur Pdf.
  4. Le certificat PDF est envoyé par courriel au participant et téléchargé sur un SharePoint Bibliothèque « Certificats » pour les documents de conformité.

Foire aux questions

What is the difference between Generate Documents and Generate Document Single?+
Generate Documents is the legacy module supporting mustache-style {{fieldName}} placeholders with JSON or XML data, and can output PDF, Word, or Excel. Generate Document Single is the newer recommended module for the PDF4me LINQ Reporting Engine syntax, supporting <<foreach>> loops, <<if>> conditionals, <<var>> variables, and running totals. For new scenarios with complex template logic, use Generate Document Single. Use Generate Documents when you have existing mustache templates, need XML as the data source, or need Excel output.
Can I supply data as a file instead of pasting JSON into Document Data Text?+
Yes: use the Document Data File field and map the binary content of a JSON or XML file downloaded from Google Drive, Dropbox, OneDrive, or an HTTP request. This is the preferred approach for large data payloads or when the data file is managed separately from the Make scenario. If both Document Data File and Document Data Text are populated in the same module run, the file takes precedence and the text field is ignored.
What template syntax does this module support?+
For Word templates, use double-brace mustache placeholders: {{fieldName}} for text substitution. For HTML templates, use the same {{fieldName}} syntax inside HTML elements. The module does not support the PDF4me LINQ Reporting Engine syntax used by Generate Document Single, tags like <<foreach>>, <<if>>, and <<var>> are not processed by this legacy module. Keep templates to simple flat field substitution; for loops and conditionals, switch to Generate Document Single.
What is Meta Data Json used for?+
Meta Data Json is an optional parameter for controlling how specific template fields are formatted during the merge. Set FieldType to 2 with a FieldFormat string (e.g. "yyyyMMdd") for date fields, FieldType 0 for checkbox fields that should render as ticks or checkboxes, and FieldType 1 for fields that contain raw HTML content. The structure is {"FieldsMetaData":[{"FieldName":"dueDate","FieldType":2,"FieldFormat":"yyyyMMdd"}]}. Leave the field empty for plain text substitution with no special formatting.
Can I output Excel from a Word template, and what are the limitations?+
Yes. Set Template File Type to Word and Output Type to Excel to receive an Excel workbook as output. The module converts the merged Word document to XLSX. This works well for tabular data where the Word template is laid out as a table: each row maps to an Excel row. Complex Word formatting such as multi-column sections, text boxes, and advanced styles may not translate cleanly to Excel cells. Test your specific template before deploying to production.

Modules associés

Obtenez de l'aide