Função Validate no Power Apps

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

Descrição

Antes de um utilizador submeter uma alteração de dados, pode fornecer imediatamente feedback sobre a validade dessa submissão, o que proporciona uma melhor experiência de utilizador.

As origens de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registo. Estas informações podem incluir muitas restrições, tais como:

  • se uma coluna necessita ou não de um valor
  • o comprimento que uma cadeia de texto pode ter
  • o número mínimo e máximo possíveis
  • a data mais cedo e mais tarde possíveis

A função Validate utiliza estas informações para determinar se um valor é válido, bem como para devolver uma mensagem de erro adequada caso o valor não seja válido. Pode utilizar a função DataSourceInfo para ver as mesmas informações utilizadas pela função Validate.

As origens de dados variam na quantidade de informações de validação que fornecem, incluindo o não fornecimento de qualquer informação. A função Validate só pode verificar valores com base nestas informações. Mesmo que a função Validate não detete um problema, a aplicação da alteração dos dados poderá falhar. Pode utilizar a função Errors para obter informações sobre a falha.

Se a função Validate detetar um problema, devolverá uma mensagem de erro que pode mostrar ao utilizador da aplicação. Se todos os valores forem válidos, a função Validate devolve blank. Quando se trabalha com uma coleção que não dispõe de informações de validação, os valores são sempre válidos.

Sintaxe

Validate( OrigemDeDados, Coluna, Valor )

  • DataSource – Obrigatório. A origem de dados com a qual se validará.
  • Coluna – Obrigatório. A coluna a validar.
  • Valor – Obrigatório. O valor da coluna selecionada a validar.

Validate( OrigemDeDados, RegistoOriginal, Atualizações )

  • DataSource – Obrigatório. A origem de dados com a qual se validará.
  • RegistoOriginal – Obrigatório. O registo para o qual as atualizações serão validadas.
  • Atualizações – Obrigatório. As alterações a aplicar ao registo original.

Exemplos

Para estes exemplos, os valores na coluna Percentagem da origem de dados Pontuações têm de estar entre 0 e 100, inclusive. Se os dados forem validados, a função devolve blank. Caso contrário, a função devolve uma mensagem de erro.

Validar com uma única coluna

Fórmula Descrição Resultado
Validate( Pontuações, Percentagem, 10 ) Verifica se 10 é um valor válido para a coluna Percentagem da origem de dados Pontuações. em branco
Validate( Pontuações, Percentagem, 120 ) Verifica se 120 é um valor válido para a coluna Percentagem da origem de dados Pontuações. "Os valores têm de estar entre 0 e 100."

Validar com um registo completo

Fórmula Descrição Resultado
Validate( Pontuações, EditarRegisto, Galeria.Updates ) Verifica se os valores em todas as colunas são válidos para a origem de dados Pontuações. Neste exemplo, o valor na coluna Percentagem é 10. em branco
Validate( Pontuações, EditarRegisto, Galeria.Updates ) Verifica se os valores em todas as colunas são válidos para a origem de dados Pontuações. Neste exemplo, o valor na coluna Percentagem é 120. "Os valores têm de estar entre 0 e 100."

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).