Potrdi funkcijo
Velja za:
Aplikacije Canvas Aplikacije, ki temeljijo na modelu
Funkcija Validate preveri, ali je vrednost enega stolpca ali celotnega zapisa veljavna za vir podatkov.
Opis
Preden uporabnik pošlje spremembo podatkov, lahko posredujete takojšnje povratne informacije o veljavnosti te oddaje za boljšo uporabniško izkušnjo.
Viri podatkov lahko zagotovijo informacije o opredelitvi veljavnih vrednosti v zapisu. Te informacije lahko vključujejo številne omejitve, na primer:
- ali stolpec zahteva vrednost
- kako dolg je lahko niz besedila
- kako visoka in nizka je lahko številka
- kako zgoden in pozen je lahko datum
Funkcija Validate uporabi te informacije, da ugotovi, ali je vrednost veljavna in ali mora vrniti ustrezno sporočilo o napaki, če ni. Funkcijo DataSourceInfo lahko uporabite za prikaz istih informacij, kot jih uporablja funkcija Validate.
Viri podatkov se razlikujejo v tem, koliko informacij za preverjanje zagotavljajo, vključno s tem, da jih sploh ne zagotavljajo. Funkcija Validate lahko na podlagi teh podatkov samo preveri vrednosti. Tudi če funkcija Validate ne najde težave, sprememba podatkov morda ne bo uspela. Za pridobivanje informacij o napaki lahko uporabite funkcijo Errors.
Če funkcija Validate najde težavo, funkcija vrne sporočilo o napaki, ki ga lahko pokažete uporabniku aplikacije. Če so vse vrednosti veljavne, funkcija Validate vrne vrednost blank. Če uporabljate zbirko brez informacij o preverjanju veljavnosti, so vrednosti vedno veljavne.
Sintaksa
Validate( DataSource, Column, Value )
- DataSource – obvezno. Vir podatkov za preverjanje veljavnosti.
- Column – obvezno. Stolpec, za katerega bo preverjena veljavnost.
- Value – obvezno. Vrednost za izbrani stolpec, za katerega bo preverjena veljavnost.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – obvezno. Vir podatkov za preverjanje veljavnosti.
- OriginalRecord – obvezno. Zapis, katerega je treba preveriti posodobitve.
- Updates – obvezno. Spremembe, ki bodo uporabljene v izvirnem zapisu.
Primeri
V teh primerih morajo biti vrednosti v stolpcu Odstotek v viru podatkov Rezultati med 0 in vključno 100. Če podatki prestanejo preverjane veljavnosti, funkcija vrne prazno vrednost. V nasprotnem primeru funkcija vrne sporočilo o napaki.
Preverjanje veljavnosti z enim stolpcem
| Formula | Opis | Rezultat |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | Preveri, ali je 10 veljavna vrednost za stolpec Odstotek v viru podatkov Rezultati. | prazno |
| Validate( Scores, Percentage, 120 ) | Preveri, ali je 120 veljavna vrednost za stolpec Odstotek v viru podatkov Rezultati. | "Vrednosti morajo biti med 0 in 100." |
Preverjanje veljavnosti s celotnim zapisom
| Formula | Opis | Rezultat |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Preveri, ali so vrednosti v vseh stolpcih veljavne za vir podatkov Rezultati. V tem primeru je vrednost v stolpcu Odstotek10. | prazno |
| Validate( Scores, EditRecord, Gallery.Updates ) | Preveri, ali so vrednosti v vseh stolpcih veljavne za vir podatkov Rezultati. V tem primeru je vrednost v stolpcu Odstotek120. | "Vrednosti morajo biti med 0 in 100." |