Validēt funkciju
Attiecas uz: Pamatnes programmām Modeļa vadītas programmas
Funkcija Validate pārbauda, vai vienas kolonnas vai vesela 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 lai atgrieztu atbilstošo kļūdas ziņojumu, ja tā nav. Varat izmantot funkciju DataSourceInfo, lai skatītu tādu pašu informāciju, kādu izmanto funkcija Validate.
Datu avoti atšķiras pēc tā, cik daudz validēšanas informācijas tie nodrošina, tostarp nesniedzot vispār nekādu informāciju. Validēt var pārbaudīt tikai vērtības, pamatojoties uz šo informāciju. Pat ja funkcija Validate neatrod problēmu, datu izmaiņu piemērošana joprojām var neizdoties. Varat izmantot funkciju Errors, lai iegūtu informāciju par kļūmi.
Ja funkcija Validate atrod problēmu, funkcija atgriež kļūdas ziņojumu, ko var parādīt programmas lietotājam. Ja visas vērtības ir derīgas, funkcija Validate atgriež blank vērtību. Kad strādājat ar kolekciju, kurai nav validācijas informācijas, vērtības vienmēr ir derīgas.
Sintakse
Validēt(DataSource,Column,Value )
- 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.
Validēt(DataSource,OriginalRecord,Updates )
- 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.
Validēt ar vienu kolonnu
Formula | Apraksts | Rezultāts |
---|---|---|
Validēt( Rezultāti, Procenti, 10 ) | Pārbauda, vai 10 ir derīga vērtība kolonnai Īpatsvars datu avotā Scores. | Tukša |
Validēt( 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." |
Validēt ar pilnu ierakstu
Formula | Apraksts | Rezultāts |
---|---|---|
Validēt( Scores, 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 |
Validēt( Scores, 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." |