Mala direta listando documentos em Make

Mala direta com lista de documentos em formato de string de dados é um Make módulo por PDF4me que mescla uma palavra ou PDF modelo com um JSON Matriz de registros, gerando um documento personalizado por objeto da matriz. Use-a para contratos, faturas ou certificados em lote. O resultado é um arquivo zip contendo os arquivos individuais ou um único arquivo combinado. PDF.

:::aviso Módulo obsoleto Este módulo será descontinuado em breve. Migre para Gerar vários documentos Para geração de documentos em lote com melhor desempenho, gerenciamento de memória aprimorado para grandes conjuntos de dados e recursos expandidos. :::

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 uma conexão válida. Crie ou selecione uma que mantenha sua conexão ativa. PDF4me API chave para que o cenário possa autenticar solicitações de geração de documentos em lote de forma segura.

Get your API Key

Fatos importantes que você não deve perder

Este módulo está obsoleto.

Para novos cenários, utilize Gerar vários documentosOferece melhor desempenho, gerenciamento de memória aprimorado para grandes conjuntos de dados e opções de formato ampliadas.

Um JSON objeto é igual a um documento

Os dados de mesclagem devem ser válidos. JSON matriz. Cada objeto na matriz gera um documento, e seus nomes de chave devem corresponder exatamente aos nomes dos espaços reservados para mala direta no seu documento do Word ou PDF modelo.

Dois modos de saída: combinado PDF ou zíper

Defina "Mesclar arquivo de saída" como "Sim" para um único arquivo. PDF Contendo todos os documentos em sequência. Defina como Não, o padrão, para um arquivo zip com um arquivo por registro e, em seguida, extraia-o com o módulo Arquivo.

Defina o Tipo de Arquivo de Modelo como Mala Direta. PDF4me mescla cada JSON Insira os dados nos campos de espaço reservado do seu modelo.

O que é a Mala Direta de Lista de Documentos? Make?

A lista de documentos para mala direta é Make's PDF4me Módulo para gerar vários documentos simultaneamente a partir de um único modelo. Ele aceita um arquivo de modelo e um... JSON O módulo processa uma matriz de registros e retorna um documento mesclado para cada registro. Ao contrário da mesclagem manual de registros no Word, este módulo é escalável para centenas de documentos em um cenário automatizado, sem etapas manuais.

Parâmetros

Parâmetro	Obrigatório	O que faz	Exemplo
Connection	Required	PDF4me connection holding your API key. Click Add and paste your key from dev.pdf4me.com/dashboard if connecting for the first time.	My PDF4me connection
File	Required	Binary content of the Word or PDF template. Map it from a preceding download module such as Dropbox Download a File.	1. Data
Merge Data	Required	JSON array of data records. Each object generates one document, and its key names must exactly match the placeholder names in the template.	[{"Name":"John","Co":"Acme"}]
Merge Output File	Optional	Controls the output format. Yes gives a single combined PDF of all documents. No, the default, gives a zip archive with one file per record.	No

Saída

Campo	Tipo	O que contém
Doc Data	Buffer	The generated output as a binary buffer. A zip archive of individual files when Merge Output File is No, or a single combined PDF when it is Yes.
File Name	String	Name of the output file, either a zip or a pdf. Map it into the File Name field of a downstream upload or email module.

Como funciona a geração de documentos em lote? Make?

O módulo lê seu modelo uma vez, percorre a matriz de Dados de Mesclagem e substitui cada registro nos espaços reservados do modelo para gerar um documento. Quando Arquivo de Saída de Mesclagem está definido como Não, ele compacta os documentos em um arquivo zip; quando definido como Sim, ele os concatena em um único arquivo. PDFA mala direta em si é um recurso antigo do Microsoft Word, documentado em... Central de ajuda do Microsoft OfficePara padrões de construção de cenários, consulte o Make central de ajuda.

Configurações típicas

Certificados para a lista de participantes do evento

1. Leia uma lista de funcionários do Google Sheets usando o módulo Pesquisar linhas.
2. Agrupe as linhas em um JSON array com o Agregador de Matrizes.
3. Passe o modelo para o arquivo e a matriz para mesclar dados.
4. Defina "Mesclar arquivo de saída" como "Sim" para um arquivo combinado. PDFEm seguida, envie-o por e-mail.

Faturas em lote como arquivos individuais

1. Coletar registros de faturas de uma fonte Airtable ou Sheets.
2. Construa o JSON matriz para que cada objeto corresponda aos espaços reservados do modelo.
3. Deixe a opção "Mesclar arquivo de saída" como "Não" para obter um arquivo zip contendo apenas um arquivo. PDF por registro.
4. Adicione o módulo Arquivo para descompactar e, em seguida, carregue cada arquivo para o Drive.

