Como criar uma fórmula de validação?

A fórmula de validação é o cálculo que decide se um resultado de calibração está aprovado ou reprovado. Ela é escolhida no critério de aceitação e roda sobre os valores da tabela de resultado do certificado, comparando o que foi medido com os limites definidos. O Qualiex já traz fórmulas prontas para os casos mais comuns — erro, incerteza, porcentagem do fundo de escala; a criação manual entra quando a sua regra de aceitação não se encaixa em nenhuma delas.

✦ Antes de começar

É necessário ter a permissão Cadastrar parâmetros (grupo Parâmetros), definida em Papéis e permissões, nas Configurações do Qualiex.

A expressão não pode ser alterada depois de salva. Confira o cálculo antes de concluir o cadastro — se precisar corrigir, será necessário criar outra fórmula.

Antes de escrever, confirme os nomes das variáveis das colunas de certificado que a fórmula vai usar. Elas são acessadas pelo nome exibido da coluna.

Acessando o módulo

Para chegar até esta tela, veja Como acessar o módulo Metrologia.

Criando uma fórmula de validação

No menu lateral do Metrologia, clique em Parâmetros.

Abra a aba FÓRMULAS DE VALIDAÇÃO.

Clique em ADICIONAR FÓRMULAS DE VALIDAÇÃO.

Passo3 botao adicionar formulas de validacao

Preencha o campo Nome com uma identificação clara do critério que a fórmula aplica.

Escreva a expressão no campo Fórmula, terminando por atribuir o resultado à variável aprovado.

Preencha a Descrição explicando o que a fórmula avalia. Este campo é obrigatório e aceita até 150 caracteres.

Clique em TESTE para conferir a sintaxe.
Clique em SALVAR.

As variáveis disponíveis

A fórmula reconhece estas variáveis do contexto da medição:

valor_nom: o valor nominal do ponto medido.
amp_max e amp_min: os limites superior e inferior da faixa de medição.
limite_superior e limite_inferior: os limites definidos no critério de aceitação.
resolucao: a resolução do instrumento.
unidade: a unidade de medida do ponto.
index: a posição da linha na tabela de resultado.
tipo_erro e tipo_incerteza: a natureza dos valores tratados.
lst_resultados: a lista com os valores da linha da tabela de resultado.

Os valores das colunas de certificado não são variáveis diretas. Nomes como erro, incerteza ou valor lido não funcionam sozinhos — eles são acessados a partir de lst_resultados, informando o nome exibido da coluna.

As funções disponíveis

at(): acessa um item de uma lista pela posição.
list(): monta uma lista de valores.
getbykey(): busca um valor dentro de lst_resultados pelo nome da coluna de certificado.
if(): condicional, para decidir entre dois resultados.
abs(): valor absoluto, útil para comparar desvios sem considerar o sinal.
round(): arredondamento.

Textos dentro da fórmula vão entre aspas simples.

O resultado da fórmula

A fórmula precisa terminar definindo a variável aprovado, com verdadeiro ou falso. É esse valor que o sistema usa para marcar o resultado da calibração como aprovado ou reprovado.

⚠️ Comportamentos importantes

A expressão é definitiva. Ao editar uma fórmula já cadastrada, o campo da expressão fica somente leitura. Nome e descrição continuam editáveis, mas o cálculo não. Se a fórmula estiver errada, o caminho é criar outra e trocar a referência nos critérios de aceitação.

O TESTE usa valores aleatórios. Ele confere se a expressão é válida e mostra o que cada variável produziu, mas os números são gerados na hora — rodar duas vezes dá resultados diferentes. Não é uma simulação com os dados da sua calibração; serve para validar a sintaxe.

Resultado reprovado não é erro. Se o teste retornar aprovado como falso, a fórmula funcionou: ela apenas avaliou que aqueles valores aleatórios não passariam. O que indica problema é o teste não abrir a janela de resultados.

A mensagem de erro não indica onde está o problema. Quando a expressão é inválida, o sistema exibe sempre a mesma frase — "Verifique as funções e parâmetros inseridos." — sem apontar a linha nem o termo. A mesma mensagem aparece para erro de sintaxe, variável inexistente e função escrita errada.

Não há lista de variáveis na tela. O editor não oferece paleta, sugestão automática nem ajuda embutida. Os nomes de variáveis e funções precisam ser digitados corretamente, e esta é a referência.

Fórmulas do sistema são somente leitura. As que já vêm no módulo têm o nome bloqueado e não podem ser salvas. Nada na listagem as diferencia das suas — a única forma de descobrir é abrir o cadastro.

Perguntas frequentes

Preciso criar fórmulas para começar a usar o módulo? Não. O Qualiex já traz fórmulas prontas para os casos mais comuns, como erro, incerteza e porcentagem do fundo de escala.

Onde a fórmula é usada? No cadastro do critério de aceitação, no campo Fórmula de validação. É o critério que aplica a fórmula aos resultados da calibração.

Posso usar o valor da coluna "Erro" diretamente? Não pelo nome solto. Os valores das colunas de certificado são acessados a partir da lista de resultados, informando o nome da coluna.

Existe limite de fórmulas cadastradas? A tela não anuncia limite: não há contador nem aviso, e o botão de adicionar continua disponível. Se a sua empresa precisar de muitas fórmulas personalizadas, vale confirmar com o suporte antes de padronizar o cadastro.