Funzione Validate

Si applica a: App canvas app basate su modello

La Validate funzione controlla se il valore di una singola colonna o di un record completo è valido per un'origine dati.

Descrizione

Prima che un utente invii una modifica dei dati, puoi fornire immediatamente commenti sulla validità di tale invio per una migliore esperienza utente.

Le origini dati possono offrire informazioni su quelli che sono i valori validi in un record. Queste informazioni possono includere diversi vincoli, ad esempio:

• se un valore è obbligatorio in una colonna
• la lunghezza massima di una stringa di testo
• il valore massimo e minimo di un numero
• il valore minimo e massimo per una data

La Validate funzione usa queste informazioni per determinare se un valore è valido e restituire un messaggio di errore appropriato in caso contrario. È possibile utilizzare la funzione DataSourceInfo per visualizzare le stesse informazioni utilizzate Validate .

Le origini dati variano in base alla quantità di informazioni di convalida che offrono e potrebbero anche non includere nessuna informazione. Validate può verificare solo i valori in base a queste informazioni. Anche se Validate non viene trovato un problema, l'applicazione della modifica dei dati potrebbe comunque non riuscire. Puoi usare la funzione Errors per ottenere informazioni sull'errore.

Se Validate rileva un problema, la funzione restituisce un messaggio di errore che è possibile visualizzare all'utente dell'app. Se tutti i valori sono validi, Validate restituisce vuoto. Quando usi una raccolta senza informazioni di convalida, i valori sono sempre validi.

Sintassi

Validate( DataSource, Column, Value )

• DataSource: obbligatorio. Origine dati con cui eseguire la convalida.
• Colonna – Obbligatorio. Colonna da convalidare.
• Valore – Obbligatorio. Valore per la colonna selezionata da convalidare.

Validate( DataSource, OriginalRecord, Updates )

• DataSource: obbligatorio. Origine dati con cui eseguire la convalida.
• OriginalRecord - Obbligatorio. Record rispetto a cui devono essere convalidati gli aggiornamenti.
• Aggiornamenti - Obbligatori. Modifiche da applicare al record originale.

Esempi

Per questi esempi, i valori nella colonna Percentage dell'origine dati Scores devono essere compresi tra 0 e 100 inclusi. Se i dati passano la convalida, la funzione restituisce blank. In caso contrario, la funzione restituisce un messaggio di errore.

Validate con una singola colonna

Formula	Descrizione	Risultato
Validate( Punteggi, Percentuale, 10 )	Controlla se 10 è un valore valido per la colonna Percentage nell'origine dati Scores.	vuoto
Validate( Punteggi, Percentuale, 120 )	Controlla se 120 è un valore valido per la colonna Percentage nell'origine dati Scores.	"Values must be between 0 and 100." (I valori devono essere compresi tra 0 e 100)

Validate con un record completo

Formula	Descrizione	Risultato
Validate( Punteggi, EditRecord, Gallery.Updates )	Verifica la validità dei valori in tutte le colonne per l'origine dati Scores. In questo esempio il valore della colonna Percentage è 10.	vuoto
Validate( Punteggi, EditRecord, Gallery.Updates )	Verifica la validità dei valori in tutte le colonne per l'origine dati Scores. In questo esempio il valore della colonna Percentage è 120.	"Values must be between 0 and 100." (I valori devono essere compresi tra 0 e 100)