Document toolboxDocument toolbox

Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers


Een samenvattingspagina maken

Als u een formulier hebt met verschillende stappen kan het handig zijn in de laatste stap nog eens alle data te tonen die in de voorgaande stappen werd ingevuld.

Hiervoor kan u gebruik maken van een speciale component: de summary component.

Hieraan kan u via een script verschillende combinaties van “Label - waarde” toevoegen, bv “Naam: Peter”

Als de waarde leeg is zorgt de component er zelf voor dat deze Label/waarde niet wordt getoond. Dit bespaart u heel wat extra logica in de regels (“als dit is ingevuld, toon dan dat, etc”)

 

Hoe begin ik er aan?

  • Maak een tab waarin je de samenvatting wil tonen

  • Voeg in deze tab de component “Samenvatting” toe (mogen er ook meerdere zijn met tekst of titels tussen)

  • Geef deze een bepaalde naam, bv “summary aanvrager”

  • Dan moet je een rule toevoegen op de Root panel van je formulier:

  • De rule moet getriggered worden bij Initialise;

Een voorbeeld van de functie zelf:

 

guideBridge.on("elementNavigationChanged" , function(event, payload) {     if (payload.newText === "guide[0].guide1[0].guideRootPanel[0].wizardpanel[0].panel_samenvatting[0]")  {                   // Hier geef je aan welke componenten moeten geupdate worden                   updateSummary(summary_plaats,                                         {                             "Geboorteplaats": Gemeente_aangifte.displayValue });    updateSummary(summary_tweede_ouder,                                         {  Rijksregisternummer": rijksregisternummer_tweedeouder.value,                            "Voornaam": voornaam_tweede_ouder.value,                                            "Familienaam": achternaam_tweede_ouder.value,                                            "E-mailadres": Email_tweede_ouder.value                               });              } });

 

Opmerkingen over de functie:

  • wizardpanel[0].panel_samenvatting[0]: geeft aan in welk paneel de summary staat, dat moet je dus aanpassen aan je formulier. Deze lijn zorgt ervoor dat als de gebruiker naar het panel met de samenvatting gaat, alle “samenvatting” componenten worden opgevuld

  • In deze rule gebruik je de functie “updateSummary” om de Samenvattingscomponent op te vullen.(in dit voorbeeld: 2 componenten met de naam summary_plaats en summary_tweede_ouder)

    • Input parameters voor de functie:

      • Naam van de component

      • Een array met de dingen die je wil toevoegen aan de samenvatting

        • De array bevat een label dat je wil tonen, en dan de waarde van een component uit het formulier

    • De component zorgt er zelf voor dat als de waarde leeg is, dit veld niet wordt getoond in de summary

    • Je kan in het javascript ook extra logica steken om te bepalen wat er juist getoond wordt in de summary

Bv:

if (RelatieTotKind.value === "0") {           Aangever= "Vader of meemoeder";         } updateSummary(summary_aanvrager,              {               "Aangifte door": Aangever,               "Gezinssituatie": Gezin,               "Rijksregisternummer": Rijksregisternummer_aanvrager.value,               "Voornaam": Voornaam_aanvrager.value,               "Familienaam": Naam_aanvrager.value,               "Geboortedatum": geboortedatumAanvragerString,               "Geboorteland": Geboorteland_aanvrager.displayValue,               "Geboorteplaats": Geboorteplaats_aanvrager.displayValue,               "Geboorteplaats Buitenland": Geboorteplaats_buitenland_aanvrager.value,               "Nationaliteit": Nationaliteit_aanvrager.displayValue,               "Burgerlijke staat": Burgerlijke_staat_aanvrager.displayValue,               "E-mailadres": Email_aanvrager.value,               "Telefoonnummer": Telefoonnummer_aanvrager.value                                          });

 Resultaat:

Iets als:

 

De samenvatting gebruiken in de notificatie naar de aanvrager

Als u de aanvrager een bevestiging wil sturen, en daarin alle informatie uit het formulier wil herhalen, kan u handig voordeel halen uit het feit dat u de samenvatting component hebt gebruikt.

In de body van de notificatie kan je namelijk scripting gebruiken die de inhoud van de Samenvatting componenten mooi als een bulleted list in de email zet; bv

Overzicht van uw huwelijksaangifte : <#-- Aanvrager --> <#assign summAv=wizardpanel.panel_samenvatting.summary_aanvrager> <#assign lsummAv = summAv?eval_json> Gegevens van de aanvrager <#list lsummAv as k, v> <#if v?has_content> • ${k}: ${v} </#if> </#list>

De configuratie van de notificatie ziet er dan zo uit:

Dit resulteert in iets als:

 

U kan hier ook een voorbeeld van vinden in de folder Voorbeelden:

https://beheer.dv.formulieren-ti.vlaanderen.be/editor.html/content/forms/af/vlaamse-overheid/voorbeelden/geboorte/secured/gzg-aangifte-geboorte.html

Dit is een officiële website van de Vlaamse overheid - Uitgegeven door Digitaal Vlaanderen: https://www.vlaanderen.be/digitaal-vlaanderen

DISCLAIMER: http://www.vlaanderen.be/nl/disclaimer
TOEGANKELIJKHEID: http://www.vlaanderen.be/nl/toegankelijkheid