31.0.X
Project | Skryv platform |
|---|---|
Versienummer | 31.0 |
LTS | Nee |
NEXT | JA |
LATEST | Ja |
Laatste LTS | 29.1 |
Laatste NEXT | 29.1 |
Laatste LATEST | 29.1 |
Eerste release |
|
Ondersteuning tot |
|
Notitie | Camunda 7.24 & SpringBoot 3.5 |
Type | Release note |
Status | APPROVED |
Focus
Focus 1: Upgrade onderliggende componenten
BACKEND
Upgrade van enkele cruciale componenten zoals Camunda, SpringBoot, ElasticSearch & MySQL. Voor Camunda, SpringBoot & MySQL zit het platform nu op de meest recente LTS (long term support) versies. Voor ElasticSearch staan in de nabije toekomst verdere upgrades gepland. Dit zorgt voor stabiliteit, veiligheid en continuïteit op de lange termijn. Check migratie info voor meer info hierover.
Focus 2: Preview bijlages frontoffice download zone
FRONTOFFICE
Herwerking van de frontoffice download zone. PDF-documenten kunnen in preview bekeken worden zonder automatische download te triggeren. Klik hier voor meer info over dit topic.
Focus 3: Open automatisch volgende taak (backoffice)
BACKOFFICE
Mogelijkheid om na afronden van de ene taak in de backoffice onmiddellijk al de volgende taak te openen. Configuratie verloopt via BPMN. Klik hier voor meer info over dit topic.
Focus 4 (Studio): Uitrol staging omgeving online Studio
Er zijn voortaan twee online Studio omgevingen: staging en productie. Interne test applicaties zijn nu configureerbaar via staging. Productie applicaties zijn configureerbaar via productie. De staging omgeving laat toe om ingrijpende changes eerst te testen vooraleer ze daadwerkelijk uit te rollen naar de productie omgeving.
Zie Studio updates onderaan deze pagina voor alle recent doorgevoerde wijzigingen in Studio.
Wijzigingen
Wijziging met vorige LATEST
Onderstaand overzicht biedt een oplijsting van alle wijzigingen ten opzichte van de vorige LATEST-versie 29.1.X
Topic | Labels | Titel | Topic detail | Migratie detail |
|---|---|---|---|---|
1 | FRONTOFFICE | Bevestigingsboodschap na indienen taak | - | |
2 | FRONTOFFICE, BACKOFFICE | Verplicht RRN bij Spotbooking aanvraag vanuit een persoon | - | |
3 | FRONTOFFICE | Preview bijlages zonder download te triggeren | - | |
4 | BACKOFFICE | Open automatisch volgende taak | - | |
5 | BACKEND | Nieuwe connector FOCUS | - | |
6 | BUGFIXES | Overzicht van bugfixes en kleine verbeteringen | - | |
7 | BACKEND | Migratie van Webuniversum naar Flanders Design System | - | |
8 | BACKEND | Migratie naar Camunda 7.24 | - | |
9 | BACKEND | Migratie naar SpringBoot 3.4 | - | |
10 | BACKEND | Migratie naar ElasticSearch 6.8.23 | - | |
11 | BACKEND | Upgrade MySQL | - | |
12 | BACKEND | Wildcard limitatie | - | |
13 | BACKEND | Authorization repository | - |
Wijziging met vorige NEXT
De vorige NEXT is gelijk aan de vorige LATEST (zie hoger).
Wijziging met vorige LTS
Deze versie is niet aangeduid als LTS.
Topics
Topic 1: Bevestigingsboodschap na indienen taak
Labels | FRONTOFFICE |
|---|---|
Functioneel | Als frontoffice gebruiker krijg ik na het succesvol indienen van een taak een bevestigingsboodschap te zien rechts onderaan het scherm. |
Technisch | Implementatie van een toaster message component (VO-styling volgens webuniversum of neutraal-styling volgens chakra). |
Documentatie | Zie frontoffice formuliertaak en bevestigingstaak. |
Screenshot
Zie rechts onderaan.
NL: De gegevens zijn ingediend.
FR: Les données ont été soumises.
EN: The data has been submitted.

Topic 2: Verplicht RRN bij aanvraag Spotbooking
Labels | FRONTOFFICE |
|---|---|
Functioneel | Gebruikers die een Spotbooking aanvraag uitvoeren als persoon of in naam van een persoon, moeten verplicht een rijksregisternummer invoeren. |
Technisch | Rijksregisternummer toegevoegd als verplicht veld in de Spotbooking integratie component. |
Documentatie |
|
Screenshot

