Validate funkcija

Attiecas uz: Audekla programmas Modeļa vadītas programmas

Funkcija Validate pārbauda, vai vienas kolonnas vai pilna ieraksta vērtība ir derīga datu avotam.

Apraksts

Pirms lietotājs iesniedz datu izmaiņas, varat nodrošināt tūlītējas atsauksmes par šī iesnieguma derīgumu, tādējādi uzlabojot klientu pieredzi.

Datu avoti var nodrošināt informāciju par to, kas veido derīgas vērtības ierakstā. Šī informācija var ietvert daudzus ierobežojumus, piemēram, šādus piemērus:

• vai kolonnai ir nepieciešama vērtība
• cik gara var būt teksta virkne
• cik augsts un cik zems var būt skaitlis
• cik agrs un vēls var būt datums

Funkcija Validate izmanto šo informāciju, lai noteiktu, vai vērtība ir derīga, un, ja tā nav, atgrieztu atbilstošu kļūdas ziņojumu. Funkciju DataSourceInfo var izmantot, lai skatītu to pašu informāciju, kas Validate tiek izmantota.

Datu avoti atšķiras pēc tā, cik daudz validēšanas informācijas tie nodrošina, tostarp nesniedzot vispār nekādu informāciju. Validate var pārbaudīt vērtības, pamatojoties tikai uz šo informāciju. Pat ja Validate problēma netiek atrasta, datu izmaiņu lietošana joprojām var neizdoties. Varat izmantot funkciju Errors, lai iegūtu informāciju par kļūmi.

Ja Validate tiek atrasta problēma, funkcija atgriež kļūdas ziņojumu, ko varat parādīt programmas lietotājam. Ja visas vērtības ir derīgas, Validate atgriež tukšu. Kad strādājat ar kolekciju, kurai nav validācijas informācijas, vērtības vienmēr ir derīgas.

Sintakse

Validate( Datu avots, kolonna, vērtība )

• DataSource - Obligāts. Datu avots, ar kuru validēt.
• Kolonna - Obligāts. Validējamā kolonna.
• Vērtība - Obligāts. Atlasītās validējamās kolonnas vērtība.

Validate( Datu avots, Oriģinālieraksts, atjauninājumi )

• DataSource - Obligāts. Datu avots, ar kuru validēt.
• OriginalRecord - Obligāts. Ieraksts, kuram tiek validēti atjauninājumi.
• Atjauninājumi- Nepieciešams. Izmaiņas, ko piemērot sākotnējam ierakstam.

Piemēri

Šiem piemēriem datu avota Scores kolonnas Īpatsvars vērtībām ir jābūt no 0 līdz 100, ieskaitot. Ja dati iziet validāciju, funkcija atgriež tukšu vērtību. Pretējā gadījumā funkcija atgriež kļūdas ziņojumu.

Validate ar vienu kolonnu

Formula	Apraksts	Rezultāts
Validate( Rezultāti, procenti, 10 )	Pārbauda, vai 10 ir derīga vērtība kolonnai Īpatsvars datu avotā Scores.	Tukša
Validate( Rezultāti, procenti, 120 )	Pārbauda, vai 120 ir derīga vērtība kolonnai Īpatsvars datu avotā Scores.	"Vērtībām jābūt starp 0 un 100."

Validate ar pilnīgu ierakstu

Formula	Apraksts	Rezultāts
Validate( Partitūras, EditRecord, Gallery.Updates )	Pārbauda, vai vērtības visās kolonnās ir derīgas datu avotam Scores. Šajā piemērā kolonnas Īpatsvars vērtība ir 10.	Tukša
Validate( Partitūras, EditRecord, Gallery.Updates )	Pārbauda, vai vērtības visās kolonnās ir derīgas datu avotam Scores. Šajā piemērā kolonnas Īpatsvars vērtība ir 120.	"Vērtībām jābūt starp 0 un 100."