Dados Variáveis (Variable Data)
O que são Dados Variáveis (Variable Data)?
Dados variáveis referem-se à capacidade de inserir dinamicamente conteúdos personalizados ou mutáveis (ex.: nomes, imagens, códigos de barras) em modelos (templates) no momento da impressão.
Confira também nosso vídeo sobre criação de modelos e vinculação de banco de dados.
Como crio um modelo com dados variáveis?
- Abra o Editor.
- Desenhe marcadores de posição (PlaceHolders) onde o conteúdo dinâmico deve aparecer.
- Insira palavras-chave (keywords) dentro das caixas de texto (ex.:
$Nome$,$#1:NomeDoArquivo$). - Salve o documento como um arquivo de modelo
.st3.
O que são marcadores de posição (PlaceHolders)?
PlaceHolders são recipientes visuais usados em um modelo para receber conteúdo dinâmico, como imagens ou PDFs. Cada PlaceHolder possui um ID exclusivo.
O que são palavras-chave (keywords) e como são usadas?
Palavras-chave são marcadores de texto formatados com cifrões, como
$Nome$.Elas são substituídas em tempo de execução por valores originados de:
- Um arquivo de texto (via Combinar / Combine)
- Metadados do documento (
$:PalavraChave$) - Conteúdo do PlaceHolder (
$#ID:PalavraChave$)
Como funciona a função Combinar (Combine)?
A função Combinar mescla um modelo com um arquivo de dados. Cada linha do arquivo corresponde a um conjunto de valores e resulta em uma cópia do modelo completo.
Em qual formato o arquivo de dados deve estar?
- Texto simples codificado em UTF-8
- Colunas separadas por tabulação (Tab-separated)
- A primeira linha define as palavras-chave
- Cada linha após a primeira fornece dados para uma instância do documento
Quantos documentos são gerados?
Cada linha do arquivo de dados gera uma instância do modelo completo. Para um modelo de 2 páginas com 3 linhas de dados, você obterá 6 páginas.
O que o símbolo @ faz em uma palavra-chave?
O
@ Introduz uma formatação especial:@Code128→ Código de barras@QR10mm→ Código QR, tamanho de 10 mm@%2f→ Número com 2 casas decimais
Posso usar códigos QR no meu modelo?
Sim. Use uma palavra-chave como
$URL@QR10mm$ em uma caixa de texto. O mapa de bits (bitmap) do código QR substituirá a palavra-chave.O que não funcionará no Editor?
Algumas palavras-chave específicas do sistema, como o nome da Fila do RIP (RIP Queue name), não serão resolvidas dentro do Editor, mas funcionarão no RIP.
Como testo minha configuração?
- Use um arquivo de teste pequeno com 2 a 3 registros
- Confirme se os IDs dos PlaceHolders e os nomes das palavras-chave correspondem
- Visualize o resultado usando a função Combinar antes da etapa do RIP
Como os dados variáveis são aplicados no RIP?
Selecione seu modelo
.st3 em Configurações da Fila > Layout (Queue Settings > Layout). Os dados variáveis são injetados como parte do processo do RIP usando a fonte de dados vinculada.