Função Validate no PowerAppsValidate function in PowerApps

A função Validate verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.The Validate function checks whether the value of a single column or a complete record is valid for a data source.

DescriçãoDescription

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.Before a user submits a data change, you can provide immediate feedback on the validity of that submission, resulting in a better user experience.

Fontes de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registro.Data sources can provide information on what constitutes valid values within a record. Essas informações podem incluir muitas restrições, conforme os exemplos a seguir:This information can include many constraints, such as these examples:

  • se uma coluna requer um valorwhether a column requires a value
  • o comprimento máximo de uma cadeia de caractereshow long a string of text can be
  • limites mínimo e máximo de um númerohow high and low a number can be
  • limites mínimo e máximo de uma datahow early and late a date can be

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.The Validate function uses this information to determine whether a value is valid and to return an appropriate error message if not. Você pode usar a função DataSourceInfo para exibir as mesmas informações que a função Validate.You can use the DataSourceInfo function to view the same information that Validate uses.

As fontes de dados variam em quantas informações de validação elas fornecem, incluindo não fornecer nenhuma.Data sources vary in how much validation information they provide, including not providing any at all. A função Validate só pode verificar valores com base nessas informações.Validate can only verify values based on this information. Mesmo se a função Validate não encontrar um problema, ainda pode ocorrer uma falha ao aplicar a alteração de dados.Even if Validate doesn't find a problem, applying the data change may still fail. Você pode usar a função Erros para obter informações sobre a falha.You can use the Errors function to obtain information about the failure.

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.If Validate finds a problem, the function returns an error message that you can show to the user of the app. Se todos os valores forem válidos, a função Validate retorna em branco.If all values are valid, Validate returns 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.When you work with a collection that has no validation information, values are always valid.

SintaxeSyntax

Validate( DataSource, Column, Value )Validate( DataSource, Column, Value )

  • Fonte de dados – Obrigatório.DataSource – Required. A fonte de dados usada para a validação.The data source to validate with.
  • Column – Obrigatório.Column – Required. A coluna a ser validada.The column to validate.
  • Value – obrigatório.Value – Required. O valor para a coluna selecionada a ser validado.The value for the selected column to be validated.

Validate( DataSource, OriginalRecord, Updates )Validate( DataSource, OriginalRecord, Updates )

  • Fonte de dados – Obrigatório.DataSource – Required. A fonte de dados usada para a validação.The data source to validate with.
  • OriginalRecord - Obrigatório.OriginalRecord - Required. O registro para o qual as atualizações devem ser validadas.The record to which updates are to be validated.
  • Updates - Obrigatório.Updates - Required. As alterações a serem aplicadas ao registro original.The changes to apply to the original record.

ExemplosExamples

Para esses exemplos, os valores na coluna porcentagem da fonte de dados de Pontuações deve estar entre 0 e 100, inclusive.For these examples, values in the Percentage column of the Scores data source must be between 0 and 100, inclusive. Se os dados passam na validação, a função retorna em branco.If the data passes validation, the function returns blank. Caso contrário, a função retornará uma mensagem de erro.Otherwise, the function returns an error message.

Validar com uma única colunaValidate with a single column

FórmulaFormula DescriçãoDescription ResultadoResult
Validate( Scores, Percentage, 10 )Validate( Scores, Percentage, 10 ) Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações.Checks whether 10 is a valid value for the Percentage column in the Scores data source. em brancoblank
Validate( Scores, Percentage, 120 )Validate( Scores, Percentage, 120 ) Verifica se 120 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações.Checks whether 120 is a valid value for the Percentage column in the Scores data source. “Os valores devem estar entre 0 e 100”."Values must be between 0 and 100."

Validar com um registro completoValidate with a complete record

FórmulaFormula DescriçãoDescription ResultadoResult
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações.Checks whether 10 is a valid value for the Percentage column in the Scores data source. em brancoblank
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 120 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações.Checks whether 120 is a valid value for the Percentage column in the Scores data source. “Os valores devem estar entre 0 e 100”."Values must be between 0 and 100."