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. Funkcija Validate var pārbaudīt vērtības, tikai 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
Validate( DataSource, Column, Value )
- DataSource – Obligāti. Datu avots, ar kuru validēt.
- Kolonna – Obligāti. Validējamā kolonna.
- Value — Obligāti. Atlasītās validējamās kolonnas vērtība.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – Obligāti. Datu avots, ar kuru validēt.
- OriginalRecord — Obligāti. Ieraksts, kuram tiek validēti atjauninājumi.
- Updates — Obligāti. 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( Scores, Īpatsvars, 10 ) | Pārbauda, vai 10 ir derīga vērtība kolonnai Īpatsvars datu avotā Scores. | tukšs |
| Validēt( Scores, Īpatsvars, 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šs |
| 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." |