Deze change werd gebackported naar versie 29.1 (zie patches).
Topic 3: Preview bijlages zonder download te triggeren
Labels | FRONTOFFICE |
|---|---|
Functioneel | Als gebruiker in de frontoffice wil ik een bijlage in preview kunnen bekijken zonder dat deze gedownload wordt op mijn computer. Dit verhoogt gebruiksgemak en perkt veiligheidsrisico’s in. |
Technisch |
|
Documentatie |
Screenshot 1: overzicht in downloadzone
Klik op de icoontjes om de preview te bekijken en/of te downloaden. Indien geen preview aanwezig, is enkel het downloadicoontje beschikbaar.

Screenshot 2: preview bijlage

Topic 4: Open automatisch volgende taak (backoffice)
Labels | BACKOFFICE |
|---|---|
Functioneel | Als backoffice gebruiker wil ik na afronden van een taak meteen de volgende taak geopend zien. Dit zorgt ervoor dat ik tussentijds niet hoef terug te keren naar de dossierpagina en dat ik vlotter doorheen het proces geleid wordt. |
Technisch | Bijkomende configuratie gebruikerstaak:
|
Documentatie |
100% gelijklopend met de functionaliteit die in versie 29.1.X ontwikkeld is voor de frontoffice:
Zie demo video in product update 2025-12-09 op de skryv.be website
Pop-ups eigen aan backoffice gedrag:
Tijdens het pollen naar de volgende taak krijgt de gebruiker volgende pop-up te zien:

Pop-up tijdens het pollen
Wanneer een gebruikerstaak gevonden is, krijgt de gebruiker volgende pop-up te zien:

Pop-up indien gebruikerstaak gevonden
Wanneer geen gebruikerstaak gevonden is, krijgt de gebruiker volgende pop-up te zien:

Pop-up indien geen gebruikerstaak gevonden
Topic 5: FOCUS connector
Labels | BACKEND |
|---|---|
Functioneel | Als configurator en/of ontwikkelaar wil ik vanuit een workflow een connectie leggen met het FOCUS-platform van de lokale politie om gegevens over evenementen door te geven en advies of feedback in te winnen. |
Technisch |
|
Documentatie |
Connector in opbouw.
Topic 5: Bugfixes & kleine verbeteringen
Labels | BUGFIXES |
|---|---|
Functioneel | Zie overzicht hieronder. |
Technisch | Zie overzicht hieronder. |
Documentatie | Zie overzicht hieronder. |
Admin scherm gebruikersbeheer
Het ervaren gedrag van dit scherm bij toewijzen of wegnemen van autorisaties voor gebruikers, is lichtjes gewijzigd:
Wijzigen van UI autorisaties gebeurt vlotter (losgekoppeld van taaktoewijzing).
Wijzigen van dossier autorisaties gebeurt minder snel gezien dit vastgekoppeld zit aan het taaktoewijzingsmechanisme. Er is een korte ‘content freeze’ totdat de back-end een antwoord terug stuurt.
Admin scherm teambeheer
Wijziging in de modal voor het aanmaken van een nieuw team. Key en Label zijn nu verplicht in te vullen. Meer info over dit scherm en de team functionaliteit.

Modal voor aanmaak nieuw team
Bijlage verwijderen uit een formulier
Door een frontend-bug werden bijlagen geïdentificeerd op basis van hun bestandsnaam in plaats van een unieke ID. Daardoor leidde het uploaden van twee bijlagen met dezelfde naam ertoe dat het verkeerde bestand werd verwijderd en de ‘verwijder’-pop-up vastliep.
Bijlage verwijderen uit een lijst in formulier
Zie formulier elementtype bestandenlijst.
Voorheen:

Fix via modal component:

Bulk dossier selection
Kleine verbeteringen aan tabel UX/UI:
Scrollbar in de tabel zelf (niet in venster).
Aggregaties worden nu onderaan, horizontaal naast elkaar getoond.

Extra info:
Deze change werd gebackported naar versie 29.1.X.
Contactgegevens VO frontoffice
Component onderaan het dashboard (VO-styling). Structuur werd verbeterd.

Dossierpagina backoffice: dropdown actieknop
Dropdown actieknop werkte niet naar behoren.
Na de fix:

Formulieren: e-mailvalidatie
E-mailadressen met hoofdletters raakten niet doorheen de validatie. Dit is nu verholpen.
Zie ook formulier elementtype e-mail.
Frontoffice dossiertype infopagina formattering titels
Voorheen:

Na de fix:

