Aba Dados

Guia de referência para gerenciar Mapeamentos, Cálculos e Fontes de Dados no Template Designer.

A aba Data no Template Designer é onde você define a lógica por trás do seu documento. Ela conecta o design visual às suas fontes de dados reais (Excel/CSV) e gerencia a lógica de negócios como cálculos e agrupamento.

Visão geral das seções

A aba Data é organizada nas seguintes seções:

  1. Mappings: Conecta colunas do arquivo de dados a variáveis do modelo.
  2. Calculations: Cria novas variáveis usando fórmulas.
  3. Grouping (Obrigatório): Define como as linhas são divididas em documentos PDF separados.
  4. Data Linking: Vincula dados de transação com dados mestre (estilo VLOOKUP).
  5. Output Configuration: Define a convenção de nomes para os PDFs gerados.
  6. Data Sources: Carrega dados de exemplo para preview e mapeamento.

1. Mappings

Os mapeamentos permitem que o modelo "leia" valores das colunas do seu arquivo de dados.

  • Dados de origem (ícone de recibo): Representa seus dados principais (ex.: faturas, linhas de vendas). Esses dados geralmente variam a cada linha.
  • Dados mestre (ícone de pessoa): Representa dados de referência (ex.: lista de clientes, catálogo de produtos). Esses dados são geralmente estáticos ou vinculados por um ID.

Ao carregar uma fonte de dados (veja Data Sources abaixo), os mapeamentos geralmente são criados automaticamente. Você também pode adicioná-los manualmente.

2. Calculations

Os cálculos permitem criar novas variáveis derivadas dos dados existentes. Use para calcular valores, impostos ou combinar campos de texto.

Exemplo: Para calcular o preço total a partir de UnitPrice e Quantity:

  • Name: TotalAmount
  • Formula: {{UnitPrice}} * {{Quantity}}

Após criado, {{TotalAmount}} fica disponível como variável no seu design.

Agregação (Sum)

Para totais em nível de grupo, você pode usar o tipo sum em vez de uma fórmula. Isso soma automaticamente um campo em todas as linhas do grupo:

  • Type: sum
  • Field: A variável a ser somada (ex.: TotalAmount)

Útil para calcular subtotais, totais gerais ou outros valores agregados a partir de itens de linha.

Arredondamento

Os cálculos suportam a opção Rounding para controlar como os resultados numéricos são arredondados:

  • floor: Arredonda para baixo (ex.: 10,9 → 10)
  • ceil: Arredonda para cima (ex.: 10,1 → 11)
  • round: Arredondamento padrão (ex.: 10,5 → 11)

Especialmente útil para cálculos de impostos e formatação de moeda.

3. Grouping

Esta configuração é obrigatória. A Group Key determina como múltiplas linhas são processadas.

  • Modo linha única: Se cada linha dos seus dados representa um documento único, selecione uma coluna de ID única (ex.: InvoiceID).
  • Modo múltiplas linhas: Se seus dados contêm múltiplas linhas para um único documento (ex.: uma fatura com 5 itens), selecione a coluna que identifica o documento (ex.: InvoiceID). O motor agrupará essas 5 linhas em um único PDF.

4. Data Linking

Use esta seção para vincular Dados mestre aos seus Dados de origem, semelhante a um VLOOKUP no Excel.

  • Match Value (Import Data): A coluna nos dados de transação que atua como "Chave Estrangeira" (ex.: CustomerID).
  • Lookup Key (Master Data): A coluna de ID única nos dados mestre (ex.: CustomerID).

Por que usar isso? Se seus dados de transação têm apenas CustomerID "C001", mas você quer imprimir o endereço completo do cliente na fatura, vincule os Dados mestre. O sistema buscará automaticamente o endereço associado a "C001".

5. Output Configuration

  • PDF Naming Rule: Define o nome do arquivo PDF gerado.
  • Padrão: {{InvoiceNo}}.pdf

Você pode usar variáveis para criar nomes de arquivo dinâmicos, como Invoice_{{InvoiceNo}}_{{Date}}.pdf.

6. Data Sources

Esta seção ajuda a verificar os mapeamentos e confirmar a conexão. Embora o mapeamento manual seja possível, carregar seus arquivos de dados reais reduz erros significativamente.

Formatos suportados

  • Arquivos CSV (.csv)
  • Arquivos Excel (.xlsx, .xls)

Como usar

  1. Clique em Load Source Data ou Load Master Data.
  2. Selecione seu arquivo no seletor de arquivos.
  3. Um diálogo de Data Preview será exibido.
  4. Revise os dados e clique em Load. O sistema proporá automaticamente mapeamentos para todas as colunas encontradas no arquivo.