Cartas personalizadas enviadas por um webhook

1. Acione um Webhook personalizado que entrega uma matriz de registros.
2. Baixe o modelo de carta do armazenamento em nuvem.
3. Execute a Mala Direta para gerar os documentos mesclados.
4. Entregue o CEP ou o pacote combinado. PDF até o destino.

Dicas práticas

Este módulo está obsoleto.

Para novos cenários, use a opção "Gerar Vários Documentos", que oferece melhor gerenciamento de memória e suporte a formatos. Os cenários existentes continuarão funcionando.

As chaves devem corresponder exatamente aos espaços reservados.

JSON Os nomes das chaves devem corresponder aos nomes dos espaços reservados no modelo, e a distinção entre maiúsculas e minúsculas é importante. Uma chave chamada "company" não preencherá um espaço reservado para "Company".

Sim ou Não altera o tipo de saída.

A opção "Mesclar arquivo de saída" definida como "Sim" retorna um único arquivo combinado. PDFNão, a opção padrão retorna um arquivo zip contendo os arquivos individuais.

Descompacte para reproduzir arquivos individuais.

Sem a opção "Não", adicione o módulo Archive e, em seguida, um Iterator para fazer o upload ou enviar cada arquivo gerado por e-mail separadamente.

Válido JSON matriz necessária

Os dados de mesclagem devem ser um JSON Array de objetos. Valide-o antes da execução para que o módulo não retorne uma saída vazia.

Folha de dicas

Campo	Valor
Module	PDF4me > Mail Merge With Data String List of Docs
Status	Deprecated (prefer Generate Documents Multiple)
Connection	Your PDF4me connection
File	1. Data (template binary)
Merge Data	[{"Name":"John","Co":"Acme"}]
Merge Output File	No (zip) or Yes (combined PDF)
Output	Doc Data + File Name
Credits	1 per document generated

Perguntas frequentes

Como faço para mesclar uma lista de documentos em um sistema de mala direta? Make?+

Adicione o PDF4me Mala direta com lista de documentos usando strings de dados, mapeie um documento do Word ou PDF modelo para Arquivo, passe um JSON Para mesclar dados em um array, execute o cenário. O módulo gera um documento por objeto de array, entregue como um arquivo zip ou um único documento combinado. PDF dependendo da configuração do arquivo de saída de mesclagem.

Qual deve ser o formato dos dados mesclados? JSON Uso de array?+

Os dados de mesclagem devem ser um JSON Matriz de objetos. Cada objeto contém os valores dos campos para um registro, e seus nomes de chave devem corresponder exatamente aos nomes dos marcadores de posição da mala direta em seu modelo. A distinção entre maiúsculas e minúsculas é importante; portanto, um marcador de posição chamado "Company" não receberá um valor de uma chave chamada "company".

Como faço para obter arquivos individuais em vez de um único arquivo combinado? PDF?+

Deixe a opção "Mesclar arquivo de saída" definida como "Não" para que o módulo retorne um arquivo zip com um arquivo por registro. Adicione Make módulo de Arquivo integrado para extrair o arquivo zip e, em seguida, usar um Iterador Para percorrer os arquivos e fazer o upload, enviar por e-mail ou converter cada um individualmente.

Este é o módulo recomendado para geração de documentos em lote?+

Não. Este módulo está obsoleto. Para novos cenários, use Gerar Documentos Múltiplos, que oferece processamento em lote aprimorado e melhor gerenciamento de memória para grandes volumes de dados. JSON Arrays, suporte expandido a formatos e tratamento de erros aprimorado. Os cenários existentes continuam funcionando, mas novas compilações devem ter como alvo a substituição.

Ações relacionadas

Mala direta em documento único

A variante de registro único. Mescle uma única sequência de dados em um modelo quando não precisar de um lote.

Mesclar várias opções PDFs

Combine todos os documentos gerados em um só. PDF após a conclusão da mesclagem em lote.

Dividir PDF

Divida um arquivo de saída combinado em arquivos individuais por número de páginas ou intervalos de páginas.

Mesma tarefa em outras plataformas

Mala direta em n8n

O mesmo modelo de mesclagem MERGEFIELD como um n8n Node para fluxos de trabalho com código-fonte definido e auto-hospedados.

Mala direta em Power Automate

Microsoft 365 fluxos que extraem registros do Dataverse, Excel ou SharePoint listas.

Obtenha ajuda

Make IntegrationGet your API KeyMake Documentation