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. Validate lahko preveri samo vrednosti na podlagi teh informacij. 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
Preveri( Vir podatkov, Stolpec, Vrednost )
- Vir podatkov – Zahtevano. Vir podatkov za preverjanje veljavnosti.
- Stolpec – obvezno. Stolpec, za katerega bo preverjena veljavnost.
- Vrednost – obvezno. Vrednost za izbrani stolpec, za katerega bo preverjena veljavnost.
Preveri( Vir podatkov, Izvirni zapis, Posodobitve )
- Vir podatkov – Zahtevano. Vir podatkov za preverjanje veljavnosti.
- Izvirni zapis - Zahtevano. Zapis, katerega je treba preveriti posodobitve.
- Posodobitve - obvezne. 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 |
---|---|---|
Potrdi (rezultati, odstotek, 10) | Preveri, ali je 10 veljavna vrednost za stolpec Odstotek v viru podatkov Rezultati. | prazno |
Preveri (rezultati, odstotek, 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 |
---|---|---|
Preveri (rezultati, uredi zapis, galerija.posodobitve) | Preveri, ali so vrednosti v vseh stolpcih veljavne za vir podatkov Rezultati. V tem primeru je vrednost v stolpcu Odstotek 10. | prazno |
Preveri (rezultati, uredi zapis, galerija.posodobitve) | Preveri, ali so vrednosti v vseh stolpcih veljavne za vir podatkov Rezultati. V tem primeru je vrednost v stolpcu Odstotek 120. | "Vrednosti morajo biti med 0 in 100." |