Criar modelos avançados para geração de documentos

A geração de documentos utilizando o Mail merge é o método de leitura de dados de uma fonte de dados e a substituição das variáveis correspondentes num documento modelo. Normalmente requer dois ficheiros, modelos para armazenar os campos de fusão - a variável para os dados a serem inseridos. O outro contém tanto as instruções para formatar os dados da variável como a informação que será idêntica em cada resultado da fusão de correio.

Os gabaritos podem ser criados usando várias sintaxes. PDF4me aceita modelos Word, HTML, e PDF para gerar documentos. Com o novo motor de relatórios, pode usar uma estrutura de sintaxe simples para conceber modelos avançados em Word para as suas facturas, recibos, contratos, cotações, ou qualquer documento personalizado. Para leitura detalhada, siga o link para a nossa documentação -

Como desenhar modelos de palavras?

Pode criar manualmente os campos ou fichas de fusão na seguinte sintaxe

<<[Nome do campo]>>

Poderá também acrescentar expressões condicionais para avaliar e acrescentar uma opção de dados específica sobre o resultado da condição. Vejamos resumidamente como estas opções podem ser utilizadas para a concepção de modelos Word para a geração de documentos.

Expressões Condicionais

A acção Gerar Documentos em PDF4me permite-lhe utilizar expressões condicionais para preencher dados em modelos. Com base no estado de uma condição, os dados dinâmicos podem ser adicionados a um documento. Pode até combinar expressões para satisfazer múltiplas condições antes de um dado em particular ser preenchido.

Se outra sintaxe de condição

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

<<<se [condição1]>>
  Acrescentar os primeiros dados
  <<<elseif [condição2]>>
    Acrescentar segundos dados
  <<<else>>
    Adicionar terceiros dados
<</if>>>

Há condições mais avançadas que pode aplicar. [Leia mais em Declarações condicionais](/directrizes gerais/expressões condicionais/)

Formatação em Modelos

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

A sintaxe básica para a aplicação da formatação -

<<[token]: "formato">>

Por exemplo…

Data de facturação:  <<[invoiceDate]: "dd.MM.yyyyy">>

Para conhecer todas as capacidades de formatação ler mais sobre formatação de modelos Word

Tabelas em Modelos

As tabelas são uma parte muito comum da maioria dos documentos. Ajudam efectivamente a exibir dados para fácil comparação, referência, ou para computação. O gerador de documentos PDF4me pode efectivamente inserir tabelas em documentos com base nos dados.

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

Podemos criar uma lista de produtos para compreender isto.

Coluna 1: <<<para cada [produto em produtos]>><<[produto.produtoNome]>>
Coluna 2: <<[produto.fabricado]: "yyyyy.MM.dd">>
Coluna 3: <<<[produto.preço]>><</para cada>>>

Há mais sobre várias estruturas de tabelas que pode ler na documentação sobre Tabelas

Adicionar Imagens em Modelos

PDF4me também lhe permite inserir imagens em documentos. A sintaxe das imagens pode ser adicionada na fase de desenho do modelo.

As imagens podem ser adicionadas de 2 maneiras

Utilização de um URL de imagem pública

<<imagem [imageUrl]>>

Os dados podem ser passados para a sintaxe acima indicada das seguintes formas, respectivamente -

Com um fio Base64 de uma Imagem

<<imagem [imageBase64]>>

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

Inserir trechos de HTML em Templates

Agora também pode adicionar directamente secções HTML e formatação a templates para preenchimento de dados. Pode usar a seguinte sintaxe para inserir o HTML

<<[token] -html>>>

Para ver exemplo ler a documentação para inserção de HTML em templates Word

Modelo de amostra

Vejamos uma amostra rápida para tentar. O seguinte é um modelo de Word e dados para que experimente rapidamente a acção gerar documento. Pode transferir o modelo Word e utilizar o JSON* para o modelo a testar.

Dados da amostra

{
    "VendorName": "PDF4me",
    "VendorCity": "Zurique",
    "VendorCountry": "Suíça",
    "VendorZip": "8630",
    "VendorContact":"123456",
    "InvoiceDate":"22-08-2022",
    "CustomerName": "John Doe",
    "CustomerCity": "Cidade Inicial",
    "CustomerCountry": "US",
    "CustomerZip":"3214",
    "produtos": [
    {
      "prodctName": "PDF Converter",
      "valor": 2000,
      "expira": "01/08/2025"
    },
    {
      "productName": "PDF API",
      "valor": 1250,
      "expira": "18/02/2029"
    },
    {
      "productName": "Editor PDF",
      "valor": 1999,
      "expira": "12/12/2027"
    }
   ],
   "comentário": "Este documento é <b>computador gerado</b> e não requer uma assinatura",
  }