Funktionen Validate
Gælder for:
Lærredapps Modelbaserede apps
Funktionen Validate kontrollerer, om værdien af en enkelt kolonne eller en komplet post er gyldig for en datakilde.
Beskrivelse
Før en bruger indsender en dataændring, kan du give øjeblikkelig feedback på gyldigheden af indsendelsen, hvilket giver en bedre brugeroplevelse.
Datakilder kan give oplysninger om, hvad der udgør gyldige værdier i en post. Disse oplysninger kan omfatte mange begrænsninger som f.eks. disse eksempler:
- om en kolonne kræver en værdi
- hvor lang en tekststreng kan være
- hvor højt og lavt et tal kan være
- hvor tidligt og sent en dato kan være
Funktionen Validate bruger disse oplysninger til at afgøre, om en værdi er gyldig og til at returnere en fejlmeddelelse hvis ikke. Du kan bruge funktionen DataSourceInfo til at få vist de samme oplysninger, som Validate bruger.
Datakilder kan variere mht., hvor mange valideringsoplysninger de giver, herunder slet ikke at give nogen. Valider kan kun bekræfte værdier baseret på disse oplysninger. Selv hvis Validate ikke finder et problem, kan anvendelse af dataændringen stadig mislykkes. Du kan bruge funktionen Errors til at få oplysninger om fejlen.
Hvis Validate finder et problem, returnerer funktionen en fejlmeddelelse, som du kan vise til brugeren af appen. Hvis alle værdier er gyldige, returnerer Validate blank. Når du arbejder med en samling, der ikke indeholder nogen valideringsoplysninger, er værdier altid gyldige.
Syntaks
Valider( Datakilde; Kolonne; Værdi )
- DataSource – Påkrævet. Datakilden, der skal valideres med.
- Kolonne – Påkrævet. Kolonnen, der skal valideres.
- Værdi – Påkrævet. Værdien for den markerede kolonne, der skal valideres.
Valider( Datakilde; OriginalRecord; Opdateringer )
- DataSource – Påkrævet. Datakilden, der skal valideres med.
- OriginalRecord - Påkrævet. Posten, som opdateringer skal valideres imod.
- Opdateringer - Påkrævet. Ændringerne, der anvendes for den oprindelige post.
Eksempler
For disse eksempler skal værdier i kolonnen Percentage i datakilden Scores være mellem 0 og 100. Hvis dataene består valideringen, returnerer funktionen tom. Ellers returnerer funktionen en fejlmeddelelse.
Valider med en enkelt kolonne
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Validere ( Scorer, Procent, 10 ) | Kontrollerer, om 10 er en gyldig værdi for kolonnen Percentage i datakilden Scores. | hvid |
| Validere ( Scorer, Procent, 120 ) | Kontrollerer, om 120 er en gyldig værdi for kolonnen Percentage i datakilden Scores. | "Værdier skal være mellem 0 og 100." |
Valider med en komplet post
| Formel | Beskrivelse | Resultat |
|---|---|---|
| Valider( Scores, EditRecord, Gallery.Updates ) | Kontrollerer, om værdierne i alle kolonner er gyldige for datakilden Scores. I dette eksempel er værdien i kolonnen Percentage 10. | hvid |
| Valider( Scores, EditRecord, Gallery.Updates ) | Kontrollerer, om værdierne i alle kolonner er gyldige for datakilden Scores. I dette eksempel er værdien i kolonnen Percentage 120. | "Værdier skal være mellem 0 og 100." |