Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

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

Optioneel:

  • Het is mogelijk de lijst van postcodes te beperken tot een gewenste lijst.

  • Dit kan door een rule als: limitPostcodesString(postcode ,"3600,3500,3000");

    • “postcode” is de naam van het postcode veld op uw formulier

    • 3600, 3500, 3000 zijn de gewenste postcodes.

    • Deze rule moet worden toegevoegd op het Root Panel, bij event “Initialise” - zie voor meer details het hoofdstuk over het toevoegen van rules aan een formulier

...

Afbeelding

Ellen Vanherstraeten

...

Info

Via de optie Standaardwaarde kunt u ook om het even welke andere datum als default kiezen.

U kan ook zorgen dat feestdagen niet gekozen kunnen worden in de datumkiezer:

Vink daarvoor de gewenste opties aan:

...

Er zijn nog heel wat meer mogelijkheden om het gedrag van de datumkiezer te bepalen door middel van regels, zie daarvoor: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6377835964/Met+regels+werken#Regels-die-je-kan-instellen-op-de-Datumkiezer

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.

...

  • 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 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:

...

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.

...

  • Naam

  • Titel

  • Verberg Object staat hier standaard aangevinkt om bepaalde velden niet te tonen aan de gebruiker

De lijst met Dit zijn de beschikbare metadata:

  • Gebruikersmetadata (alleen zinvol bij ingelogde gebruikers via een beveiligd formulier)

    • Rijksregisternummer

    • Voornaam

    • Naam

  • Metadata over de sessie

    • TransactionID (uniek ID gekoppeld aan de inzending)

    • Datum en tijdstip van inzending

  • Metadata over de betaling (zie “Betalingen koppelen aan formulier”)

    • PspPaymentID (unieke ID gekoppeld aan de betaling)

    • Betaallink

    • Gestructureerde mededeling

Helptekst

Gebruik de Helptekst-component om de gebruiker extra informatie te geven over hoe de gevraagde informatie in te vullen. De Helptekst kan een korte of lange omschrijving meegeven:

  • De korte omschrijving wordt direct getoond onder de titel van de component

    Image Added
  • De lange omschrijving is de tekst in de tooltip achter het i-icoon (informatie)

    Image Added
Info

Als er een lange omschrijving beschikbaar is, dan wordt de korte omschrijving niet getoond.

...

Vul onder Eigenschappen de korte of de lange beschrijving aan:

  • Image Added

Naast de Helptekst zijn er ook nog andere manieren om de gebruiker te ondersteunen bij het invullen van een formulier met:

  • een tijdelijke tekst die verschijnt vóór het invullen van een veld

  • een relevante tijdelijke tekst bij een keuzelijst, bijv. “Kies een activiteit”

  • een specifieke melding over waarom een veld verplicht is, bijv. “Vul de schoenmaat; wij zorgen dat veiligheidsschoenen in jouw maat klaarstaan”.

  • een heldere titel bij het veld

  • één of meerdere infotegels voor complexe velden of formulier(secties)

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.

...

Om te Notificatie-component te gebruiken, moet u voor uw formulier eerst een Notificatie-afhandeling maken.

Zie ook Een notificatie (o.a. ontvangstbevestiging) sturen

...

U kunt de volgende Eigenschappen aanpassen:

  • Titel: de tekst die in het vet staat

  • Boodschap: de tekst die naast de checkbox staat

  • Tijdelijke (placeholder) tekst: de tekst die als suggestie in het e-mailadres-veld staat

Ellen Vanherstraeten (TODO: uitleg secured formulieren)

Nummerveld

Gebruik deze component om alleen getallen te laten invoeren (geen letters).

...

Deze component is gelijkaardig aan de Tekstveld-component, maar voegt validatie van het ondernemingsnummer toe. Er wordt gecontroleerd op de lengte (9 cijfers) en het controlegetal (de laatste 3 cijfers) van het ondernemingsnummer.

Image ModifiedImage Modified

...

U kunt de volgende Eigenschappen aanpassen:

