Validate-funksjon
Gjelder:
Lerretsapper Modelldrevne apper
Funksjonen Validate kontrollerer hvorvidt verdien av en enkelt kolonne eller en fullstendig post er gyldig for en datakilde.
Beskrivelse
Før en bruker sender inn en dataendring kan du gi umiddelbar tilbakemelding på gyldigheten av denne innsendingen, noe som resulterer i en bedre brukeropplevelse.
Datakilder kan gi informasjon om hva som regnes som gyldige verdier i en post. Denne informasjonen kan inneholde mange begrensninger, som for eksempel:
- hvorvidt en kolonne krever en verdi
- hvor lang en tekststreng kan være
- hvor høye og lave tallene kan være
- hvor tidlig og sen en dato kan være
Funksjonen Validate bruker denne informasjonen til å finne ut om en verdi er gyldig, og til å returnere en korrekt feilmelding hvis det ikke er tilfelle. Du kan bruke funksjonen DataSourceInfo til å vise den samme informasjonen som Validate bruker.
Det varierer hvor mye valideringsinformasjon datakildene gir, og det kan forekomme at de ikke gir noe slik informasjon. Validate kan kun kontrollere verdier basert på denne informasjonen. Selv om Validate ikke finner et problem, kan bruk av dataendringene fortsatt mislykkes. Du kan bruke funksjonen Errors til å hente informasjon om feilen.
Hvis Validate finner et problem, vil funksjonen returnere en feilmelding som du kan vise til brukeren av appen. Hvis alle verdiene er gyldige, vil Validate returnere blank. Når du arbeider med en samling som ikke har noen valideringsinformasjon, vil verdiene alltid være gyldige.
Syntaks
Validate( DataSource, Column, Value )
- DataSource – obligatorisk. Datakilden det skal valideres med.
- Column – obligatorisk. Kolonnen som skal valideres.
- Value - obligatorisk. Verdien for den valgte kolonnen som skal valideres.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – obligatorisk. Datakilden det skal valideres med.
- OriginalRecord – obligatorisk. Posten som inneholder oppdateringer som skal valideres.
- Updates – obligatorisk. Endringene som skal brukes på den opprinnelige posten.
Eksempler
I disse eksemplene må verdiene i Prosent-kolonnen i datakilden for Resultater være mellom 0 og 100. Hvis dataene består valideringen, returnerer funksjonen tom. Hvis ikke returnerer funksjonen en feilmelding.
Validere med en enkeltkolonne
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | Kontrollerer om 10 er en gyldig verdi for Prosent-kolonnen i datakilden for Resultater. | tom |
| Validate( Scores, Percentage, 120 ) | Kontrollerer om 120 er en gyldig verdi for Prosent-kolonnen i datakilden for Resultater. | "Verdiene må være mellom 0 og 100." |
Validere med en fullstendig post
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Kontrollerer om verdier i alle kolonner er gyldige for datakilden Poengsummer. I dette eksemplet er verdien i Prosent-kolonnen 10. | tom |
| Validate( Scores, EditRecord, Gallery.Updates ) | Kontrollerer om verdier i alle kolonner er gyldige for datakilden Poengsummer. I dette eksemplet er verdien i Prosent-kolonnen 120. | "Verdiene må være mellom 0 og 100." |