De release notes voor Gemeentebox 1.48.0 en 1.48.1 met onder andere verbeteringen en bugfixes aan de Formbuilder formulieren, en verschillende toegankelijkheidverbeteringen.
Release date: 11-06-2025
Op deze pagina:
Nieuw in deze release
Beperkte verwerking BSN
Wanneer op een formulier met DigiD wordt ingelogd, komt van DigiD alleen het BSN terug. Met dit BSN worden de persoonsgegevens van de invuller opgehaald met de prefill service.
Wanneer de prefill is geslaagd, zijn de opgehaalde gegevens gevalideerd en hebben gemeentemedewerkers het BSN vaak niet meer nodig. Vanwege de gevoeligheid van het BSN als persoonsgegeven, hebben verschillende gemeenten de wens om het BSN na het uitvoeren van de prefill niet onnodig verder te verwerken.
Een gemeente kan voortaan per formulier aangeven of het gaat om een beperkte verwerking van het BSN.
Bij een beperkte verwerking van het BSN wordt bij een geslaagde prefill het BSN op de volgende plekken verwijderd:
PDF aan de gemeente
Content van de e-mail aan de gemeente
De optionele JSON
Wanneer de prefill niet is gelukt, blijft het BSN aanwezig. Dit komt omdat in dat geval het BSN het enige gevalideerde gegevens is.
Daarnaast wordt in de PDF, de e-mail en de optionele JSON duidelijk aangegeven of de persoonsgegevens met een prefill zijn gevuld of niet. Dit zetten we voortaan bij het onderdeel 'Inlogmethode'. Hier staat dan 'DigiD - Persoonsgegevens automatisch gevuld' of 'DigiD - Persoonsgegevens handmatig gevuld'.
Toegankelijkheidsverbeteringen
Succescriterium 2.2.1 Timing aanpasbaar
Om te voorkomen dat gebruikers weglopen bij een formulier, en de ingevulde gegevens door iemand anders kunnen worden gebruikt, worden de ingevulde gegevens automatisch gewist wanneer het formulier langer dan 15 minuten openstaat zonder van stap te wisselen.
Optioneel kan een gemeente onze module 'Sessie verlengen' afnemen. Met deze module worden de gegevens niet meteen gewist, maar heeft de gebruiker de mogelijkheid deze sessie te verlengen. Er wordt dan een pop-up zichtbaar met de tekst: 'Let op: ingevulde gegevens verlopen bijna'. In deze pop-up staat een knop om de sessie te verlengen. Als deze knop na 2 minuten niet is ingedrukt, verschijnt de tekst: 'Let op: ingevulde informatie is automatisch verwijderd'.
In Chrome kon het onder bepaalde voorwaarden voorkomen dat de sessie niet meer herkend werd als dezelfde sessie. Wanneer je dan op de knop 'Verlengen' klikte, kreeg je alsnog de melding dat de gegevens waren verwijderd, en moest de invuller opnieuw beginnen met het formulier. Het was in deze situaties dus niet mogelijk om de sessie te verlengen.
Dit probleem hebben we opgelost.
Succescriterium 2.4.3: Focus volgorde
Naast de module 'Sessie verlengen' bestaat ook de optionele module 'Tussentijds opslaan'. Beide modules gebruiken een pop-up. Wanneer deze pop-ups in beeld zijn, is het niet de bedoeling dat je het formulier op de achtergrond kan blijven gebruiken. Dat was wel het geval.
Dit leidde ook tot toegankelijkheidsproblemen op het gebied van 'Succescriterium 2.4.7: Focus zichtbaar' en 'Succescriterium 2.4.11: Focus niet bedekt (minimum)'. Wanneer de focus op het formulier lag terwijl de pop-up in beeld was, kon het zijn dat de visuele focus verborgen was achter de pop-up.
Het is voortaan niet meer mogelijk om het formulier op de achtergrond te blijven gebruiken zolang de pop-up in beeld is.
Dit betekent ook dat je de pop-up niet meer kunt sluiten door ernaast te klikken. Je kunt deze alleen sluiten met een actieknop, het sluit-kruisje rechts bovenin de pop-up, of de ESC-toets.
Succescriterium 1.3.5 Identificeer het doel van de input
In de stap Uw Gegevens maken de invulvelden gebruik van auto-complete attributen. Dit betekent dat browsers weten wat voor soort veld het is, en het veld automatisch kunnen invullen. Het is wel belangrijk dat een invulveld het juiste attribuut heeft, zodat de juiste informatie wordt ingevuld.
Op het veld 'Voorletter(s):' stond het attribuut 'given-name'. Dat zijn niet de voorletters, maar de voornaam. Er bestaat geen auto-complete attribuut voor alleen de voorletters.
We hebben het auto-complete attribuut verwijderd voor het veld 'Voorletter(s)' in de standaard stap Uw Gegevens.
ReCAPTCHA badge
Wanneer een formulier beveiligd is met reCAPTCHA v3, wordt rechts onderaan de pagina automatisch een badge getoond in een iFrame. Wanneer je met je muis over deze badge heen hovert, klapt deze open en wordt de tekst 'beveiligd met reCAPTCHA' zichtbaar. Deze functionaliteit voldoet niet aan de toegankelijkheidsrichtlijnen op twee punten:
Succescriterium 2.1.1: Toetsenbord
De badge kan niet geopend worden met alleen het toetsenbord.Succescriterium 1.4.13: Content bij hover of focus
Wanneer je met je muis op de badge staat, kun je de badge niet sluiten zonder de muisaanwijzer te bewegen.
Google geeft de mogelijkheid om de badge te verbergen, zolang je hiervoor in de plaats tekst toevoegt die het gebruik van ReCAPTCHA zichtbaar maakt.
De badge is voortaan standaard onzichtbaar. Hiervoor in de plaats hebben we de volgende tekst toegevoegd onder de verzendknop:
Dit formulier is beveiligd met reCAPTCHA. Het privacybeleid en de servicevoorwaarden van Google zijn van toepassing.
Wijzigingen
Ondersteuning PKI-overheidscertificaat in Qmatic koppeling
Wanneer een gemeente gebruik maakt van Qmatic kan het voorkomen dat we hiervoor verbinding maken met een endpoint dat een PKI Overheid G1 certificaat gebruikt. In onze bestaande koppeling kon het certificaat niet worden herkend. Daarom hebben we hier nu ondersteuning voor toegevoegd.
Formbuilder afhankelijkheden
Binnen formbuilder is het mogelijk om afhankelijk van wat er bij een vraag is ingevuld een actie uit te voeren. Bijvoorbeeld het tonen van een nieuwe vraag, of een (fout)melding.
In de afhankelijkheid zelf was de enige mogelijkheid om te zeggen 'als X is ingevuld, doen we Y'. Het was niet mogelijk om te zeggen 'als niet X is ingevuld, doen we Y'. Wanneer dit wel nodig was in een formulier, moesten we dit op een complexe en tijdrovende manier oplossen.
Daarom hebben we deze mogelijkheid nu toegevoegd.
Bestemmingsplannen zonder detailpagina
Onze oplossing om via een API de bestemmingsplannen op de website te tonen is een maatwerkwidget per gemeente, waarin ook een deel standaard code uit Gemeentebox wordt gebruikt.
De oplossing toont een overzicht van bestemmingsplannen. De bestemmingsplannen linken naar een detailpagina per plan met beperkte aanvullende informatie. Op deze detailpagina is een link aanwezig die naar het plan in Regels op de kaart leidt.
Vanuit een van onze klanten kwam de wens om vanuit het overzicht bestemmingsplannen rechtstreeks te verwijzen naar het plan in Regels op de kaart. Dit was zonder een aanpassing in de code niet mogelijk. Deze wijziging biedt ondersteuning voor deze mogelijkheid.
Toevoegen CSS-classes
In release Gemeentebox 1.47.0 zijn verschillende CSS-classes toegevoegd zodat gebruik gemaakt kan worden van BEM-notatie in de stylesheets in nieuwe gemeentewebsites.
We hebben aanvullende classes toegevoegd en correcties uitgevoerd op de eerder toegevoegde classes.
Deze nieuwe classes hebben geen invloed op bestaande styling van je website.
Crisisbanner veiligheidsregio Brabant Alert
In de testfeed van de veiligheidsregio die op de acceptatieomgeving wordt gebruikt is de timestamp gelijk aan de actuele tijd. Hierdoor wordt bij iedere update een nieuwe versie opgeslagen en gepubliceerd. Omdat meldingen terug te draaien zijn naar eerdere versies, worden al deze nieuwe versies opgeslagen. Dit zijn 288 nieuwe versies per dag.
We hebben een controle ingebouwd, die kijkt of een melding inhoudelijk is gewijzigd. Alleen als het bericht ook inhoudelijk is gewijzigd zorgt een aangepaste timestamp voor een nieuwe versie.
Daarnaast heeft Veiligheidsregio een test uitgevoerd met de live oplossing. Hieruit bleek dat bij een van de veiligheidsregios de melding tijdelijk niet in de feed heeft gestaan en offline is gehaald. Bij de eerstvolgende update is het bericht alleen niet opnieuw gepubliceerd. Dit gebeurde pas flinke tijd later toen het bericht een update kreeg.
Omdat we met onze gemeenten hebben afgesproken dat een melding offline gehaald kan worden, hebben we een controle ingebouwd die kijkt of de melding al bestaat, en of deze online staat. Als dat niet het geval is, blijft de melding offline staan. Wel zat er een fout in deze controle, omdat deze alleen werkte als de melding geen inhoudelijke wijzigingen bevatte. Als er wel een wijziging was, werd de melding wel opnieuw gepubliceerd.
We hebben deze functionaliteit aangepast, zodat een melding die in de feed staat altijd gepubliceerd moet staan. Wanneer deze offline staat, wordt deze opnieuw gepubliceerd.
Je kunt de melding permanent van de voorkant van de website halen, door deze met een planning offline te halen. Een gepubliceerde melding dat met een planning offline staat wordt aan de voorkant niet getoond.
Bugfixes
Correcte afhandeling tijdelijke Ingenico statussen
In release Gemeentebox 1.45.0 hebben we ondersteuning toegevoegd voor tijdelijke betaalstatussen waarbij we van Ingenico bericht krijgen dat de betaling nog niet is gelukt, maar ook nog niet is gefaald. In dit geval krijgt de invuller voortaan on-screen bericht dat de betaling wacht op goedkeuring, en dat deze de mail in de gaten moet houden.
Wanneer we binnen 24 uur van Ingenico alsnog een definitieve status krijgen, krijgt de invuller bij een geslaagde betaling een ontvangstbevestiging en krijgt de gemeente de ingevulde gegevens. Bij een gefaalde betaling krijgt de invuller een afwijzing, en worden de ingevulde gegevens gewist.
Door een bug kon deze herziene status van Ingenico niet worden verwerkt. Daarom werd deze situatie altijd afgehandeld alsof we niet binnen 24 uur alsnog een definitieve status hadden gekregen van Ingenico.
In dat geval worden de ingevulde gegevens gewist, en krijgt de invuller de volgende mail:
Op [datum] om [tijd] uur heeft u het formulier “[naam formulier]“ ingevuld. Hierbij hoorde een betaling. Er ging iets niet goed met deze betaling.
De gemeente neemt het formulier daarom niet in behandeling.
Neem contact op met de gemeente als het bedrag wel van uw rekening is afgeschreven.
We hebben dit probleem opgelost, waardoor de definitieve status op de juiste manier wordt verwerkt.
Dubbele kop in niet-dynamic fieldset
Het is binnen formbuilder mogelijk om één vraag met meerdere invulvelden toe te voegen in een formulier. Wanneer je deze set vragen maximaal één keer kunt invullen noemen we dit een niet-dynamic fieldset.
Wanneer deze niet-dynamic fieldset in stap 1 van een formulier werd gezet, kwam de hoofdvraag automatisch een keer extra als kopje boven de fieldset te staan. Dit probleem hebben we opgelost.
Tussentijds opslaan dynamic fieldset
Het is binnen formbuilder mogelijk om één vraag met meerdere invulvelden toe te voegen in een formulier. Wanneer je deze set met vragen meerdere keren kunt toevoegen en invullen noemen we dit een dynamic fieldset.
De invulde gegevens in de dynamic fieldsets werden niet correct opgeslagen wanneer het formulier tussentijds werd opgeslagen. Dit probleem hebben we opgelost.
Onterecht verplichte vragen
Sommige vragen worden alleen gesteld als een andere vraag op een bepaalde manier is beantwoord. Door de manier waarop dit was opgezet werden deze vragen altijd automatisch verplicht gemaakt. Het komt bijna nooit voor dat een afhankelijke vraag niet verplicht is, maar dat zou wel gewoon moeten kunnen. Daarom worden deze vragen voortaan alleen verplicht gemaakt, als deze ook ingesteld staan als een verplichte vraag.
Ophalen verordeningen
Voor het ophalen van verordeningen maken we gebruik van een SRU-koppelvlak zoekdienst van overheid.nl. Dit is een service die reageert met een XML bericht. Recent is deze service tijdelijk niet beschikbaar geweest vanwege onderhoud. De URL die we aanroepen toonde netjes een HTML-melding dat de service in onderhoud was. Deze situatie leverde waarschuwingen op in onze logs.
We hebben een wijziging aangebracht die deze situatie ondervangt, en een correcte melding toont in onze logs.
Afbeelding nieuwe fase tijdlijn
Wanneer je bij het aanmaken van een nieuwe fase een afbeelding selecteerde, werd deze afbeelding niet correct opgeslagen. Je moest hiervoor de fase na het aanmaken wijzigingen om de afbeelding alsnog toe te voegen.
De afbeelding wordt nu correct opgeslagen.