====== uitleg per besturingselement ======

Een nieuw besturingselement geef je een label (naam) en kiest het type veld. Per veld kun je na toevoegen diverse instellingen meegeven. Er volgt hieronder per besturingselement een screenshot van de beschikbare instellingen met uitleg (de achterkant) en een voorbeeld hoe het er voor de bezoeker uit ziet (de voorkant). Voor ieder element geldt dat er een 'Label'en 'Form Key' moet worden opgegeven. Het 'Label' is wat de bezoeker onder het formulier-element ziet. De 'Form Key' is een systeemnaam, moet uniek zijn en is niet zichtbaar voor de bezoeker.

===== Afspraak =====

De achterkant:

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_32_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_33_.png|}}

===== Afspraak datum/tijd & afspraak e-mail =====

Deze velden worden specifiek gebruikt voor een afspraken- en annuleringsformulier. Deze formulieren worden bij oplevering van de website meegeleverd en zijn dus niet van belang voor een supereditor.

===== Bestand =====

de achterkant:

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Maximale uploadgrootte: hier kun je aangeven hoe groot het bestand maximaal mag zijn wat geupload wordt.

  * Toegestane bestandsextensies: geef hier per type bestand aan welke extensies toegestaan zijn.

{{:dvg7:functionaliteit:webformulieren:image_34_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_35_.png|}}

===== BSN =====

de achterkant:

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_36_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_37_.png|}}

===== Datum =====

de achterkant:

  * Standaardwaarde: voor een waarde in die alvast wordt ingevuld voor de bezoeker indien gewenst.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Begindatum & Einddatum: deze velden geven de grenzen van de input van de gebruiker aan. Een voorbeeld is dat er geen datum in de toekomst gekozen mag worden. Dit kan hier aangegeven worden met 'today'.

  * Weergeven: kies hier uit hoe de gebruiker de datum kan invoeren. In dit voorbeeld gebruiken we de standaard instellingen. Bij 'de voorkant' zie je hoe dit eruit ziet.

{{:dvg7:functionaliteit:webformulieren:image_38_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_39_.png|}}

===== DvG Adres =====

de achterkant:

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Postbus: vink deze aan als het een postbusadres is. Straatnaam, nummer en toevoeging zullen verdwijnen en een postbusveld zal te voorschijn komen. In dit voorbeeld gaan we uit van een adres in plaats van een postbus.

  * Adrescontrole: 

  * Plaatsnaam opties: keuze uit een tekstveld, of een voorgedefiniëerde lijst van steden (let op: adrescontrole is niet beschikbaar bij de voorgedefiniëerde lijst van steden).

  * Een voorgedefiniëerde lijst met postcodes: wanneer aangevinkt, verschijnt er een tekstveld om de postcodes die beschikbaar ter keuze worden gemaakt in te voeren.

  * Placeholders: bij het zetten van dit vinkje gebruik je een placeholder in plaats van een label. De placeholder zal getoond worden totdat een bezoeker een waarde invult in het veld.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_40_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_41_.png|}}

===== E-mailadres =====

de achterkant:

  * Ongeordende lijstStandaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Meerdere: kies hiervoor als er meerdere e-mailadressen ingevoerd mogen worden. Indien gewenst, is het te adviseren om in de 'Beschrijving' melding te maken van de juiste invoerwijze, namelijk meerdere e-mailadressen scheiden met een komma.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Plaatshouder: de plaatshouder wordt in het veld getoond totdat de gebruiker een waarde invult. Vaak gebruikt als voorbeeldwaarde, zoals "jan@example.com".

{{:dvg7:functionaliteit:webformulieren:image_42_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_43_.png|}}

===== Formulierblokkade =====

de achterkant: dit wordt gebruikt om het formulier te stoppen wanneer er niet aan bepaalde voorwaarden wordt voldaan. Een voorbeeld is een formulier dat bestemd is voor jongeren onder de 23. Vul je in dat je ouder dan 23 bent, dan moet het formulier stoppen en wordt de 'Waarde' getoond ('a'). 'b' geeft aan waar de 'Waarde' allemaal getoond moet worden.

{{:dvg7:functionaliteit:webformulieren:image_44_.png|}}

===== Getal =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.
 
  * Validatie: in deze sectie kun je aangeven of het veld verplicht is, en wat de minimum- en maximumwaarde mogen zijn. Ook kun je aangeven wat een eenheid meer of minder betekent: dat wil zeggen, bij 1 mogen alleen hele getallen ingegeven worden, bij 5 mogen alleen veelvouden van 5 ingevoerd worden.
 
  * Tekstveld of Selectielijst: maak hier een keuze of de bezoeker een waarde kan intoetsen of kiezen uit een selectielijst.
 
  * Plaatshouder: de plaatshouder wordt in het veld getoond totdat de gebruiker een waarde invult.
 
  * Prefix-tekst aan de linkerkant van het veld geplaatst: vul hier tekst in die voor het veld getoond moet worden.
 
  * Suffix-tekst aan de rechterkant van het veld geplaatst: vul hier tekst in die na het veld getoond moet worden.
 
  * Aantal decimalen: kies het aantal decimalen.
 
  * Scheidingsteken voor duizendtallen: de Nederlandse wijze is een '.' gebruiken als scheidingsteken.

{{:dvg7:functionaliteit:webformulieren:image_45_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_46_.png|}}

