Como aplicar variáveis na edição de modelos de relatório

Visão geral

As variáveis (ou "tags inteligentes") são comandos de texto inseridos entre sinais de porcentagem (ex: %nome_condominio%). Elas funcionam como curingas dentro de um modelo de texto. No momento em que o sistema gera o documento final (como uma carta ou notificação), ele substitui essas variáveis automaticamente pelos dados reais do banco de dados (o nome real do condomínio, o valor do boleto, o nome do morador, etc.).

Quando usar este artigo

Utilize este guia sempre que precisar criar ou personalizar modelos de cartas, advertências, comunicados ou relatórios de cobrança em massa, garantindo que o sistema preencha os dados individuais de cada condômino de forma automática.

Sintoma ou cenário

A administradora precisa enviar uma carta de cobrança para 50 unidades inadimplentes. Em vez de digitar 50 cartas diferentes com os nomes e valores de cada um, o operador edita um modelo único escrevendo: "Prezado(a) %nome_responsavel%, informamos que a unidade %unidade% possui débitos." O sistema fará a substituição mágica gerando 50 cartas personalizadas.

Benefício para o usuário ou operação

Automatiza a geração de documentos em lote (mala direta);
Elimina erros de digitação (como errar o nome ou o valor da dívida de um morador);
Economiza horas de trabalho manual na redação de notificações.

Onde acessar / contexto de uso

Acesse o menu onde os modelos de texto ficam disponíveis, geralmente em Condomínio > Relatórios (ou módulos de Comunicação/Cobrança) > opção "Editar modelo".

Pré-requisitos (Antes de começar)

Perfil Exato: Permissões de Escrita/Alteração no módulo correspondente onde o texto será editado.
Recursos Sistêmicos: Existência de um modelo de relatório ou carta que permita edição de texto na plataforma.
Insumos e Dados Técnicos: Ter clareza de qual informação você deseja que o sistema puxe automaticamente (ex: o CPF do morador).

Causas prováveis

Criação de novos padrões de comunicação da administradora, elaboração de cartas de cobrança extrajudicial, ou adequação de advertências do regimento interno.

Como fazer ou corrigir

As variáveis são elementos de texto inseridos entre sinais de ‘%’ e substituídas automaticamente pelos respectivos dados do condômino no momento do envio da notificação.

Acesse a licença e vá até os filtros do relatório em questão;
Verifique se nas opções do filtro, há editar modelo, conforme imagem:
Localize a seção Variáveis, onde está a lista de variáveis disponíveis para o modelo selecionado, conforme imagem:
No corpo do modelo, insira as variáveis nos locais desejados, utilizando a sintaxe correta (exemplo: %nome_condomino%), segue exemplo na imagem abaixo:
Dessa forma, será exibido no documento:
5.1 Nome do condomínio;
5.2 CNPJ do condomínio;
5.3 Nome do morador da unidade, depois do título de Sr(a).
Para garantir que os dados serão exibidos corretamente, utilize apenas as variáveis listadas no modelo.
Após inserir as variáveis necessárias, clique em Salvar para aplicar as alterações.

Observações:

Caso uma variável não esteja sendo substituída corretamente, verifique se a sintaxe foi digitada corretamente e se a variável está disponível para o modelo de relatório/carta em questão;
As variáveis disponíveis podem variar de acordo com o tipo de notificação e do relatório selecionado. Sempre consulte a lista exibida na seção Variáveis antes de finalizar a edição.

Resultado esperado

O modelo de texto será gravado com as variáveis. Ao gerar o relatório ou enviar a notificação, o sistema fará a leitura das tags e substituirá os códigos (ex: %nome_condomino%) pelas informações reais correspondentes contidas no banco de dados.

Quando escalar

Você digitou a variável exatamente como estava na lista de sugestões (ex: %valor_debito%), salvou o modelo, mas ao gerar o PDF final, o sistema imprimiu o documento em branco na parte do valor ou retornou um erro fatal de formatação.

Informações que devem ser reunidas antes do escalonamento

ID do condomínio;
Nome exato do relatório ou notificação que está sendo editada;
O texto inteiro do modelo que está apresentando falha;
Captura de tela dupla: uma mostrando o texto com a variável no editor, e outra mostrando o PDF final onde a substituição falhou.

Regras importantes / Observações

As variáveis disponíveis mudam de acordo com o módulo! Uma variável que funciona no relatório de Cobrança pode não existir no relatório de Ocorrências. Utilize apenas as variáveis que estão listadas na tela atual que você está editando. Tentar "inventar" uma variável não listada resultará em falha na substituição.

Problemas comuns e como resolver

Problema: A carta foi gerada e enviada para o morador, mas o texto saiu literalmente escrito "Prezado(a) %nome_condomino%" em vez de aparecer o nome da pessoa.
Causa provável: Erro de sintaxe na digitação. Você pode ter esquecido um dos sinais de porcentagem (ex: %nome_condomino), colocado letras maiúsculas onde não deveria, ou usado uma variável que não pertence àquele módulo.
Ação recomendada: Volte à edição do modelo, apague a variável digitada, consulte a lista lateral de "Variáveis", copie o termo exato fornecido pelo sistema e cole no seu texto. Salve e gere um teste.

Dúvidas relacionadas

P: Posso criar uma variável nova que não está na lista, tipo %placa_carro_visitante%?
R: Não. As variáveis são programadas diretamente no código-fonte do sistema para puxar tabelas específicas do banco de dados. Se a variável não estiver listada no menu lateral daquela tela, o sistema não saberá como interpretá-la.

P: Se eu apagar a variável do modelo, perco o dado do morador no sistema?
R: Não. A variável é apenas um espelho. Apagá-la do texto só faz com que aquela informação deixe de ser impressa na carta, mas o dado original permanece intacto no cadastro do condômino.

Palavras-chave de busca

aplicar variáveis relatório, editar modelo de carta, tag inteligente texto, automatizar notificação, erro porcentagem texto, mala direta condomínio, variáveis disponíveis sistema, %nome_condomino%