Validați funcția

Se aplică pentru: planșă de lucru apps Aplicații bazate pe model

Funcția Validate verifică dacă valoarea unei singure coloane sau a unei înregistrări complete este validă pentru o sursă de date.

Descriere

Înainte ca un utilizator să remită o modificare a datelor, puteți furniza feedback imediat cu privire la validitatea acestei remiteri pentru a îmbunătăți experiența utilizatorului.

Sursele de date pot furniza informații despre ceea ce constituie valori valide într-o înregistrare. Aceste informații pot include numeroase constrângeri, cum ar fi:

• dacă o coloană necesită o valoare
• lungimea maximă a unui șir de text
• valoarea minimă și maximă a unui număr
• valoarea minimă și maximă a unei date

Funcția Validate utilizează aceste informații pentru a stabili dacă o valoare este validă și, în caz contrar, pentru a returna un mesaj de eroare adecvat. Puteți utiliza funcția DataSourceInfo pentru a vizualiza aceleași informații pe care le utilizează Validate.

Sursele de date nu furnizează toate aceeași cantitate de informații de validare și este posibil să nu furnizeze nicio informație. Validate poate verifica numai valorile bazate pe aceste informații. Chiar dacă Validate nu găsește nicio problemă, aplicarea modificării datelor poate totuși să eșueze. Puteți utiliza funcția Errors pentru a obține informații despre eșec.

Dacă Validate găsește o problemă, funcția returnează un mesaj de eroare pe care îl puteți afișa utilizatorului aplicației. Dacă toate valorile sunt valide, Validate returnează valoare necompletată blank. Atunci când lucrați cu o colecție care nu are informații de validare, valorile sunt întotdeauna valide.

Sintaxă

Validate( DataSource, Column, Value )

• DataSource – Obligatoriu. Sursa de date de utilizat pentru validare.
• Column – Obligatoriu. Coloana de validat.
• Value - Obligatoriu. Valoarea pentru coloana selectată care trebuie validată.

Validate( DataSource, OriginalRecord, Updates )

• DataSource – Obligatoriu. Sursa de date de utilizat pentru validare.
• OriginalRecord - Obligatoriu. Înregistrarea pentru care trebuie validate actualizările.
• Updates - Obligatoriu. Modificările de aplicat la înregistrarea originală.

Exemple

Pentru aceste exemple, valorile din coloana Percentage ale sursei de date Scores trebuie să fie cuprinse între 0 și 100, inclusiv. Dacă datele sunt validate, funcția returnează o valoare necompletată. În caz contrar, funcția returnează un mesaj de eroare.

Funcția Validate cu o singură coloană

Formulă	Descriere	Rezultat
Validate( Scores, Percentage, 10 )	Verifică dacă 10 este o valoare validă pentru coloana Percentage din sursa de date Scores.	blank
Validate( Scores, Percentage, 120 )	Verifică dacă 120 este o valoare validă pentru coloana Percentage din sursa de date Scores.	"Valorile trebuie să fie între 0 și 100."

Validați cu o înregistrare completă

Formulă	Descriere	Rezultat
Validate( Scores, EditRecord, Gallery.Updates )	Verifică dacă valorile din toate coloanele sunt valide pentru sursa de date Scores. În acest exemplu, valoarea din coloana Percentage este 10.	blank
Validate( Scores, EditRecord, Gallery.Updates )	Verifică dacă valorile din toate coloanele sunt valide pentru sursa de date Scores. În acest exemplu, valoarea din coloana Percentage este 120.	"Valorile trebuie să fie între 0 și 100."