Meer over de dossierinformatie pagina in de frontoffice.
Gipod-connector bug fix
Bug ontdekt in de gipodService.getPublicOccupancies() functie. Deze retourneerde steeds een lege lijst. Dit is nu verholpen. Meer info over de Gipod-connector.
Guest user functionaliteit
Drie aanpassingen:
De anonieme gebruiker kan de aanvraag annuleren (indien aanvraagformulier zo geconfigureerd, zie eigenschappen gebruikerstaak > formulier). Voorheen werd deze configuratie niet opgepikt in de guest flow.
Context bij opbouw van formulier mogelijk. Voorheen was het bij de guest flow niet mogelijk om logica toe te voegen vanuit een gelinkt formulier.
IntegratedTaskPagegebruikt nu het juiste endpoint om de taak op te halen als guest user. Voorheen werd hier het verkeerde endpoint gebruikt (deze bugfix is nu verholpen en gebackported naar versie 29.1.X).
Meer info over de guest user functionaliteit:
MAGDA mobility connector
isLeaseCompany retourneerde altijd false. Deze bugfix is nu verholpen en gebackported naar versie 29.1.X).
MapBox foutmelding
Sinds platform versie 29.1 is er per app een aparte MapBox-token vereist. Indien deze niet ingesteld is, tonen we een gepaste foutmelding.
Zie ook verdere documentatie:
Voorbeeld: VO frontoffice

Map component: vreemd gedrag
Voorheen kreeg je een vreemde foutmelding wanneer je probeerde weg te navigeren van een formulier dat een map component bevatte. Deze bugfix is nu verholpen en gebackported naar versie 29.1.X).
PayHub eGovFlow aanpassingen
Twee technische aanpassingen in de PayHub connector.
Wijziging
paymentMethodENUM naar STRING waarde. Doel: ondersteuning van eender welke payment method.GET /egovflow/api/v1/payment-tasks/{taskId}/completewordt nu ook aanvaard en gedraagt zich identiek alsPOST.
Dit heeft impact op de Zarn-eigenschap SKRYV_VDBPAYHUB_PAYMENTMETHOD.
Skrygov thema (kleuren & styling) update
Kleur & styling backoffice aangepast in functie van meest recente designs.
Meer info: zie sectie over custom backoffice thema.

