Função Validate

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

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. Validate só pode verificar valores com base nessas informações. Mesmo se Validate não encontrar um problema, a aplicação da alteração de dados ainda poderá falhar. Você pode usar a função Errors 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 blank. 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

Validar( DataSource, Coluna, Valor )

• DataSource – Obrigatório. A fonte de dados usada para a validação.
• Coluna – Obrigatório. A coluna a ser validada.
• Valor – Obrigatório. O valor para a coluna selecionada a ser validado.

Validar( Fonte de Dados, RegistroOriginal, Atualizações )

• 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.
• Atualizações - Obrigatórias. 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
Validar (Pontuações, Porcentagem, 10)	Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações.	em branco
Validar (Pontuações, Porcentagem, 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
Validar (Pontuações, EditarRegistro, Galeria.Atualizações)	Verifica se os valores em todas as colunas são válidos para a fonte de dados de Pontuações. Neste exemplo, o valor da coluna Percentual é 10.	em branco
Validar (Pontuações, EditarRegistro, Galeria.Atualizações)	Verifica se os valores em todas as colunas são válidos para a fonte de dados de Pontuações. Neste exemplo, o valor da coluna Percentual é 120.	“Os valores devem estar entre 0 e 100”.