Geração de PDFs no Power Automate a partir de uma lista do SharePoint: um modelo Handlebars e um fluxo de trabalho de fatura HTML para PDF

PDF4me Gerar Documento Único É uma ação do Power Automate que renderiza um modelo HTML Handlebars e um payload JSON em um documento HTML finalizado, que a ação correspondente "Converter HTML para PDF" pagina para o formato A4. Uma nova linha em uma lista do SharePoint inicia o fluxo, o Compose monta o JSON e o Dropbox armazena o PDF da fatura com o nome do número da fatura. Sem conector premium, sem código.

Todas as equipes financeiras se deparam com o mesmo obstáculo no Power Automate. O recurso nativo Converter arquivo A ação requer uma licença premium e se recusa a usar um modelo HTML. Os serviços do Adobe PDF têm custos. O Encodian também tem custos. A solução alternativa popular de matthewdevaney ignora completamente o HTML e te prende ao Power Apps. O padrão abaixo é aquele que ninguém entre os dez primeiros resultados da SERP mostra de ponta a ponta: um conjunto de colunas de uma lista do SharePoint se torna uma carga útil JSON, um verdadeiro Modelo de guidão O arquivo está localizado em /Shared Documents/E duas ações do PDF4me realizam a renderização e a paginação pelo custo do conector da camada gratuita.

Renderização de templates Handlebars: PDF4me versus alternativas​

A comparação que todo arquiteto do Power Automate faz antes de escolher um conector para PDFs de faturas:

Perguntas e respostas baseadas no "porquê".​

O que você receberá​

Entrada: uma lista do SharePoint chamada Invoices (colunas: Título, Data da Fatura, Data de Vencimento, Nome do Cliente, Endereço do Cliente, E-mail do Cliente, Moeda, Subtotal, Alíquota de Imposto, Valor do Imposto, Total Geral, Observações) mais um único modelo Handlebars em /Shared Documents/invoice_template.html. Saída: um PDF A4 por linha no Dropbox, nomeado {Title}.pdf (INV-1005 torna-se INV-1005.pdf).

Do que você precisa​

O Fluxo em Resumo​

1. Quando um item é criado (Gatilho do SharePoint em Invoices lista).
2. Compor a carga útil JSON aninhada (fatura / cliente / itens / totais / notas).
3. Obter o conteúdo do arquivo usando o caminho para /Shared Documents/invoice_template.html.
4. PDF - Gerar Documento (Único) Com o corpo do modelo mais o JSON, tipo de saída HTML.
5. Converter HTML para PDF Formato A4 retrato, escala 0,8, margens de 40px, fundos de impressão: Sim.
6. Criar arquivo no Dropbox /, nome do arquivo {Title}.pdf.

Visão geral completa do fluxo​

Execução completa do processo. A etapa de 11 segundos para converter HTML em PDF refere-se à paginação; todo o restante leva menos de meio segundo.

Passo 1: Como acionar um fluxo do Power Automate em uma nova fatura do SharePoint?​

Fluxo até o momento: O fluxo começa aqui.

Aponte o gatilho do SharePoint para o site e a lista que contêm as linhas de suas faturas. Cada coluna se tornará conteúdo dinâmico posteriormente.

