A função Validate verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.

Descrição

Antes que um usuário envie uma alteração de dados, você pode fornecer um feedback imediato sobre a validade desse envio, resultando em uma melhor experiência para o usuário.

Fontes de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registro. Essas informações podem incluir muitas restrições, conforme os exemplos a seguir: - se uma coluna requer um valor - o comprimento máximo de uma cadeia de caracteres - limites mínimo e máximo de um número - limites mínimo e máximo de uma data

A função Validate usa essas informações para determinar se um valor é válido e retornar uma mensagem de erro apropriada se o valor não for válido. Você pode usar a função DataSourceInfo para exibir as mesmas informações que a função Validate.

As fontes de dados variam em quantas informações de validação elas fornecem, incluindo não fornecer nenhuma. A função Validate só pode verificar valores com base nessas informações. Mesmo se a função Validate não encontrar um problema, ainda pode ocorrer uma falha ao aplicar a alteração de dados. Você pode usar a função Erros para obter informações sobre a falha.

Se a função Validate encontrar um problema, a função retornará uma mensagem de erro que você pode mostrar ao usuário do aplicativo. Se todos os valores forem válidos, a função Validate retorna em branco. Quando você trabalha com um coleção que não possui nenhuma informação de validação, os valores são sempre válidos.

Sintaxe

Validate( DataSource, Column, Value )

  • DataSource – Obrigatório. A fonte de dados usada para a validação.

  • Column – Obrigatório. A coluna a ser validada.

  • Value – obrigatório. O valor para a coluna selecionada a ser validado.

Validate( DataSource, OriginalRecord, Updates )

  • DataSource – Obrigatório. A fonte de dados usada para a validação.

  • OriginalRecord - Obrigatório. O registro para o qual as atualizações devem ser validadas.

  • Updates - Obrigatório. As alterações a serem aplicadas ao registro original.

Exemplos

Para esses exemplos, os valores na coluna porcentagem da fonte de dados de Pontuações deve estar entre 0 e 100, inclusive. Se os dados passam na validação, a função retorna em branco. Caso contrário, a função retornará uma mensagem de erro.

Validar com uma única coluna

Fórmula Descrição Resultado
Validate( Scores, Percentage, 10 ) Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. em branco
Validate( Scores, Percentage, 120 ) Verifica se 120 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. “Os valores devem estar entre 0 e 100”.

Validar com um registro completo

Fórmula Descrição Resultado
Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. em branco
Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 120 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. “Os valores devem estar entre 0 e 100”.