[AEM Forms]{class="badge positive" title="Aplicável ao AEM Forms)."}
Componente de variável não vinculado no editor de comunicação interativa
1. Introdução
O componente Variável desvinculada no editor de IC (comunicação interativa) permite colocar um campo cujo valor não esteja vinculado a nenhum nó de esquema ou modelo de dados externo. Em vez disso, o valor é fornecido por meio de script, cálculo baseado em regras ou um padrão estático, tornando esse componente a escolha correta sempre que você precisar de um valor de exibição calculado ou intermediário que não venha diretamente de uma fonte de dados vinculada.
Como uma variável não vinculada não está conectada a um modelo de dados de formulário, ela oferece controle total de criação sobre o valor no tempo de design e tempo de execução. Você pode usá-lo para exibir totais calculados, números de referência gerados dinamicamente, resultados de fórmula intermediários ou qualquer outro valor que o mecanismo de regras produza.
O componente oferece suporte a todos os quatro tipos de dados Texto, Numérico, Data e Data/Hora, e o tipo de dados ativo determina a sintaxe do padrão de exibição e os símbolos da cláusula de imagem que são aplicados.
2. Padrão de exibição
Você pode atribuir um padrão de exibição a um campo Variável não vinculado do painel Propriedades, usando os mesmos controles padrão de exibição disponíveis para os componentes Caixa de Texto, Campo Numérico, Campo de Data e Campo de Data/Hora. Isso permite a apresentação formatada de valores computados ou referenciados na pré-visualização da tela e na saída gerada.
O padrão configurado é refletido imediatamente na pré-visualização da tela de desenho e é preservado nos ciclos de salvamento e recarregamento.
Configurar um padrão de exibição
- Selecione o componente Variável não vinculado na tela de design.
- Abra o painel Propriedades.
- Na seção Padrão de Exibição, escolha um padrão predefinido ou insira uma cláusula de imagem personalizada.
- Visualize o valor formatado na tela.
Escolha do padrão correto
Como uma Variável não vinculada pode conter qualquer tipo de dados, a sintaxe da cláusula de imagem usada deve corresponder ao tipo de dados configurado no campo:
YYYY-MM-DD ou YYYY-MM-DDTHH:MM). Os valores que não seguem esse formato são exibidos como estão, sem o padrão de exibição aplicado.3. Propriedades
O componente Variável não vinculada compartilha um conjunto comum de propriedades com outros componentes de campo, com uma distinção principal: ele oferece suporte às opções de vinculação de dados externos para qualquer fonte de dados ou fragmento de Comunicação interativa.
3.1 Campo básico
-
Nome: um identificador exclusivo para a variável. Usado para referenciá-lo em regras, scripts e expressões dentro da IC.
-
Tipo de Dados: Especifica o tipo de valor que esta variável contém Texto, Numérico, Data ou Data/Hora. O tipo de dados selecionado determina qual sintaxe de padrão de exibição se aplica e como o valor é validado.
-
Legenda: o rótulo exibido ao lado do campo na tela (por exemplo, “Total Calculado” ou “Número de Referência”).
-
Valor: o valor padrão ou calculado exibido no campo. Na maioria dos casos, isso é definido de forma programática usando o Editor de regras ou um script, em vez de ser digitado manualmente.
-
Reservar: um valor de fallback exibido quando nenhum valor calculado estiver disponível, útil para saída somente de impressão ou somente leitura, onde um campo em branco é inaceitável.
-
Aparência: uma predefinição de estilo visual (Nenhum, Caixa Sólida ou Sublinhado) para o contêiner de campo.
3.2 Tipografia
Controla o estilo do valor exibido:
-
Variação de fonte: escolha a família da fonte, o peso (Regular, Negrito) e o estilo (Itálico) para corresponder ao conteúdo ao redor.
-
Tamanho da Fonte: normalmente definido como 10 pt por padrão; ajuste para manter a consistência visual com o restante da comunicação.
3.3 Posição
Define o posicionamento do componente na tela:
-
Coordenadas de X e Y: defina a posição horizontal e vertical exata.
-
Largura e Altura: especifique dimensões em milímetros para alinhar com elementos adjacentes.
3.4 Margem
Define o espaçamento ao redor do limite do componente:
-
Superior (Acima)
-
Inferior (Abaixo)
-
Esquerda
-
Direita
3.5 Aparência
Estilos do contêiner de campo:
-
Preenchimento: Cor de fundo do campo.
-
Traço: Borda ao redor do campo, com as seguintes opções:
-
Largura: Espessura da borda.
-
Estilo: Sólido, tracejado ou pontilhado.
-
Edge: Cantos arredondados ou nítidos.
-
3.6 Presença
Controla a visibilidade no tempo de execução:
-
Visível: o campo é exibido e ocupa espaço de layout.
-
Oculto (mantém espaço): O campo é invisível, mas seu espaço de layout é preservado, útil ao alternar a visibilidade dinamicamente usando o Editor de Regras.
4. Uso
Use uma variável não vinculada quando o valor que você deseja exibir for:
-
Calculado por uma regra ou um script — por exemplo, um total acumulado, um cálculo de imposto ou um valor de desconto derivado de outros valores de campo.
-
Gerado programaticamente — por exemplo, um número de referência ou código de rastreamento atribuído em tempo de execução pela lógica de back-end.
-
Não disponível no modelo de dados — por exemplo, um resultado intermediário que é significativo na tela, mas não existe como um campo de esquema.
-
Condicionalmente visível — exibe uma mensagem ou valor calculado somente quando condições específicas são atendidas, usando o Editor de Regras para definir visibilidade e valor juntos.
Você pode colocar uma Variável não vinculada dentro de subformulários, contêineres de layout ou diretamente na tela de design. Combine-o com o Editor de regras para escrever expressões que calculam seu valor com base em outros campos vinculados na IC.
5. Práticas recomendadas
-
Defina um valor de Reserva significativo para que a saída de impressão e as visualizações somente leitura nunca mostrem um campo em branco quando o valor calculado estiver indisponível.
-
Corresponder o tipo de dados à saída — se estiver calculando um valor de moeda, defina o tipo de dados como Numérico e aplique um padrão de exibição numérico; se estiver calculando uma data, defina-a como Data e garanta a entrada ISO 8601.
-
Use uma Legenda clara — como o valor é calculado e não é diretamente reconhecível a partir de um rótulo, uma legenda descritiva (por exemplo, “Subtotal (calculado)”) evita confusão para os revisores e usuários finais.
-
Evite o uso excessivo de Variáveis Não Associadas para dados que pertencem ao modelo. Se for razoável adicionar um valor ao Modelo de Dados de Formulário, prefira vincular um campo padrão. Reservar Variáveis Não Vinculadas para valores genuinamente transitórios ou derivacionais.
-
Documentar suas expressões — adicione um comentário no Editor de Regras descrevendo o que cada Variável Não Associada computa, para que a lógica permaneça manterá quando a IC for editada posteriormente.
Consulte também:
- Componente de Caixa de Texto — exibir sintaxe de padrão para valores de texto
- Componente de Campo Numérico — exibe a sintaxe do padrão para valores numéricos e de moeda
- Componente de Campo de Data — exibir sintaxe de padrão para datas
- Componente de Campo de Data/Hora — exibir sintaxe de padrão para valores combinados de data e hora
- Usar o Editor de Regras no Editor de Comunicação Interativa — gravar expressões para calcular e atribuir valores a Variáveis Desassociadas
- Configurar a vinculação de dados no Editor de comunicações interativas