Quando você salva uma expressão, ela sempre é verificada para assegurar que é válida. Também é possível verificar se a expressão é válida antes de salvá-lo.
A validação verifica a sintaxe da expressão, verifica se as propriedades especificadas estão presentes no armazenamento de dados atual, e verifica se os valores da propriedade são válidos.
Quando é possível, a operação de validação exibe uma mensagem que descreve os erros localizados. Frequentemente, é possível clicar na mensagem de erro para que o cursor seja colocado no local do problema e você possa corrigi-lo.
A validação pode falhar por um dos seguintes motivos:
- Um caractere separador está faltando ou é inválido. Por exemplo, para algumas funções, vírgulas devem separar cada argumento. Talvez uma das vírgulas esteja ausente ou foi inserido um ponto e vírgula em vez de uma vírgula.
- Um operador ou propriedade está ausente. Este problema é comum em expressões com várias condições. Por exemplo, a expressão PARCEL_VALUE > 100000 AND <200000 é inválida. A sintaxe correta é PARCEL_VALUE > 100000 AND PARCEL_VALUE < 200000. Observe que no segundo exemplo, PARCEL_VALUE aparece duas vezes, enquanto no primeiro exemplo aparece somente uma vez.
- Um caractere ou a propriedade é do tipo errado. Este problema pode ocorrer se você utilizar um operador que solicita um valor numérico, e foi inserido um caractere de texto no lugar. Para uma função que requer um valor hexadecimal, um numeral pode causar um erro. Para uma função que requer uma propriedade numérica, uma propriedade de texto causa um erro.
- Um valor necessário está faltando ou "vazio". Talvez você não tenha inserido um valor de propriedade ou um valor para um argumento.
- Falta um caractere de colchete, aspas ou parêntesis na expressão. Por exemplo, há um colchete de abertura que não tem um colchete de fechamento relacionado. Este problema é comum em expressões complexas.
O processo de validação ajuda a evitar muitos erros, mas ele não pode garantir que a expressão funcionará da maneira prevista quando for aplicado. A validação não executa a consulta contra dados reais. Ela verifica apenas se a sintaxe da expressão está correta e se as propriedades e os valores são válidos para o armazenamento de dados atual.
Para validar uma expressão
- Selecione o comando para o qual deseja criar uma expressão.
- Crie a expressão.
- Salve a expressão ou clique em Validar.
- Se o painel de validação exibir erros, clique na mensagem de erro para mover o cursor para a área do problema.
- Solucione os problemas e execute a verificação de validação novamente, até que o painel de validação indique que a expressão é válida.
Para obter ajuda sobre os elementos de expressão, consulte Criação de expressões - Referência.