Formulierveld validatie
Concept
Validatie op formulierveld met foutmelding
Validatie verhindert dat gebruikers ongeldige informatie invoeren in een formulierveld. Een foutmelding verschijnt in het rood.
Kan formulier niet indienen
Validatieregels zorgen er ook voor dat gebruikers het formulier niet kunnen indienen als de ingevulde waardes niet aan specifieke voorwaarden voldoen. Als de gebruiker het formulier toch tracht in te dienen, verschijnt er bovenaan het formulier een foutmelding.
Opgelet: een servicetaak kan wel een foutieve waarde in het formulier plaatsen. Een versie van het formulier wordt dan effectief opgeslagen. Wanneer je die via de dossierpagina in de backoffice opent, staat de waarde rood gemarkeerd (invalid). Wordt het formulier later in de flow binnen de context van een gebruikerstaak geopend, dan kan de gebruiker het formulier niet indienen zonder eerst de foutieve waarde te corrigeren.
Validatie per sectie in formulier
Bij de formuliereigenschappen kan je ook validatie per sectie instellen. Het is dan voor de gebruiker niet mogelijk om verder te gaan naar een volgende sectie, indien niet voldaan is aan alle validatieregels binnen de huidige sectie. Deze functionaliteit is vooral handig binnen formulieren met een groot aantal secties.
Om dit te activeren, voeg je op formulierniveau (hoogste niveau binnen je JSON-definitie) volgende eigenschap toe. "sectionBasedValidation": true
Validatie op formulierveld met waarschuwing
Het is tot slot mogelijk om een validatieregel te koppelen aan een waarschuwing. Deze verschijnt in het oranje. In dat geval kan de gebruiker het formulier nog steeds indienen of kan hij nog steeds doorgaan naar de volgende sectie.
Wanneer foutboodschap of waarschuwing?
Use case foutboodschap: je wil een premie aanvragen voor een uitgevoerd werk en je geeft een factuurdatum in de toekomst in.
Use cases waarschuwing:
Een niet voor de hand liggende (maar in uiterste gevallen mogelijke) waarde. Bijvoorbeeld iemand vult het veld “leeftijd” in met 120.
Een interne policy die zegt dat een afwijzing of weigering nooit automatisch mag gebeuren, maar altijd via een dossierbeheerder moet passeren. In zo’n gevallen wil je de aanvrager waarschuwen ('Dit zal nooit aanvaard worden!'), maar niet blokkeren.
Voorbeelden
Voorbeeld 1: veld verplicht in te vullen
Velden aangeduid met een rode asterisk zijn verplicht in te vullen door de gebruiker. Dit kan je instellen via de ‘Alleen lezen’ instelling in het formulier element: zie algemene eigenschappen formulier elementen > Alleen lezen.
Als de gebruiker het formulier probeert in te dienen zonder het veld in te vullen, verschijnt de foutmelding bovenaan het formulier en kleurt het veld rood met de mededeling ‘Verplicht veld.'
Voorbeeld 2: getal in specifieke range
Voor dit veld is een validatieregel ingesteld die afdwingt dat de ingevoerde waarde tusen de 10 en 20 moet liggen. Dit kan je opzetten via de ‘Condities’ instelling in het formulier element: zie algemene eigenschappen formulier elementen > Condities.
Van zodra de gebruiker een waarde invult die niet matcht met de validatieregel, kleurt het veld rood met de gedefinieerde foutmelding.
Voorbeeld 3: maximum aantal karakters in tekstveld
Voor dit tekstveld is een validatieregel ingesteld die afdwingt dat de ingevoerde tekst maximaal 100 karakters mag bevatten. Dit kan je opzetten via de ‘Condities’ instelling in het formulier element: zie algemene eigenschappen formuliervelden > Condities.
