Mala direta com lista de documentos em formato de string de dados Power Automate

PDF4me Mala direta com lista de documentos em formato de string de dados é um Power Automate ação que transforma uma Palavra ou PDF modelo mais um JSON Converta um conjunto de dados em um lote de documentos personalizados em uma única chamada. Use-o para gerar cartas de oferta, certificados ou avisos de conta para uma lista inteira de destinatários sem precisar percorrer o fluxo com o modelo de mesclagem, registro por registro.

O que esta ação faz

PDF4me Mala direta com lista de documentos em formato de string de dados mapeia uma palavra ou PDF modelo de mesclagem mais um JSON A função retorna um array de documentos gerados, um para cada linha de dados. Tanto um array de arrays quanto um array de objetos são suportados para o formato de string de dados.

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

Para acessar o PDF4me Web API através Power Automate, cada solicitação deve incluir um válido API A autenticação valida sua identidade e permite que o conector acesse o sistema. PDF4meO serviço de mala direta do seu fluxo.

Get your API Key

Fatos importantes que você não deve perder

Uma chamada, um documento por linha de dados.

Uma única chamada de ação retorna a matriz completa de Documentos de Saída, não sendo necessário percorrer o mapeamento do modelo para cada destinatário.

Dois formatos de string de dados suportados

Utilize uma matriz de matrizes com uma linha de cabeçalho ou uma matriz de objetos de campo/valor, o que for mais fácil de construir a partir da saída da sua ação anterior.

Os modelos podem ser do Word ou PDF

O campo "Dados do Arquivo de Modelo" aceita arquivos .docx ou .pdf, desde que contenham campos de mesclagem que correspondam aos nomes das colunas ou campos da string de dados.

Dados do arquivo de modelo de mapa e nome do arquivo de modelo, em seguida, construa a string de dados como um JSON matriz com uma entrada por documento a ser gerada.

Parâmetros

Obrigatório: Os três campos, Dados do Arquivo de Modelo, Nome do Arquivo de Modelo e Cadeia de Dados, devem ser fornecidos para que a ação seja executada.

Parâmetro	Obrigatório	O que faz	Exemplo
Template File Data	Required	Content of the merge template, mapped from a prior action such as SharePoint or OneDrive Get File Content. Must be a .docx or .pdf file containing merge fields.	[Template Content]
Template File Name	Required	Name of the template file including its extension, used for processing identification.	LetterTemplate.docx
Data string	Required	JSON data to merge into the template. Accepts an array-of-arrays with a header row followed by value rows, or an array of field/value objects. Each row or object after the header generates one document.	[["Name","Email"],["John","[email protected]"]]

O que a função Mala Direta com Cadeia de Dados retorna?

Campo	Tipo	O que contém
Output Documents	Array of Objects	One entry per generated document, directly iterable with Apply to each.
File Content	Binary	Binary content of each generated document, nested inside each Output Documents entry.
File Name	String	File name of each generated document, nested inside each Output Documents entry.

{
  "Output Documents": [
    { "File Content": "[Binary Content]", "File Name": "Letter_001.pdf" },
    { "File Content": "[Binary Content]", "File Name": "Letter_002.pdf" }
  ]
}

Como configurar a mala direta com uma cadeia de dados? Power Automate?

1. Adicionar PDF4me → Mala direta com lista de documentos em formato de string de dados para o seu Power Automate fluxo.
2. Mapa Dados do arquivo de modelo e Nome do arquivo de modelo a partir de um modelo armazenado em SharePoint ou OneDrive, contendo campos de mesclagem que correspondem às suas colunas de dados.
3. Construir Cadeia de dados como um JSON matriz, que pode ser uma linha de cabeçalho seguida por linhas de valores, ou uma matriz de objetos campo/valor, com uma entrada por documento a ser gerada.
4. Execute o fluxo. PDF4me retornos Documentos de saída, uma matriz com um documento gerado por linha de dados.
5. Adicione um Aplicar a cada Ação sobre os documentos de saída para enviar por e-mail, fazer upload ou arquivar cada documento gerado individualmente.

Qual formato de string de dados devo usar?

Use o matriz-de-matrizes formato, uma linha de cabeçalho seguida por linhas de valores, quando os dados de origem já vêm de Excel ou um conector em forma de tabela como matrizes paralelas, já que ele mapeia diretamente para linhas e colunas. Use o matriz-de-objetos formato quando os dados de origem vêm de um sistema como um CRM ou um conector de formulários que retorna naturalmente campos nomeados por registro, já que as chaves de cada objeto já se alinham com os nomes dos campos de mesclagem do modelo.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Power Automate flow patterns using Mail Merge with Data String List of Docs.

Geração de certificados em massa

1. Um fluxo é acionado quando um curso de treinamento é marcado como concluído no LMS.
2. A função "Obter lista de participantes" recupera todos os concluintes do curso, incluindo nome e data de conclusão.
3. Uma ação de Composição constrói a string de dados como uma matriz de objetos nome/curso/data.
4. A função Mala Direta com Cadeia de Dados gera um certificado por participante em uma única chamada, e um loop "Aplicar a cada" envia cada certificado por e-mail ao destinatário.

Cartas de oferta personalizadas

1. Um gerente de contratação aprova um lote de candidatos no ATS, dando início ao fluxo de trabalho.
2. A função "Obter dados do candidato" recupera o nome, o cargo e o salário de cada candidato aprovado.
3. A função Mala Direta com Cadeia de Dados mapeia o modelo de carta de oferta e gera uma carta para cada candidato.
4. A matriz de Documentos de Saída é enviada ao RH para revisão antes da entrega individual.

