Funzione Validate in PowerAppsValidate function in PowerApps

La funzione Validate controlla se il valore di una singola colonna o di un record completo è valido per un'origine dati.The Validate function checks whether the value of a single column or a complete record is valid for a data source.

DescrizioneDescription

Prima che un utente invii una modifica dei dati, è possibile fornire immediatamente commenti sulla validità di tale invio per una migliore esperienza utente.Before a user submits a data change, you can provide immediate feedback on the validity of that submission, resulting in a better user experience.

Le origini dati possono offrire informazioni su quelli che sono i valori validi in un record.Data sources can provide information on what constitutes valid values within a record. Queste informazioni possono includere diversi vincoli, ad esempio:This information can include many constraints, such as these examples:

  • se un valore è obbligatorio in una colonnawhether a column requires a value
  • la lunghezza massima di una stringa di testohow long a string of text can be
  • il valore massimo e minimo di un numerohow high and low a number can be
  • il valore minimo e massimo per una datahow early and late a date can be

La funzione Validate usa queste informazioni per determinare se una valore è valido e per restituire un messaggio di errore appropriato se non lo è.The Validate function uses this information to determine whether a value is valid and to return an appropriate error message if not. È possibile usare la funzione DataSourceInfo per visualizzare le stesse informazioni usate da Validate.You can use the DataSourceInfo function to view the same information that Validate uses.

Le origini dati variano in base alla quantità di informazioni di convalida che offrono e potrebbero anche non includere nessuna informazione.Data sources vary in how much validation information they provide, including not providing any at all. Validate può verificare solo i valori basati su queste informazioni.Validate can only verify values based on this information. Anche se Validate non trova un problema, l'applicazione della modifica dei dati può comunque non riuscire.Even if Validate doesn't find a problem, applying the data change may still fail. È possibile usare la funzione Errors per ottenere informazioni sull'errore.You can use the Errors function to obtain information about the failure.

Se Validate trova un problema, la funzione restituisce un messaggio di errore che è possibile visualizzare all'utente dell'app.If Validate finds a problem, the function returns an error message that you can show to the user of the app. Se tutti i valori sono validi, Validate restituisce blank.If all values are valid, Validate returns blank. Quando si usa una raccolta senza informazioni di convalida, i valori sono sempre validi.When you work with a collection that has no validation information, values are always valid.

SintassiSyntax

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

  • OrigineDati: obbligatorio.DataSource – Required. Origine dati con cui eseguire la convalida.The data source to validate with.
  • Column: obbligatorio.Column – Required. Colonna da convalidare.The column to validate.
  • Value: obbligatorio.Value – Required. Valore per la colonna selezionata da convalidare.The value for the selected column to be validated.

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

  • OrigineDati: obbligatorio.DataSource – Required. Origine dati con cui eseguire la convalida.The data source to validate with.
  • OriginalRecord: obbligatorio.OriginalRecord - Required. Record rispetto a cui devono essere convalidati gli aggiornamenti.The record to which updates are to be validated.
  • Updates: obbligatorio.Updates - Required. Modifiche da applicare al record originale.The changes to apply to the original record.

EsempiExamples

Per questi esempi, i valori nella colonna Percentage dell'origine dati Scores devono essere compresi tra 0 e 100 inclusi.For these examples, values in the Percentage column of the Scores data source must be between 0 and 100, inclusive. Se i dati passano la convalida, la funzione restituisce blank.If the data passes validation, the function returns blank. In caso contrario, la funzione restituisce un messaggio di errore.Otherwise, the function returns an error message.

Convalidare con una colonna singolaValidate with a single column

FormulaFormula DescrizioneDescription RisultatoResult
Validate( Scores, Percentage, 10 )Validate( Scores, Percentage, 10 ) Controlla se 10 è un valore valido per la colonna Percentage nell'origine dati Scores.Checks whether 10 is a valid value for the Percentage column in the Scores data source. blankblank
Validate( Scores, Percentage, 120 )Validate( Scores, Percentage, 120 ) Controlla se 120 è un valore valido per la colonna Percentage nell'origine dati Scores.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Values must be between 0 and 100." (I valori devono essere compresi tra 0 e 100)"Values must be between 0 and 100."

Convalidare con un record completoValidate with a complete record

FormulaFormula DescrizioneDescription RisultatoResult
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Controlla se 10 è un valore valido per la colonna Percentage nell'origine dati Scores.Checks whether 10 is a valid value for the Percentage column in the Scores data source. blankblank
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Controlla se 120 è un valore valido per la colonna Percentage nell'origine dati Scores.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Values must be between 0 and 100." (I valori devono essere compresi tra 0 e 100)"Values must be between 0 and 100."