Documentação HorusBI
Buscar K

Aparência

Validações e expressões ​

Duas ferramentas para deixar seu Cadastro mais robusto: validações garantem a qualidade do dado na hora de salvar, e expressões enriquecem o BI com colunas calculadas.

✅ Validações ​

Uma validação é uma regra que decide se um registro pode ou não ser salvo. As regras são escritas em JavaScript e avaliadas no servidor, num ambiente isolado e seguro.

Elas rodam ao salvar um registro — pelo formulário ou pela grade. Se a regra falhar, o registro não é gravado e o usuário recebe a mensagem que você definiu.

Exemplos típicos:

  • Valor positivo — uma meta ou quantidade tem que ser maior que zero.
  • Data não futura — uma data de competência não pode estar no futuro.
  • Coerência entre campos — a data final precisa ser maior ou igual à inicial.
  • Faixa válida — um percentual tem que ficar entre 0 e 100.

IA no editor de validações

O editor tem auxílio de IA: descreva a regra em português ("o valor não pode ser negativo") e ela gera o código; ou peça para explicar uma regra existente. Você sempre revisa o resultado antes de salvar.

🧮 Expressões ​

Uma expressão é uma coluna calculada que você define no Cadastro. Ela não é digitada na grade — o valor é derivado de outros campos — e aparece como coluna no BI, pronta para usar em widgets e dashboards.

Use expressões quando o número é sempre o resultado de uma conta e não faz sentido alguém digitar à mão:

  • Margem = (receita − custo) / receita
  • Atingimento = realizado / meta
  • Faixa classificada a partir de um valor numérico

Como o valor é calculado, ele se mantém coerente automaticamente: mude um campo de origem e a expressão acompanha.

NOTE

Expressões são só para o BI — elas não são editáveis na grade nem no formulário. Para um valor que as pessoas precisam digitar, use um campo normal (veja Criar e estruturar).

Validações não rodam na importação

As validações são aplicadas quando alguém salva um registro na plataforma — não durante a importação de planilha. A importação assume que o dado já vem limpo; ela faz apenas as checagens de estrutura (tipos, campos obrigatórios). Confira os dados antes de importar — veja Importar e exportar.