Avisos de conta agendados

1. Um gatilho de recorrência executa um fluxo mensal de aviso de cobrança.
2. A ferramenta obtém dados do cliente, consulta o sistema de faturamento para cada conta com aviso prévio para aquele mês.
3. A função Mala Direta com Cadeia de Dados gera um aviso personalizado por conta a partir de um único modelo de aviso.
4. A opção "Aplicar a cada loop" carrega cada notificação para o cliente. SharePoint pasta e envia um e-mail de resumo.

Dicas práticas

Match merge field names to Data string keys exactly

The template's merge fields must line up with the Data string's column headers or object keys, character for character, or those fields render blank in the output.

Pick one Data string shape and stick with it

Mixing array-of-arrays and array-of-objects rows in the same request is not supported. Choose whichever shape your upstream data source already produces to avoid an extra transform step.

Use Compose to build the Data string before the action

Building the JSON array in a Compose action makes it easy to inspect and debug the exact payload before it reaches Mail Merge with Data String.

Always follow with Apply to each

Output Documents is an array by design, so downstream email, SharePoint, or archive steps need an Apply to each loop rather than a single-item reference.

Keep the template in the same PDF4me account you authenticate with

A template that renders correctly when tested manually can still fail from a flow if the connection used to run the flow points at a different PDF4me account than the one that owns the template file.

Folha de dicas

Campo	Valor
Action	Mail Merge with Data String List of Docs
Template File Data	.docx or .pdf, mapped from a prior action
Template File Name	e.g. LetterTemplate.docx
Data string	Array-of-arrays (header + rows) or array-of-objects
Documents generated	One per data row/object
Output	Output Documents array, each with File Content + File Name
Next step	Apply to each over Output Documents

Perguntas frequentes

How do I generate multiple documents from one template in Power Automate?+

Add the PDF4me Mail Merge with Data String List of Docs action, map Template File Data and Template File Name from a Word or PDF template containing merge fields, then build the Data string as a JSON array with one entry per document. The action returns Output Documents, an array ready for an Apply to each loop.

What format does the Data string need?+

Data string accepts two JSON shapes: an array-of-arrays with a header row followed by value rows, for example [["Name","Email"],["John","[email protected]"]], or an array of field/value objects. Each additional row or object after the header produces one generated document.

Can the template be a PDF instead of a Word document?+

Yes. Template File Data accepts both .docx and .pdf templates, as long as the template contains the merge fields referenced by the Data string's column or field names.

How do I process each generated document afterward?+

Feed the action's Output Documents array into an Apply to each control. Inside the loop, each item exposes its own File Content and File Name, which can be emailed, uploaded to SharePoint, or zipped into an archive. See <a href="https://learn.microsoft.com/en-us/power-automate/apply-to-each" target="_blank" rel="noopener noreferrer">Microsoft's Apply to each documentation</a> for loop configuration details.

Is there a single-document version of this action?+

Yes. For a one-template, one-record merge, use the PDF4me Generate Document Single action, linked under Related Actions below. See <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for the full action list.

Casos de uso e aplicações industriais

Human Resources & Payroll

Casos de uso de Recursos Humanos e Folha de Pagamento

• Cartas de OfertaGere ofertas de emprego personalizadas para todo um lote de candidatos em uma única ligação.
• Documentos de integraçãoCriar simultaneamente a documentação de admissão para todos os novos funcionários.
• Avaliações de desempenhoGere documentos de avaliação para todos os funcionários a partir de um único ciclo de avaliação.
• Declarações de benefíciosCrie resumos de benefícios personalizados para o período de inscrição aberta.

Finance & Banking

Casos de uso em finanças e bancos

• Extratos de contaGerar extratos para cada cliente em um ciclo de faturamento.
• Documentos FiscaisCriar resumos fiscais para todos os clientes antes dos prazos de entrega.
• Relatórios de InvestimentoGere relatórios de portfólio para cada investidor cadastrado.
• Cartas de notificaçãoCrie notificações de conta para um segmento de clientes em uma única execução.

Education & Training

Casos de uso em educação e treinamento

• CertificadosGere certificados de conclusão para todos os alunos de uma turma.
• Boletins escolaresCriar relatórios de progresso para todos os alunos ao final do período letivo.
• TranscriçõesGere históricos escolares para uma turma de formandos em um único lote.
• Cartas aos paisCriar comunicações personalizadas para os pais de toda a turma.

Marketing & Communications

Casos de uso em marketing e comunicação

• Cartas de campanhaGere cartas de marketing personalizadas para um segmento-alvo.
• Avisos ao ClienteCriar notificações de atualização de serviço para os clientes afetados.
• Convites para eventosGere convites personalizados para eventos a partir de uma lista de inscritos.
• Cartas de AgradecimentoCriar cartas de agradecimento para um grupo de clientes.

Ações relacionadas

Gerar documento único

Combine um modelo com um registro quando apenas um único documento personalizado for necessário em vez de uma matriz completa.

Gerar vários documentos

Gere documentos a partir de vários modelos diferentes em uma única chamada, em vez de um modelo mesclado em várias linhas de dados.

Mesclar várias opções PDF arquivos em um único PDF

Combine os documentos gerados em um único arquivo, o que é útil para arquivar um lote inteiro como um único documento. PDF.

Mesma tarefa em outras plataformas

Criar: Mala direta com lista de documentos em formato de string de dados

O mesmo módulo de mala direta em massa para cenários do Make, compatível com o Google Sheets e CRM módulos.

Obtenha ajuda

PDF4me ConnectGet your API KeyPower Automate Documentation