Adres
Gebruik de adrescomponent om de adresgegevens van de gebruiker te vragen. Deze component is gelinkt met het CRAB (Centraal Referentieadressenbestand) van Vlaanderen.
De CRAB-producten en diensten zullen vanaf eind 2023 niet langer aangeboden worden. De authentieke adresgegevens van Vlaanderen zijn beschikbaar met de diensten van het Adressenregister.
Bevat de volgende velden
Postcode
Gemeente
Straat
Huisnummer
Bus
Per adres wordt voor elk element (postcode, gemeente, …) een aparte component toegevoegd. Al deze elementen zijn grotendeels voorgeconfigureerd.
Per adrescomponent kunt u zelf bijv. Naam en Titel aanpassen. Per element kunt u zelf bijv. ook Naam en Titel aanpassen. U kunt bovendien meegeven welk veld verplicht is.
De titels en tijdelijke teksten zijn voorgedefinieerd. De configuratie is meestal minimaal.
De lijsten zijn dynamisch: wanneer de gebruiker start met typen, verschijnen er suggesties die de lijst beperken.
De lijst met postcodes bevat alle postcodes. De postcode stelt de gemeente(n) voor.
De lijst met gemeente(n) bevat alle gemeenten. De gemeente stelt de postcode(s) voor.
De lijst met straten wordt automatisch beperkt tot de straten in de gemeente. De naam van de straat beginnen te typen zorgt ervoor dat de lijst met straten verder beperkt wordt.
De lijst met huisnummers wordt automatisch beperkt tot de huisnummers in de straat.
De lijst met busnummers wordt automatisch beperkt tot de busnummers van het huisnummer.
Afbeelding
Belgisch IBAN-nummer
Gebruik de Belgisch IBAN-nummercomponent om een IBAN-nummer op te vragen. Deze component is gelijkaardig aan de Tekstveld-component, maar voegt validatie van het IBAN-nummer toe. Bij deze component wordt automatisch een help-icoon voorzien met helptekst over het IBAN-formaat.
Alleen banknummers die aan het Belgische IBAN-formaat voldoen, zijn toegelaten.
U kunt de volgende Eigenschappen aanpassen:
Naam
Titel
Tijdelijke Tekst
Verplicht Veld
De Helptekst: pas hiervoor de Lange beschrijving aan.
Wanneer een gebruiker het IBAN-nummer verkeerd ingeeft (fout formaat of fout in het controlegetal) verschijnt de volgende foutboodschap:
Betaling
Captcha
Datum
Gebruik deze component als alternatief voor de Datumkiezer. Het verschil is dat u de datum in 3 aparte velden (dag, maand, jaar) laat ingeven.
U kunt de volgende Eigenschappen aanpassen:
Naam
Titel; bijv. “Geef hier de datum van de opleiding in”
Verplicht veld
U kunt de titels boven elk veld (Dag, Maand, Jaar) ook weglaten. De tijdelijke tekst toont immers wat er per veld verwacht wordt: DD, MM, JJJJ.
Soms is het interessant om de datum standaard in te stellen op de huidige datum. Selecteer daarvoor in het Eigenschappen-paneel de Standaardwaarde: Zet huidige datum als standaardwaarde.
Datumkiezer
Gebruik de Datumkiezer om een datum te laten kiezen in een kalender pop-up. U kunt ook gewoon de datum laten ingeven in een datumveld.
U kunt de volgende Eigenschappen aanpassen:
Naam
Titel
Verplicht veld
Soms is het interessant om de datum standaard in te stellen op de huidige datum. Selecteer daarvoor in het Eigenschappen-paneel de Standaardwaarde: Zet huidige datum als standaardwaarde.
Via de optie Standaardwaarde kunt u ook om het even welke andere datum als default kiezen.
E-mailadres
Gebruik de e-mailadrescomponent om een e-mailadres op te vragen. Deze component is gelijkaardig aan de Tekstveld-component maar voegt een validatie op het e-mailadres toe.
U kunt de volgende Eigenschappen aanpassen:
Naam
Titel
Tijdelijke tekst - zoals die wordt getoond in het formulier
Verplicht veld
Wanneer een gebruiker het e-mailadres verkeerd ingeeft (fout formaat) verschijnt de volgende foutboodschap:
Extra Tussenruimte
Gebruik deze component om de leesbaarheid van een formulier beter te maken door extra ruimte te creëren tussen de componenten. Hiervoor kunt u deze component combineren met de Scheidingslijn-component.
U kunt zelf de grootte van de tussenruimte instellen (in pixels). De standaardwaarde is 8.
In het onderstaande voorbeeld werd de Extra Tussenruimte gebruikt bij de vraag om de algemene voorwaarden te bevestigen. De grootte van de tussenruimte staat op 24 pixels.
Filter Tekst
Gebruikers Login Info en Metadata
Gebruik deze technische componenten om:
extra informatie toe te voegen aan de verzendinformatie
in uw formulier toegang te krijgen tot informatie over een ingelogde gebruiker (zie “Secured Formulieren en Login”)
Gebruikers Login Info
Gebruik deze component om de toegang tot uw formulier alleen mogelijk te maken na login (zie “Secured Formulieren en Login”).
U kunt de informatie over de ingelogde gebruiker via regels (rules) gebruiken om:
velden uit het formulier vooringevuld aan te bieden
bepaalde logica in het formulier te baseren op de beschikbare gebruikersinformatie
Binnen de de ACM/IDM-context is de volgende informatie beschikbaar over de ingelogde gebruiker:
Organisatiecode (vo_orgcode) | OVO-code of ondernemingsnummer van de ingelogde gebruiker, bijv. OVO003323 |
Organisatienaam (vo_orgnaam) | Bijv. Departement Omgeving |
Voornaam (given_name) | Voornaam |
Naam (family_name) | Familienaam |
E-mail (vo_email) | E-mailadres |
Rijksregisternummer (rrn) | Getal van 11 cijfers |
Doelgroepcode (VO_DOELGROEPCODE) | Bijv. LB voor locale besturen, BUR voor burgers, … |
Wettelijk Vertegenwoordiger (wv_orgcode) | De organisatie waarvoor deze persoon wettelijk vertegenwoordiger is - van toepassing bij inloggen “in naam van” een onderneming |
Rol of rollen (dv_formulieren_rol_3d) | Kan evt. gebruikt worden om toegang te beperken tot bepaalde rollen binnen een departement |
In het voorbeeld van een formulier voor burgers die een klacht willen neerleggen, kunt u van de burger die inlogt onmiddellijk het rijksregisternummer, voornaam en naam voorinvullen. U kunt bovendien deze info niet aanpasbaar maken en meesturen wanneer het formulier wordt ingediend.
U kunt de volgende Eigenschappen aanpassen:
Naam
Titel
Verplicht veld
Selecteer Schakel Object uit om ervoor te zorgen dat bijv. de naam van de gebruiker niet kan aangepast worden.
Selecteer Verberg Object om bepaalde velden niet niet te tonen aan de gebruiker
Om aan te geven dat de familienaam van de ingelogde gebruiker verplicht moet ingevuld worden, ga naar Eigenschappen > Gebruiker informatie > Gebruiker header en vul OIDC_CLAIM_family_name in.
Zo kunt u ook andere Gebruiker Login Info-velden verplicht maken. Vul in de Gebruiker Header OIDC_CLAIM_ gevolgd door vo_orgcode, vo_orgnaam, vo_family_name, vo_given_name, vo_email, rrn, VO_DOELGROEP_CODE, wv_orgcode, dv_formulieren_rol_3d.
De informatie uit het Gebruiker Info Veld kunt u ook kopiëren naar een andere component met regels (rules). Bijv. om voornaam en naam samen in één veld te tonen, of om het rijksregisternummer te tonen in een veld die de formattering correct toont.
Metadata
Ook bij deze component wordt de informatie uit de gebruikerssessie opgenomen in de informatie die verzonden wordt.
Het voornaamste verschil is dat de Metadata informatie niet in het formulier zichtbaar is en pas tijdens het eigenlijke verzenden (op de server) toegevoegd wordt. Dit is – om misbruik uit te sluiten - soms belangrijk om zo te vermijden dat de informatie binnen het formulier kan aangepast worden.
Om metadata toe te voegen:
Voeg een Metadata component toe zoals beschreven in “Hoe voeg ik een component toe”.
Gebruik het Steeksleutel symbool om de nieuwe component verder te configureren.
Zoals bij de andere componenten pas je in het Eigenschappen paneel naam en titel aan.
Iets lager kan het Metadata type gekozen worden.
Verder staat “Verberg Object” bij deze component standaard aangevinkt (wat ook meestal de bedoeling is.
De lijst van metadata die kan meegestuurd worden, bestaat uit:
· Gebruiker metadata: (alleen zinvol bij ingelogde gebruiker (via secured formulier)
o Rijksregisternummer
o Voornaam
o Naam
· Sessie metadata
o TransactionID (unieke ID die aan de inzending gekoppeld is)
o Datum en tijdstip van inzending
· Betaling metadata (zie “Betalingen koppelen aan formulier”)
o PspPaymentID (unieke ID van de betaling)
o Betaallink
o Gestructureerde mededeling
Per metadata veld dat men wil meesturen moet een aparte Metadata component op het formulier gesleept worden.
Infotegel
Gebruik deze component om informatie in een formulier extra in de verf te zetten. Een infotegel bestaat uit vaste tekst in een kadertje met titel en tekst. U kunt ook een icoon toevoegen.
U kunt de volgende Eigenschappen aanpassen:
Titel voor het kadertje
Subtitel (indien relevant)
Icoon (geen, alert, vraagteken, info, …)
Tekst
