Validate funcționa

Se aplică la: Aplicații pânză bazate pe modele de aplicații

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 determina dacă o valoare este validă și pentru a returna un mesaj de eroare corespunzător, dacă nu. Puteți utiliza funcția DataSourceInfo pentru a vizualiza aceleași informații care Validate se utilizează.

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 pe baza acestor informații. Chiar dacă Validate nu găsește o problemă, aplicarea modificării datelor poate să nu reușească. 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ă necompletate. Atunci când lucrați cu o colecție care nu are informații de validare, valorile sunt întotdeauna valide.

Sintaxă

Validate( Sursă de date, coloană, valoare )

• DataSource – Obligatoriu. Sursa de date de utilizat pentru validare.
• Coloană – Obligatoriu. Coloana de validat.
• Valoare – 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.
• Actualizări - Obligatorii. 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.

Validate cu o singură coloană

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

Validate cu o înregistrare completă

Formulă	Descriere	Rezultat
Validate( Scoruri, EditareÎnregistrare, Galerie.Actualizări )	Verifică dacă valorile din toate coloanele sunt valide pentru sursa de date Scores. În acest exemplu, valoarea din coloana Percentage este 10.	necompletat
Validate( Scoruri, EditareÎnregistrare, Galerie.Actualizări )	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."