Crie modelos avançados para geração de documentos.

A geração de documentos usando a Mala Direta é um método que consiste em ler dados de uma fonte de dados e substituir as variáveis correspondentes em um documento modelo. Geralmente, são necessários dois arquivos: um modelo para armazenar os campos de mesclagem (as variáveis com os dados a serem inseridos) e outro contendo as instruções para formatar os dados variáveis e as informações que serão idênticas em todos os resultados da Mala Direta.

É possível criar modelos usando diversas sintaxes. O PDF4me aceita modelos Word, HTML e PDF para gerar documentos. Com o novo mecanismo de relatórios, você pode usar uma estrutura de sintaxe simples para criar modelos avançados em Word para suas faturas, recibos, contratos, orçamentos ou qualquer documento personalizado. Para obter informações detalhadas, acesse o link para nossa documentação.

Você pode criar manualmente os campos de mesclagem ou tokens na seguinte sintaxe.

<<[Nome do Campo]>>

Você também poderá adicionar expressões condicionais para avaliar e adicionar uma opção de dados específica ao resultado da condição. Vejamos brevemente como essas opções podem ser usadas para criar modelos Word para geração de documentos.

Expressões condicionais

A ação Gerar Documentos no PDF4me permite usar expressões condicionais para preencher dados em modelos. Com base no status de uma condição, dados dinâmicos podem ser adicionados a um documento. Você pode até combinar expressões para atender a várias condições antes que um dado específico seja preenchido.

sintaxe da condição if else

Uma sintaxe básica de como uma condição if-else pode ser usada em um documento -

<<if [condição1]>> Adicionar primeiro dado <<elseif [condição2]>> Adicionar segundo dado <<else>> Adicionar terceiro dado <</if>>

Existem condições mais avançadas que você pode aplicar. Leia mais sobre declarações condicionais.

Formatação em modelos

Ao gerar documentos, você pode querer aplicar formatação a um resultado preenchido dinamicamente, como o valor resultante de uma expressão. Com o PDF4me, você pode facilmente aplicar formatação aos resultados da sua condição ou expressão.

A sintaxe básica para aplicar formatação -

<<[token]:"formato">>

Exemplo-

Data da fatura: <<[invoiceDate]:"dd.MM.yyyy">>

Para conhecer todas as funcionalidades de formatação , leia mais sobre como formatar modelos Word.

Tabelas em Modelos

As tabelas são um elemento muito comum na maioria dos documentos. Elas ajudam a exibir dados de forma eficaz para facilitar a comparação, a consulta ou os cálculos. O gerador de documentos PDF4me pode inserir tabelas em documentos com base nos dados de forma eficiente.

Vejamos exemplos de como a sintaxe da tabela pode ser criada.

Podemos criar uma lista de produtos para entender isso.

Coluna 1: <<foreach [product in products]>><<[product.productName]>> Coluna 2: <<[product.manufactured]:"yyyy.MM.dd">> Coluna 3: <<[product.price]>><</foreach>>

Você pode encontrar mais informações sobre as diversas estruturas de tabelas na documentação sobre Tabelas.

Adicionar imagens aos modelos

O PDF4me também permite inserir imagens em documentos. A sintaxe para imagens pode ser adicionada na fase de design do modelo.

É possível adicionar imagens de duas maneiras.

Usando um URL de imagem pública

<<imagem [imageUrl]>>

Os dados podem ser passados para a sintaxe acima das seguintes maneiras, respectivamente:

Com uma string Base64 de uma imagem

<<imagem [imageBase64]>>

Leia a documentação para obter detalhes sobre como adicionar imagens em modelos Word com exemplos .

Inserir trechos de HTML em modelos

Agora você também pode adicionar seções HTML e formatação diretamente aos modelos para preencher dados. Você pode usar a seguinte sintaxe para inserir o HTML.

<<[token] -html>>

Para ver exemplos , leia a documentação sobre como inserir HTML em modelos Word.

Modelo de exemplo

Vejamos um exemplo rápido para você experimentar. A seguir, apresentamos um modelo Word e os dados necessários para você testar rapidamente a ação de geração de documento. Você pode baixar o modelo Word e usar o JSON do modelo para realizar os testes.

Dados de amostra

{ "VendorName": "PDF4me", "VendorCity":"Zurique", "VendorCountry":"Suíça", "VendorZip":"8630", "VendorContact":"123456", "InvoiceDate":"22-08-2022", "CustomerName":"John Doe", "CustomerCity":"Start City", "CustomerCountry":"US", "CustomerZip":"3214", "products": [ { "prodctName": "Conversor de PDF", "value": 2000, "expires": "01/08/2025" }, { "productName": "API de PDF", "value": 1250, "expires": "18/02/2029" }, { "productName": "Editor de PDF", "value": 1999, "expira": "12/12/2027" } ], "comentário":"Este documento foi <b>gerado por computador</b> e não requer assinatura.", }