===== Keuzeopties =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.
 
  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Opties: zie punt d als je een reeds bestaande lijst wilt laden. Sleutel-waarde paren MOETEN gespecificeerd worden als 'veilige_sleutel|Een leesbare optie'. Het gebruik van enkel alfanumerieke tekens en onderstrepingstekens is aanbevolen bij sleutels. Eén optie per regel. Gegroepeerde opties kunnen worden gespecificeerd met <Groepsnaam>. <> kan gebruikt worden om items aan het begin van het menu toe te voegen, nadat een groep gespecificeerd is. Ook kunnen er tokens worden ingevoerd. Kijk hiervoor bij het volgende scenario. Een voorbeeld, de dagen van de week (kunnen ook als lijst worden gekozen) voer je als volgt in: 

monday|maandag
tuesday|dinsdag
wednesday|woensdag
thursday|donderdag
friday|vrijdag
saturday|zaterdag
sunday|zondag

  * Een van tevoren aangemaakte optie-lijst laden: maak een keuze uit de beschikbare lijsten.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Weergeven: bepaal hier hoe de keuzeopties worden weergegeven: selecteer wel of niet de Keuzelijst (schakel deze optie in als je wilt dat het component als een keuzelijst in plaats van keuzerondjes of selectievakjes wordt weergegeven) en/of Opties in willekeurige volgorde plaatsen (bepaalt willekeurig de volgorde van de opties als ze weergegeven worden in het formulier).

{{:dvg7:functionaliteit:webformulieren:image_47_.png|}}

de voorkant (een voorbeeld met dagen van de week):

{{:dvg7:functionaliteit:webformulieren:image_48_.png|}}

===== Opmaak =====

de achterkant: dit veld is hetzelfde als het 'Weergaveveld' en is bedoeld om informatie in het formulier op te nemen voor de inzender om tot zich te nemen. Verschil met het 'Weergaveveld' is, dat het 'Weergaveveld' mee wordt verzonden in de inzending en dat het 'Opmaak'-veld niet mee wordt verzonden. Bovendien is het 'Weergaveveld' platte tekst, in tegenstelling de het 'Opmaak'-veld. Hier is een scala aan opmaak mogelijk met de teksteditor ('a'). 'b' geeft de mogelijkheid te kiezen waar de informatie getoond moet worden.

{{:dvg7:functionaliteit:webformulieren:image_49_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_50_.png|}}

===== Pagina-einde =====

de achterkant:

Geef bij 'a' de teksten in die de knoppen van dit pagina-einde moeten bevatten.

{{:dvg7:functionaliteit:webformulieren:image_51_.png|}}

===== Postcode =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_52_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_53_.png|}}

===== Product afspraak =====

de achterkant:

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_54_.png|}}

de voorkant:
 
{{:dvg7:functionaliteit:webformulieren:image_55_.png|}} {{:dvg7:functionaliteit:webformulieren:image_56_.png|}}

===== Tekstveld =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Plaatshouder: de plaatshouder wordt in het veld getoond totdat de gebruiker een waarde invult.

{{:dvg7:functionaliteit:webformulieren:image_57_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_58_.png|}}

===== Tekstvlak =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

  * Plaatshouder: de plaatshouder wordt in het veld getoond totdat de gebruiker een waarde invult.

{{:dvg7:functionaliteit:webformulieren:image_59_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_60_.png|}}

===== Telefoonnummer =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met tokens. Kijk hiervoor bij het volgende scenario.b

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

  * Land: volgens welke landspecifieke regels moet dit veld worden gevalideerd en geformatteerd.

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt. 

  * Plaatshouder: de plaatshouder wordt in het veld getoond totdat de gebruiker een waarde invult.

{{:dvg7:functionaliteit:webformulieren:image_61_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_62_.png|}}

===== Tijd =====

de achterkant:

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Je hebt de mogelijkheid dit dynamisch te doen met termen als 'now', en '+2 hours'.

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.
Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_63_.png|}}

de voorkant:

{{:dvg7:functionaliteit:webformulieren:image_64_.png|}}

===== Veldengroep =====

de achterkant:

Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.

{{:dvg7:functionaliteit:webformulieren:image_65_.png|}}

Met dit element kunnen velden gegroepeerd worden. Zie onderstaand voorbeeld van een groep elementen:

{{:dvg7:functionaliteit:webformulieren:image_66_.png|}}

Sleep alle elementen die onder de veldengroep moeten vallen, 1 plek naar rechts, zoals op bovenstaande voorbeeld ook gedaan is. Een veldengroep kan bijvoorbeeld gebruikt worden om meerdere vragen over hetzelfde onderwerp te bundelen. 

de voorkant: 

{{:dvg7:functionaliteit:webformulieren:image_67_.png|}}

===== Verborgen =====

de achterkant:

Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. Bijvoorbeeld zoals in onderstaande voorbeeld de datum/tijd waarop het formulier ingezonden wordt.

{{:dvg7:functionaliteit:webformulieren:image_68_.png|}}

de voorkant: dit veld is verborgen en niet zichtbaar op het formulier.

===== Weergaveveld =====

de achterkant: kies dit veld als je een standaardwaarde wilt tonen op het formulier en door de inzender gelezen mogen of moeten worden.

  * Standaardwaarde: vul hier de gegevens in die al bekend zijn en meeverzonden moeten worden met het formulier. 

  * Beschrijving: beschrijving van het veld bedoeld om de gebruiker op weg te helpen. Soort help tekst.  * 

  * Validatie: hier kun je aanvinken als keuze verplicht moet worden gemaakt.

{{:dvg7:functionaliteit:webformulieren:image_69_.png|}}

de voorkant: met als standaardwaarde 'dit is een test':

{{:dvg7:functionaliteit:webformulieren:image_70_.png|}}