...

Deze component is gelijkaardig aan de Tekstveld-component, maar voegt validatie van het rijksregister toe. Er wordt gecontroleerd op de lengte (11 cijfers) en het controlegetal (de laatste 2 cijfers) van het ondernemingsnummer.

Image Modified

Image Modified

...

U kunt de volgende Eigenschappen aanpassen:

...

Het eindresultaat is dan als volgt:

...

De :

...

Hoe de handtekening wordt meegestuurd hangt af van de aflevermethode:

  • naar een rest endpoint: de afbeelding van de handtekening wordt base64 encoded meegestuurd in de json

  • via email: de afbeelding van de handtekening wordt als

...

  • attachment meegestuurd

  • datahub: de afbeelding van de handtekening is zichtbaar in datahub

Tabel

Gebruik de Tabel-component om informatie op te vragen in tabelvorm.

...

U kunt de volgende labels aanpassen bij de Headers en de Tekst in de rijen:

...

U kunt via het Eigenschappen-paneel de namen van alle tabel-items aanpassen:

...

Het Voornaam-veld ziet er als volgt uit:

...

Telefoonnummer

Tijdelijk Opslaan

Voorwaarden

...

Telefoonnummer

Gebruik deze component om een telefoonnummer te vragen. Deze component is gelijkaardig aan de Tekstveld-component, maar voegt validatie van het telefoonnummer toe.

...

U kunt de volgende Eigenschappen aanpassen:

  • Naam

  • Titel

  • Tijdelijke tekst

  • Verplicht veld

...

Bij een fout in het formaat van het telefoonnummer, wordt een foutboodschap getoond.

...

Tijdelijk Opslaan

Er zijn 3 componenten die te maken hebben met het tijdelijk opslaan van gegevens:

  • De knop om de gebruiker zijn wijzigingen/gegevens te laten opslaan

  • Een bericht om aan de gebruiker te tonen dat zijn gegevens correct zijn bewaard

...

Bij gebruik in het formulier zien die er als volgt uit:

...

Voorts is er een lijst met tijdelijke versies die een gebruiker heeft bewaard:

...

Hoe deze componenten juist gebruikt moeten worden om “Tijdelijk opslaan” goed te laten werken voor een formulier leest u hier: De data in een formulier tijdelijk opslaan

Voorwaarden

Gebruik deze component om bijv. algemene voorwaarden of privacybeleid te aanvaarden. Deze component bevat een checkbox en een extra tekstveld om de voorwaarden te omschrijven of naar externe pagina’s door te verwijzen.

Een voorbeeld:

...

U kunt de volgende Eigenschappen aanpassen:

  • Naam

  • Titel

  • Verplicht veld

  • Consent-tekst, bijv. “Ik ga akkoord met de Algemene Voorwaarden”

  • Beschrijving van wat er goedgekeurd wordt

...

Om een link naar een website te leggen, klik op het Maximaliseren-symbool.

...

Selecteer de tekst waarop de link moet gelegd worden, vul de URL in en geef aan dat die link moet openen in een New Tab. Hieronder ziet u het resultaat van deze configuratie:

...

Info

Wanneer de gebruiker van het formulier is ingelogd, kunt u ook de Voorwaarden-component gebruiken om te laten bevestigen dat de ingevulde informatie volledig en correct is.

Een voorbeeld:

...

Waarschuwing

Gebruik deze component om een foutmelding extra in de verf te zetten. Deze component bestaat uit een titel en een tekst. Afhankelijk van het type fout kiest u een andere achtergrondkleur.

...

U kunt de volgende Eigenschappen aanpassen:

  • Naam

  • Hoofdtekst

  • Achtergrondkleur

...

Dit is het resultaat:

...

Info

De Waarschuwing-component wordt vaak op Verborgen gezet en pas zichtbaar gemaakt onder bepaalde voorwaarden. In het voorbeeld hierboven wordt de Waaschuwing pas getoond wanneer de gebruiker probeert te Verzenden zonder eerst een bijlage toe te voegen.