Spotbooking widget aanpassing
Vooraleer de applicatie de Spotbooking widget opent, wordt het formulier achterliggend opgeslagen zodat geen data verloren gaat, mocht er iets mislopen in de widget.
Migraties
Migratie vanuit vorige LATEST
Wanneer je migreert van 29.1 naar 31.0 moet je letten op volgende zaken.
Migratie topic 1: Upgrade van webuniversum naar Flanders Design System
Breaking change.
Upgrade van webuniversum naar het Flanders Design System is een technische wijziging en vormt een breaking change. Door een fout aan de kant van Vlaanderen verwijzen sommige dependencies van het oude webuniversum naar een niet-bestaande versie. Daardoor kan je foutmeldingen krijgen waarin ‘govflanders’ voorkomt en kan je applicatie niet meer opstarten. We raden daarom sterk aan om alle customisaties te upgraden. Gebruik je in je customisaties nog dependencies met ‘govflanders’? Verwijder die dan en voeg de correcte ‘govflanders’-dependencies opnieuw toe (zie hieronder). Pas daarna ook alle imports in je componenten aan.
"@govflanders/vl-ui-design-system-style": "3.4.1",
"@govflanders/vl-ui-design-system-vanilla": "24.4.3",
Migratie topic 2: Upgrade naar Camunda 7.24
Breaking change.
Upgrade van Camunda 7.22 naar Camunda 7.24. Voor zover geen breaking changes bekend. Neem rechtstreeks contact op met het Skryv platform team voor meer info en ondersteuning.
Dit brengt evenwel een databasewijziging met zich mee die de tabellen ACT_HI_COMMENT en ACT_RU_EXECUTION aanpast. Afhankelijk van het aantal rijen in je database kan dit veel tijd in beslag nemen.
Deze upgrade introduceert een nieuwe Camunda eigenschap legacyJobRetryBehaviorEnabled. Standaard hebben we deze op true geplaatst via de volgende application.properties eigenschap: skryv.camunda.legacyJobRetryBehaviorEnabled.
Link naar Camunda 7.24 update notes.
Migratie topic 3: Upgrade naar SpringBoot 3.5
Breaking change.
Upgrade van SpringBoot 3.3 naar SpringBoot 3.5 brengt potentiële breaking changes met zich mee. Neem rechtstreeks contact op met het Skryv platform team voor meer info en ondersteuning.
Link naar SpringBoot 3.4 release notes.
Link naar SpringBoot 3.5 release notes.
Migratie topic 4: Elasticsearch 6.4 niet langer ondersteund
Breaking change voor apps die nog op ES 6.4 steunden.
Apps gebaseerd op platform-versie 31.0.X maken gebruik van ES 6.8.23.
Migratie topic 5: upgrade MySQL
Breaking change.
Ondersteuning MySQL 8.0 vervalt in april 2026.
Meer info over de rol van MySQL als state component binnen een Skryv applicatie.
Migratie topic 6: wildcard limitatie
Breaking change.
Deze wijziging past het gedrag aan van onze legacy search-endpoint (/api/search/) door een controle toe te voegen op het aantal wildcards in de zoekquery. Om de Elasticsearch-server te beschermen tegen te zware queries (die de server potentieel onbeschikbaar kunnen maken), aanvaarden we voortaan niet langer meer dan 20 wildcard‑tekens in één query.
Het maximumaantal toegelaten wildcards kan – weliswaar afgeraden – aangepast worden via de applicatie‑property:skryv.elasticsearch.legacy.allowed-wildcard-occurrences.
Deze logica is ook gebackport naar de versies 29.1.x en 23.0.x.
Migratie topic 7: authorization repository
Breaking change.
De businesslogica-methods van AuthorizationRepository, die naar AuthorizationService verplaatst moesten worden, zijn nu aangepast. Pas customizaties aan zodat ze naar de juiste methods verwijzen:
findAllByUserSub→getAllByUserSubfindAllByUserSubAndResourceTypeAndResourceId→getAllByUserSubAndResourceTypeAndResourceIdfindAllForDossier→getAllForDossier
Migratie vanuit vorige NEXT
De vorige NEXT valt samen met de vorige LATEST. Voor migratie-info, zie hoger.
Migratie vanuit vorige LTS
Deze versie is niet aangeduid als LTS.
Studio updates
Onderstaand overzicht biedt een overzicht van de Studio functionaliteiten die up-to-date zijn gebracht op het ogenblik van deze platform release. Klik hier voor meer info over Studio updates.
Update | Beschrijving |
|---|---|
Naar aanleiding van ISO27001-certificatie Vanden Broele is er voor online Studio een staging omgeving opgezet. Ondertussen zijn apps voor intern gebruik overgeschakeld op deze Studio staging omgeving. Deze is bereikbaar via https://staging-studio.skryv.com/. Alle apps met dienstverlening in productie (aangevuld met enkele geselecteerde interne test apps) zijn nog altijd terug te vinden via de vertrouwde Studio omgeving https://studio.skryv.com | |
Auditlog: elke create/update van Studio-configuratie wordt gelogd (wie/wat/welk artefact & dossiertype, succes, tijdstip) in aparte staging- en productiedatabase, voor traceerbaarheid en audits. | |
Instellingen opgesplitst van één lange pagina naar zes tabs (Algemeen, Dossierlabel, Startopties, Overzichtsvelden, Gelinkte dossiertypes, eGovFlow) voor vlottere configuratie. | |
Service taak template ‘Document in frontoffice plaatsen’ aangepast | Keuze tussen communicaties als vaste (“Static”) PDF publiceren (inhoud blijft onveranderd) of als dynamische (“Dynamic”) communicatie (inhoud wordt upgedated telkens de communcatie geopend en dus gerenderd wordt). |
Mogelijkheid voor aangeduide Studio-configurators om BPMN-flows te gaan opladen naar OPH (Open Proceshuis), een initiatief van het Vlaams Agentschap voor Binnenlands Bestuur (ABB), waar lokale besturen inspiratie kunnen vinden bij het vormgeven en operationaliseren van hun workflows en dienstverleningen. | |
Binnen het dossiertype instellingen scherm in Studio is het mogelijk om een lijst van extra subprocessen te definiëren die een backoffice gebruiker met de juiste rechten & rollen kan opstarten binnen de scope van een dossier en dit vanuit de backoffice dossierpagina. | |
Nieuwe functionaliteit toegevoegd aan de service taak template ‘Dossier toevoegen aan frontoffice’. Keuze om een communicatie statisch (onveranderlijk als PDF), dan wel dynamisch (veranderlijke communicatie content type) te publiceren. | |
Mogelijkheid om de guest user flow te configureren in de Studio interface > dossiertype instellingen. | |
Mogelijkheid om de ‘open next task automatically’ functionaliteit to configureren in de Studio interface > Workflows > Gebruikerstaken. | |
Toevoeging van eigenschappen zoals ‘optioneel’, ‘asynchronous before', ‘asynchronous after’ en ‘taakverloop’. | |
Op basis van gebruikersfeedback worden stelselmatig verbeteringen aangebracht aan de lokale Studio desktop app. | |
Klik door naar het overzicht voor meer info. | |
Klik door naar het overzicht voor meer info. |
Patches
Onderstaand overzicht toont alle patches binnen deze versie.
Versie | Beschrijving |
|---|---|
31.0.1 | Upgrade axios dependency naar v.1.15.0 [security] |