Pular para o conteúdo principal

Gerar documentos em Make

PDF4me Gerar documentos é um Make módulo que mescla JSON ou XML dados em um Word ou HTML modelo e retorna um resultado finalizado PDF, Word, ou Excel Arquivo. Lugar {{fieldName}} Insira marcadores de posição no seu modelo, forneça dados correspondentes de chave-valor e o módulo realizará a substituição no servidor. Este é o módulo legado de geração de documentos; para novos cenários com lógica condicional complexa, use "Gerar Documento Único".

O que este módulo faz

PDF4meGerar documentos fusões JSON ou XML dados em um Word ou HTML modelo e retorna o resultado como um arquivo finalizado PDF, Word documento, ou Excel Arquivo pronto para enviar por e-mail, armazenar ou continuar o processamento. Coloque {{fieldName}} Insira marcadores de posição no seu modelo, forneça dados correspondentes de chave-valor e o módulo realiza a substituição inteiramente no lado do servidor. É o módulo legado de geração de documentosPara novos cenários com lógica condicional complexa ou estruturas de repetição, use Gerar documento único em vez disso, que apoia totalmente o PDF4me LINQ sintaxe do modelo.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue

Autenticando seu API Solicitar

Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa autenticar solicitações de geração de documentos com segurança.

Fatos importantes que você não deve perder

O nome do modelo é o nome do arquivo, não o ID do modelo do painel.
O Nome do modelo O campo espera o nome do arquivo de modelo (por exemplo, invoice_template.docx), mapeado a partir do nome do arquivo de saída da sua etapa de download do Dropbox, Google Drive ou OneDrive. Não é um ID de modelo do PDF4me O painel de controle, o binário do modelo propriamente dito, é fornecido separadamente via Arquivo de dados do documento.
Os dados podem ser texto ou um arquivo, ambos funcionam.
Você pode fornecer dados de mesclagem de duas maneiras: colando ou mapeando. JSON/XML string diretamente em Texto dos dados do documento (bom para cargas úteis pequenas construídas a partir de saídas de módulos anteriores), ou mapear um binário JSON/XML arquivo de um módulo de armazenamento para Arquivo de dados do documento (Melhor para arquivos de dados grandes ou mantidos externamente). Se ambos estiverem preenchidos, o arquivo terá prioridade.
Para vários registros, use Gerar vários documentos.
A opção Gerar Documentos produz um único documento de saída por execução. Se seus dados contiverem uma matriz de registros (por exemplo, 50 registros de faturas) e você precisar de um documento por registro, use Gerar vários documentosEle itera sobre o array e retorna um arquivo ZIP contendo todos os arquivos gerados em uma única chamada de módulo, eliminando a necessidade de um loop iterador.
Configure o módulo Gerar Documentos do PDF4me para exibir a Conexão definida como testuser01@pdf4me.com, o Tipo de Arquivo de Modelo definido como Word, o Tipo de Saída definido como Word, o Arquivo definido como Mapear com o Nome do Modelo mapeado em 7. Nome do Arquivo e o Arquivo de Dados do Documento mapeado em 7. Dados, o Tipo de Dados do Documento definido como JSON, o Texto dos Dados do Documento com um exemplo de array JSON e o campo Metadados JSON.

Definir Tipo de arquivo de modelo e Tipo de saída Primeiro, depois o fio Nome do modelo e Arquivo de dados do documento a partir da etapa que baixou o modelo. Forneça os dados de mesclagem via Texto dos dados do documento ou Arquivo de dados do documento.

Parâmetros

Obrigatório: Conexão, Tipo de arquivo de modelo, Tipo de saída, Nome do modelo, e Tipo de dados do documento. Definir Arquivo para Mapa Primeiro, revele o nome do modelo e o arquivo de dados do documento.

ParâmetroObrigatórioO que fazExemplo
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":[...]}

Campos de saída

CampoTipoO que contém
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.

Como configurar a geração de documentos em Make

  1. Adicionar PDF4meGerar documentos para o seu Make cenário.
  2. Selecione Conexão (ou clique) Adicionar para criar um com o seu API chave).
  3. Definir Tipo de arquivo de modelo para Word ou HTML para corresponder ao formato do seu modelo.
  4. Definir Tipo de saída para PDF, Wordou utilize o Excel para obter o resultado desejado.
  5. Definir Arquivo para Mapae então conecte os fios Nome do modelo para o nome do arquivo de saída e Arquivo de dados do documento ao conteúdo binário da sua etapa de download do modelo.
  6. Definir Tipo de dados do documento Para JSON ou XML. Insira ou mapeie seus dados em Texto dos dados do documentoOu deixe em branco se os dados já estiverem inseridos por meio do Arquivo de Dados do Documento.
  7. Salvar e clique Executar uma vez. O Data do documento A saída contém o documento finalizado: integre-a a uma etapa de upload para armazenamento ou envio por e-mail.

Qual a diferença entre "Gerar Documentos" e "Gerar Documento Único"?

Gerar documentos é o módulo legado que usa o estilo mustache {{fieldName}} espaços reservados com JSON ou XML dados, apoiando PDF, Word, ou Excel saída. Gerar documento único é a substituição recomendada com acabamento completo LINQ Sintaxe do mecanismo de relatórios: <<foreach>> laços, <<if>> condicionais e <<var>> variáveis. Use Gerar Documentos para modelos Mustache existentes ou XML fontes de dados; use Gerar Documento Único para novos modelos com lógica complexa. Consulte o Make PDF4me integração e PDF4me API documentação Para obter detalhes completos.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoCommon Make scenario patterns using Generate Documents.
Novo pedido → gerar PDF fatura → enviar e-mail ao cliente
  1. Um webhook é acionado quando um novo pedido é confirmado no Shopify ou no WooCommerce.
  2. O Google Drive baixa o invoice_template.docx armazenado na unidade de rede da equipe.
  3. Gerar documentos Mescla os dados do pedido (nome do cliente, itens da lista, total, data de vencimento) no modelo com o Tipo de Arquivo de Modelo definido como Word e o tipo de saída definido como PDF.
  4. Os dados do documento PDF é anexado a uma mensagem do Gmail enviada imediatamente ao cliente.
  5. Um segundo Gmail carrega uma cópia para uma pasta "Faturas/2026" no Google Drive para fins de registro contábil.
Relatório semanal → gerar Word documento → distribuir para a equipe
  1. Um cenário agendado é acionado todas as segundas-feiras de manhã e consulta o Google Sheets para obter os dados de KPIs da semana anterior.
  2. A Make O módulo de texto reúne os dados da planilha em um JSON Objeto com campos que correspondem aos espaços reservados do modelo de relatório.
  3. Gerar documentos funde o JSON para dentro do Word Modelo de relatório com Tipo de Saída definido como Word.
  4. Os dados do documento Word O documento é enviado por e-mail à equipe de gestão como um anexo editável antes da reunião diária das 9h.
Envio do formulário → gerar certificado PDF → arquivo
  1. Um formulário de conclusão de treinamento do Typeform aciona o cenário com o nome do participante, o curso e a data.
  2. O Dropbox baixa o HTML Modelo de certificado armazenado na conta da equipe.
  3. Gerar documentos mescla os dados dos participantes no HTML Modelo com o Tipo de Arquivo de Modelo definido como html e o Tipo de Saída definido como Pdf.
  4. O certificado PDF é enviado por e-mail ao participante e carregado em um SharePoint Biblioteca de "Certificados" para registros de conformidade.

Perguntas frequentes

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.

Módulos relacionados

Obtenha ajuda