Validate functie

Van toepassing op: Modelgestuurde apps voor canvas-apps

De Validate functie 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 Validate functie gebruikt deze informatie om te bepalen of een waarde geldig is en om een geschikt foutbericht te retourneren als dat niet het geval is. U kunt de functie DataSourceInfo gebruiken om dezelfde informatie weer te geven die Validate wordt 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 er geen probleem wordt gevonden, kan het toepassen van de gegevenswijziging nog steeds mislukken. U kunt de functie Errors gebruiken om informatie over de fout te verkrijgen.

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

Syntaxis

Validate( DataSource, Kolom, Waarde )

• DataSource - Vereist. 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.

Validate( DataSource, OriginalRecord, Updates )

• DataSource - Vereist. De gegevensbron waarmee moet worden gevalideerd.
• OrigineelRecord - 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.

Validate met één kolom

Formule	Beschrijving	Resultaat
Validate( Scores, Percentage, 10 )	Controleert of 10 een geldige waarde is voor de kolom Percentage in de gegevensbron Scores.	leeg
Validate( 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."

Validate met een volledige record

Formule	Beschrijving	Resultaat
Validate( Scores, EditRecord, Gallery.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
Validate( Scores, EditRecord, Gallery.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."