Condições Especiais
Entenda os campos com comportamentos especiais
Alguns tipos de campo no ENSPACE possuem comportamentos que diferem do padrão — seja na forma como armazenam dados, na forma como interagem com eventos ou nas limitações de onde seus valores podem ser utilizados. Esta página documenta essas particularidades para que você saiba o que esperar ao configurá-los.
Valor Monetário
O campo Valor Monetário não armazena apenas um número — ele armazena um objeto composto por três partes: o valor numérico processado, o valor original informado e o código da moeda.
{
"currency": "BRL",
"value": 1000,
"originalValue": 1000
}
- value — valor numérico atual processado pelo sistema.
- originalValue — valor original informado inicialmente pelo usuário.
- currency — código da moeda utilizada (ex:
BRL,USD).
Essa estrutura é relevante quando você utiliza o campo em eventos de campo, pois precisa saber como enviar e como ler o valor corretamente.
Editando via evento
Para editar um campo Valor Monetário por meio de um evento de campo, o valor enviado precisa ser numérico. São aceitos:
- Um número vindo de qualquer outro campo do formulário, desde que o valor retornado seja numérico (campo numérico, texto curto com valor numérico, valor de uma opção de lista, etc.).
- O valor de outro campo do tipo Valor Monetário.
Usando como referência em eventos
Quando o campo Valor Monetário é o campo gatilho de um evento, você pode acessar cada parte do objeto separadamente:
| Expressão | O que retorna | Quando usar |
|---|---|---|
{{payload}} | Objeto completo (valor, moeda e valor original). | Copiar para outro campo de Valor Monetário. |
{{payload.value}} | Apenas o valor numérico. | Copiar para um campo numérico ou usar em cálculos. |
{{payload.currency}} | Código da moeda (ex: BRL, USD). | Copiar para um campo de texto. |
Campo Virtual
O Campo Virtual exibe informações calculadas ou derivadas de outros campos, sem permitir edição manual. Ele aparece nos formulários em modo somente leitura — o usuário vê o resultado, mas não pode alterá-lo.
Por que é especial
O valor do campo virtual é gerado no front-end (na tela do usuário) e não é registrado no banco de dados. Na prática, isso significa que:
- O campo é exibido corretamente nos formulários e na tela dedicada do item.
- O valor não pode ser usado diretamente em templates de documento, templates de e-mail ou colunas de expressão de relatórios — porque esses contextos buscam dados do banco de dados, onde o campo virtual não existe.
Como utilizar o valor fora do formulário
Para usar o resultado de um campo virtual em templates, relatórios ou outros contextos que dependem de dados persistidos, é necessário transferir o valor para outro campo ou replicar a fórmula. Existem três formas:
Evento de campo — configure um evento no campo virtual com o gatilho Editado e a ação Editar Campos, apontando para um campo de destino que receberá o valor. Sempre que o campo virtual for recalculado, o valor será copiado para o campo de destino.
| Campo | Valor |
|---|---|
campo_destino | {{payload}} |
Valor inicial de outro campo — configure outro campo com um valor inicial que referencie o campo virtual: {{data.referencia_do_campo_virtual}}. O campo de destino será preenchido automaticamente com o valor do campo virtual na criação do item.
Replicar a fórmula — em vez de buscar o valor do campo virtual, replique a mesma fórmula/expressão diretamente no template de documento, template de e-mail ou coluna de expressão do relatório. O resultado será o mesmo, calculado no momento da geração.
ID Personalizado
O ID Personalizado é um campo que gera automaticamente um identificador customizado para cada item da categoria, com base em uma expressão configurada. Diferente dos demais campos, ele não aparece em formulários — o ID é gerado automaticamente quando o item é criado e exibido apenas na tabela de itens.
Por que é especial
Assim como o campo virtual, o ID Personalizado é gerado no front-end e não é registrado no banco de dados. Isso significa que:
- O ID aparece na tabela de itens da categoria.
- O valor não pode ser editado manualmente — é sempre calculado automaticamente pela expressão configurada.
- O valor não pode ser usado diretamente em templates de documento, templates de e-mail ou colunas de expressão de relatórios.
Como utilizar o valor fora da tabela de itens
As mesmas soluções do campo virtual se aplicam:
Evento de campo — configure um evento no campo de ID Personalizado com o gatilho Editado e a ação Editar Campos, copiando o valor para um campo de texto:
| Campo | Valor |
|---|---|
id_texto | {{payload}} |
Replicar a fórmula — replique a expressão que gera o ID diretamente no template ou coluna de relatório.