1. Adicionar SharePoint > Quando um item é criado como gatilho.
2. Configurar:
   • Endereço do siteSelecione o site do SharePoint (no exemplo: PDF4me Sharepoints - https://ynoox1.sharepoint.com/sites/PDF4meSharepoints).
   • Nome da lista: Invoices.
3. Salve e deixe o gatilho detectar o esquema da lista. As linhas na captura de tela abaixo (INV-1002, INV-1003, INV-1005) mostram exatamente as 12 colunas que o modelo Handlebars irá consumir.

A lista de faturas​

A lista do SharePoint é a fonte da verdade. Cada coluna aqui corresponde a um campo do payload Handlebars.

Configuração do gatilho​

Dois campos, esse é o gatilho completo. Todo o resto vem da linha.

Etapa 2: Como construir o payload JSON do Handlebars a partir de uma linha do SharePoint?​

Fluxo até o momento: Gatilho do SharePoint.

O Compose transforma as 12 colunas planas do SharePoint no JSON aninhado que o modelo Handlebars itera. O modelo espera invoice, customer, um items variedade, totalse um notes corda.

1. Adicionar Compor.
2. Em EntradasCole o JSON abaixo e, em seguida, insira o componente de conteúdo dinâmico do SharePoint correspondente entre as aspas de cada valor para que números e datas sejam exibidos como strings.

{
  "invoice": {
    "number": "Title",
    "date":   "InvoiceDate",
    "dueDate": "DueDate"
  },
  "customer": {
    "name":    "CustomerName",
    "address": "CustomerAddress",
    "email":   "CustomerEmail"
  },
  "items": [
    { "description": "Item1Description", "quantity": "Item1Qty", "unitPrice": "Item1UnitPrice", "lineTotal": "Item1Amount", "currency": "Currency" },
    { "description": "Item2Description", "quantity": "Item2Qty", "unitPrice": "Item2UnitPrice", "lineTotal": "Item2Amount", "currency": "Currency" },
    { "description": "Item3Description", "quantity": "Item3Qty", "unitPrice": "Item3UnitPrice", "lineTotal": "Item3Amount", "currency": "Currency" },
    { "description": "Item4Description", "quantity": "Item4Qty", "unitPrice": "Item4UnitPrice", "lineTotal": "Item4Amount", "currency": "Currency" },
    { "description": "Item5Description", "quantity": "Item5Qty", "unitPrice": "Item5UnitPrice", "lineTotal": "Item5Amount", "currency": "Currency" }
  ],
  "totals": {
    "currency":   "Currency",
    "subTotal":   "Subtotal",
    "taxRate":    "TaxRate",
    "taxAmount":  "TaxAmount",
    "grandTotal": "GrandTotal"
  },
  "notes": "Notes"
}

Compor configuração​

Componha no modo de visualização de código. Cada valor JSON é um elemento do SharePoint entre as aspas, portanto, números e datas chegam como strings que o modelo Handlebars pode renderizar.

Referência: Coluna do SharePoint para caminho Handlebars​

O mapeamento exato entre uma coluna do SharePoint e seu respectivo local no modelo. Adicione esta tabela aos seus favoritos ao estender o esquema.

Passo 3: Como carregar o arquivo de modelo Handlebars do SharePoint?​

Fluxo até o momento: Gatilho do SharePoint mais Compor.

Armazene o modelo como um arquivo simples. .html O arquivo está na biblioteca de Documentos do site. A ação "Obter conteúdo do arquivo usando o caminho" lê seus bytes brutos para que a ação "Gerar Documento (Único)" possa usá-los como corpo do modelo.

O próprio modelo​

O modelo é HTML comum com CSS embutido, além de expressões Handlebars onde os dados são inseridos. Duas estruturas realizam o trabalho principal. {{#each items}} repete uma linha da tabela por item de linha, e o {{#if description}} O guarda interno ignora os espaços em branco deixados pelas colunas Item4 e Item5 não utilizadas.

<tbody>
  {{#each items}}
  {{#if description}}
  <tr>
    <td>{{description}}</td>
    <td class="num">{{quantity}}</td>
    <td class="num">{{currency}}{{unitPrice}}</td>
    <td class="num">{{currency}}{{lineTotal}}</td>
  </tr>
  {{/if}}
  {{/each}}
</tbody>

Todo o resto é uma substituição direta: {{invoice.number}} no cabeçalho, o {{customer.*}} bloco para faturamento, {{totals.*}} na tabela de totais, e {{notes}} no rodapé.

1. Adicionar SharePoint > Obter o conteúdo do arquivo usando o caminho.
2. Configurar:
   • Endereço do site: mesmo local que o gatilho.
   • Caminho do arquivo: /Shared Documents/invoice_template.html.
   • Inferir tipo de conteúdo: Yes (Deixe o padrão).

Obter o conteúdo do arquivo usando o caminho​

O modelo reside em /Shared Documents/ e é obtido por caminho absoluto. O histórico de versões é automático, pois trata-se apenas de um arquivo do SharePoint.

Passo 4: Como o PDF - Gerar Documento (Único) preenche o modelo Handlebars?​

Fluxo até o momento: Gatilho do SharePoint mais Compor mais Obter conteúdo do arquivo usando o caminho.

O Generate Document (Single) é o mecanismo de modelos. Ele lê o código-fonte Handlebars ({{invoice.number}}, {{#each items}}...{{/each}}), substitui valores da carga útil JSON e retorna o HTML renderizado. Não realiza paginação. Essa é a tarefa da próxima etapa.

1. Adicionar PDF4me PDF > PDF - Gerar Documento (Único).
2. Configurar:
   • Tipo de arquivo de modelo: Html (Handlebars Syntax).
   • Nome do arquivo de modelo: invoice_template.html.
   • Dados do arquivo de modelo: conteúdo dinâmico, Body da etapa Obter conteúdo do arquivo do SharePoint.
   • Tipo de dados do documento: Json.
   • Texto dos dados do documento: conteúdo dinâmico, Body da etapa Compor.
   • Tipo de saída: Html.
   • Mantenha o modelo de PDF editável.: No.

Configuração de geração de documento (único)​

Tipo de saída é Html, não PdfA opção "Gerar Documento (Único)" passa o HTML renderizado para a próxima etapa, de modo que a paginação permaneça uma preocupação separada e testável.

Passo 5: Como paginar o HTML renderizado em um PDF A4?​

Fluxo até o momento: Gatilho do SharePoint + Compor + Obter conteúdo do arquivo usando o caminho + PDF - Gerar documento (único).

A função Converter HTML para PDF é o mecanismo de paginação. Ela lê o HTML gerado por Gerar Documento (Único), aplica o tamanho da página e as margens e retorna os bytes do PDF.

1. Adicionar PDF4me PDF > Converter HTML para PDF.
2. Configurar:
   • Conteúdo do arquivo: conteúdo dinâmico, Body da etapa Gerar Documento (Único).
   • Nome do arquivo HTML: invoice.html.
   • Layout da página: Portrait.
   • Tamanho da página: A4.
   • Escala: 0.8 (A fatura de 5 itens cabe em uma página).
   • Margem superior / inferior / esquerda / direita: 40px cada.
   • Fundo para impressão: Yes (Exibe a cor de fundo do bloco de totais).

Converter configuração de HTML para PDF​

A escala 0,8 permite que uma fatura de cinco linhas caiba em uma única página A4. Aumente para 0,9 ou 1,0 se tiver menos itens e desejar uma fonte maior.

Passo 6: Como salvar o PDF da fatura no Dropbox com um nome fácil de entender?​

Fluxo até o momento: Gatilho do SharePoint + Compor + Obter conteúdo do arquivo usando o caminho + PDF - Gerar documento (único) + Converter HTML para PDF.

A etapa final consiste em colocar o PDF em uma pasta do Dropbox com um nome vinculado ao número da fatura.

1. Adicionar Dropbox > Criar arquivo.
2. Configurar:
   • Caminho da pasta: / (ou uma subpasta como /invoices/).
   • Nome do arquivo: conteúdo dinâmico, Title do gatilho do SharePoint, seguido pela string literal .pdf. INV-1005 torna-se INV-1005.pdf.
   • Conteúdo do arquivo: conteúdo dinâmico, Body da etapa Converter HTML para PDF.

Criar arquivo de configuração​

Ao nomear o arquivo com o número da fatura, a pasta do Dropbox se torna automaticamente um arquivo de faturas pesquisável e sem duplicatas.

Execute o fluxo e verifique.​

1. Salvar o fluxo no canto superior direito.
2. Adicione uma nova linha ao Invoices Lista do SharePoint. Defina o título para algo reconhecível (INV-1005) e preencha todas as colunas para que o modelo tenha dados reais.
3. Abra o fluxo Histórico de execução e selecione a execução mais recente. Todos os cartões devem estar verdes, semelhante à captura de tela da visão geral do fluxo. O cartão "Converter HTML para PDF" é o mais lento (cerca de 11 segundos) porque é onde a paginação ocorre.
4. Abra o Dropbox e confirme. INV-1005.pdf (ou seu título) está na raiz. Baixe-o, abra-o e compare com o exemplo.

Variações comuns que você pode adicionar sem reconstruir​

Perguntas frequentes​

Como criar um PDF usando o Power Automate a partir de um item de lista do SharePoint?​

Use o SharePoint When an item is created como gatilho, um Compose ação para transformar as colunas planas da linha em uma carga útil JSON aninhada, um Get file content using path ação para carregar seu modelo HTML de /Shared Documents/, PDF4me Generate Document (Single) para mesclar o JSON no modelo e PDF4me Convert HTML to PDF Para paginar o resultado, salve a saída em qualquer conector de arquivo (Dropbox, OneDrive, SharePoint). Todas as ações nessa cadeia estão no nível de conector padrão, portanto, você não precisa de uma licença do Power Automate Premium.

O Power Automate consegue gerar um PDF?​

Sim. O Power Automate nativo não consegue renderizar um PDF a partir de um modelo HTML, mas o PDF4me O conector adiciona as duas ações que tornam isso possível: Generate Document (Single) para renderização de modelos e Convert HTML to PDF para paginação. Ambos são de nível padrão e gratuitos para instalar. Juntos, transformam qualquer linha do SharePoint / Dataverse / Excel em um PDF personalizado usando um modelo HTML editável armazenado ao lado dos dados.

Como criar um PDF a partir de um HTML no Power Automate?​

Adicione o PDF4me Converte HTML para PDF Ação em qualquer lugar onde o fluxo tenha HTML no escopo (uma saída do Compose, um corpo de conteúdo de arquivo Get, uma expressão do Compose, uma carga útil de webhook). Configure o tamanho da página (A4), layout (Portrait), margens (40px), e definir Print Background: Yes Assim, os planos de fundo CSS são preservados. A ação Body A saída é o arquivo binário PDF que você envia para sua ação de armazenamento. Esta é a mesma ação usada na Etapa 5 acima.

O Power Automate consegue converter HTML em PDF sem a versão premium?​

Sim. A ação Converter HTML para PDF do conector PDF4me está no nível de conector padrão, o que significa que você pode instalá-la e usá-la em qualquer plano do Power Automate sem precisar da licença Premium, que é necessária para a versão nativa. Convert File Os conectores do Adobe PDF Services também exigem uma chave de API do PDF4me (disponível na versão gratuita), que você deve colar ao adicionar a ação pela primeira vez.

Como gerar um PDF a partir de um modelo no Power Automate?​

Usar PDF4me Gerar Documento (Único) com Template File Type: Html (Handlebars Syntax) (para modelos HTML) ou Word (para .docx modelos). Alimente os bytes do modelo em Template File Data e uma carga útil JSON em Document Data Text. Definir Output Type: Html se você precisar paginar posteriormente (como neste blog), ou Pdf para obter um PDF de volta em uma única etapa. A ação suporta toda a sintaxe Handlebars, incluindo {{#each}} e {{#if}} para itens de linha e blocos condicionais.

Solução de problemas​

Próximos passos​

O mesmo padrão de seis etapas (linha + modelo + renderização + paginação + nome + armazenamento) lida com qualquer PDF personalizado por linha que você possa descrever em HTML.