De functie Validate

Van toepassing op: Canvas-apps Modelgestuurde apps

De functie Validate controleert of de waarde van één kolom of een volledige record geldig is voor een gegevensbron.

Beschrijving

Voordat een gebruiker een gegevenswijziging doorvoert, kunt u direct feedback geven over de geldigheid van die bijdrage, wat resulteert in een betere gebruikerservaring.

Gegevensbronnen kunnen informatie bieden over wat geldige waarden binnen een record zijn. Deze informatie kan bestaan uit diverse beperkingen, zoals deze voorbeelden:

• of een kolom een waarde vereist
• hoe lang een tekenreeks mag zijn
• hoe hoog en hoe laag een getal mag zijn
• hoe vroeg en hoe laat een datum mag zijn

De functie Validate gebruikt deze informatie om te bepalen of een waarde geldig is en moet een geschikt foutbericht retourneren als dat niet het geval is. U kunt de functie DataSourceInfo gebruiken om dezelfde informatie weer te geven die Validate gebruikt.

Gegevensbronnen variëren in de hoeveelheid validatie-informatie die ze leveren en soms leveren ze deze informatie helemaal niet. Validate kan alleen waarden verifiëren op basis van deze informatie. Zelfs als Validate geen probleem vindt, kan het toepassen van de gegevenswijziging mislukken. U kunt de functie Errors gebruiken om informatie over de fout te verkrijgen.

Als Validate een probleem vindt, retourneert de functie een foutbericht dat u kunt weergeven aan de gebruiker van de app. Als alle waarden geldig zijn, retourneert Validate een lege waarde. Wanneer u werkt met een verzameling die geen validatie-informatie bevat, zijn waarden altijd geldig.

Syntaxis

Valideren( Gegevensbron, Kolom, Waarde )

• DataSource – Verplicht. De gegevensbron waarmee moet worden gevalideerd.
• Kolom – Verplicht. De kolom die moet worden gevalideerd.
• Waarde – Verplicht. De waarde die voor de geselecteerde kolom moet worden gevalideerd.

Valideren( Gegevensbron, OorspronkelijkeRecord, Updates )

• DataSource – Verplicht. De gegevensbron waarmee moet worden gevalideerd.
• OriginalRecord - Vereist. De record waarvan updates moeten worden gevalideerd.
• Updates - Vereist. De wijzigingen die worden toegepast op de oorspronkelijke record.

Voorbeelden

Voor deze voorbeelden moeten de waarden in de kolom Percentage van de gegevensbron Scores getallen tussen 0 en 100 inclusief zijn. De functie retourneert leeg als de validatie van de gegevens slaagt. Anders retourneert de functie een foutbericht.

Valideren met één kolom

Formule	Beschrijving	Resultaat
Valideren (scores, percentage, 10)	Controleert of 10 een geldige waarde is voor de kolom Percentage in de gegevensbron Scores.	leeg
Valideren (scores, percentage, 120)	Controleert of 120 een geldige waarde is voor de kolom Percentage in de gegevensbron Scores.	"Waarden moeten tussen 0 en 100 liggen."

Valideren met een volledige record

Formule	Beschrijving	Resultaat
Valideren (Scores, BewerkenRecord, Galerij.Updates)	Hiermee wordt gecontroleerd of de waarden in alle kolommen geldig zijn voor de gegevensbron Scores. In dit voorbeeld heeft de kolom Percentage de waarde 10.	leeg
Valideren (Scores, BewerkenRecord, Galerij.Updates)	Hiermee wordt gecontroleerd of de waarden in alle kolommen geldig zijn voor de gegevensbron Scores. In dit voorbeeld heeft de kolom Percentage de waarde 120.	"Waarden moeten tussen 0 en 100 liggen."