24.2.X

Project	Skryv platform
Versienummer	24.2.X
LTS	Nee
NEXT	JA
LATEST	Ja
Laatste LTS	23.0
Laatste NEXT	23.0
Laatste LATEST	24.1
Eerste release	11 Mar 2025
Ondersteuning tot	30 Sep 2025
Notitie	Frontoffice dashboard verbeteringen
Type	Release note
Status	DRAFT

Focus

Focus 1: Front office dashboard verbeteringen

FO DASHBOARD

Aanpassingen aan enkele achterliggende technische componenten en functies. Samen zorgen deze ervoor dat het frontoffice dashboard performanter en beter onderhoudbaar wordt.

Focus 2: Security issues

SECURITY

Naar aanleiding van de najaar 2024 uitgevoerde pentesten is het platform team bezig met het stelselmatig aanpakken en wegwerken van kwetsbaarheden.

Focus 3: service taak template selector (Studio topic)

Herwerking van de template selector voor service taken met als doel een helder overzicht en een verbeterde gebruikerservaring.

Zie Studio updates onderaan deze pagina voor alle recent doorgevoerde wijzigingen in Studio.

Wijzigingen

Wijziging met vorige LATEST

Onderstaand overzicht biedt een oplijsting van de wijzigingen tegenover de vorige LATEST-versie 24.1.X

Topic	Labels	Titel	Topic detail	Migratie detail
1	FO DASHBOARD ; FRONTOFFICE	Nieuwe endpoint voor zoekopdrachten in frontoffice.	Topic detail	-
2	FO DASHBOARD ; BACKEND	Filter niet-actieve taken in de backend, in plaats van de frontend.	Topic detail	-
3	FO DASHBOARD ; FRONTOFFICE	Opsplitsen van frontoffice dashboard (VO-stijl) in meerdere componenten.	Topic detail	-
4	BACKEND ; SECURITY	HTML-rendering voorkomen in PDF-generatie van eenvoudige tekstvelden.	Topic detail	-
5	BACKOFFICE	In het backoffice zoekscherm kan je kolommen gebaseerd op nieuwe veldtypes (tel, rrn, iban) nu ook adequaat gaan filteren.	Topic detail	-
6	BACKOFFICE	Datumveld filter in dossier- en takenlijst volgt nu de logica ‘Van - tot en met’ (beide data inclusief).	Topic detail	-
7	BACKEND	Upgrade RabbitMQ 3.11 naar 3.13	-	-
8	BACKEND ; SECURITY	Swagger UI wordt standaard uitgeschakeld voor eindgebruikers.	Topic detail	-
9	BACKEND ; BREAKING CHANGE	Breaking change ten opzichte van de vorige NEXT die eerder niet opgemerkt werd! Variabele initiëren bij opstart script moet op andere wijze gebeuren.	-	Migratie detail

Wijziging met vorige NEXT

Onderstaand overzicht biedt een oplijsting van de belangrijkste verschilpunten ten opzichte van de vorige NEXT-versie 23.0.X Raadpleeg de individuele release notes voor alle tussenliggende versies om de volledige detail te ontdekken.

Versie	Titel	Meer info
24.2.X	Frontoffice dashboard: aanpassingen aan achterliggende technische functies en componenten.	Zie hoger
24.2.X	Enkele security fixes waaronder het standaard uitschakelen van de Swagger UI voor eindgebruikers.	Zie hoger
24.1.X	Toevoeging van nieuwe veldtypes in formulieren (rijksregisternummer, telefoonnummer, iban rekening).	Zie release note
24.1.X	BPMN-gebruikerstaak kan je nu ook aanduiden als optioneel (gelijkaardige functionaliteit als CMMN).	Zie release note
24.0.X	Upgrade naar Java 17	Zie release note

Wijziging met vorige LTS

Deze versie is niet aangeduid als LTS.

Topic details

Topic 1: nieuwe endpoint voor zoekopdrachten in frontoffice

Labels	FRONTOFFICE , FO DASHBOARD
Functioneel	Functioneel verandert er voor de eindgebruiker niets. Voor applicaties die gebruik maken van een custom dashboard, gebeurde een screening om te bekijken of alles nog naar behoren werkt.
Technisch	In de netwerk tab gebeurt een call naar `api/search` in plaats van naar `api/dossiers/search` Laat applicaties toe om in de toekomst de dossierlijst te customizeren en toch gebruik te maken van de ondersteunde standaard Skryv platform endpoint. Laat toe om de toekomst de summary fields (overzichtsvelden) functionaliteit voor de frontoffice toe te voegen.
Documentatie	Dashboard FO (zie de zoekvensters).

Topic 2: filter niet-actieve taken in backend in plaats van in frontend

Labels	FRONTOFFICE , FO DASHBOARD
Functioneel	Functioneel verandert er voor de eindgebruiker niets. De eindgebruiker ziet enkel de taken die aan hem of haar zijn toegewezen, die actief en verplicht (niet-optioneel) zijn.
Technisch	Voorheen gebeurde het filteren van de taken in de frontoffice zelf. Vandaag gebeurt dit in de backend. Op die manier wordt enkel de meest noodzakelijke informatie meegestuurd naar de frontoffice en blijft de frontoffice logica zo beperkt mogelijk.
Documentatie	Dashboard FO (zie de dossierlijst, kolom required actions of vereiste acties).

Backend API call (contract)

CODE

{
  "name": "task.name",
  "type": "search/task",
  "select": [
    "task.id"
  ],
  "nestedFilter": {
    "field": "task",
    "filters": [
      {
        "path": "active",
        "term": true
      },
      {
        "path": "isOptional",
        "term": false
      },
      {
        "path": "assignee",
        "term": "6c86a67f-27bb-4ec4-9a1f-f9cb6f9c538f"
      }
    ]
  }
}

Topic 3: opsplitsen VO frontoffice dashboard in subcomponenten

Labels	FRONTOFFICE , FO DASHBOARD
Functioneel	Functioneel verandert er voor de eindgebruiker niets.
Technisch	Voorheen was het FO dashboard (stijl Vlaamse overheid) een vrij grote component. Deze is nu opgesplitst in kleinere subcomponenten. Hierdoor kunnen applicaties gericht één of meerdere van deze subcomponenten customizeren in plaats van het volledige dashboard in zijn geheel. Dit biedt het voordeel dat het gros van het dashboard gewoon mee kan gaan met de platform updates en dat enkel de gecustomizeerde subcomponenten een apart onderhoud zullen vereisen.
Documentatie	Dashboard FO

Topic 4: HTML-rendering voorkomen bij PDF-generatie tekstvelden

Labels	SECURITY , BACKEND
Functioneel	Bij de PDF-generatie van een formulier wordt HTML-formatting tekstvelden nu alsvolgt gerenderd: Eenvoudig tekstveld: de HTML-formattering wordt gezien als raw text. Multiline tekstveld (zonder HTML ingeschakeld in de backoffice): de HTML-formattering wordt gezien als raw text. Multiline tekstveld (met HTML ingeschakeld in de backoffice): de HTML-formattering wordt uitgevoerd.
Technisch	Aanpassing in de wkhtml2pdf service. Security fix die voortkwam uit de pentesten najaar 2024.
Documentatie	Zie formulier veldtypes of formulier elementtypes overzicht. Zie backoffice > dossier > formulierscherm voor weergave in backoffice en export naar PDF.

Formulierweergave in backoffice

PDF-weergave van het formulier

Topic 5: backoffice kolommen op basis van nieuwe veldtypes filterbaar

Labels	BACKOFFICE
Functioneel	Backoffice kolommen op basis van nieuwe veldtypes rijksregisternummer, telefoonnnummer of bankrekeningnummer zijn nu ook filterbaar.
Technisch	Filters toegevoegd voor nieuwe veldtypes
Documentatie	Backoffice dossierlijst Backoffice zoekscherm Formulierveld elementtypes Formulierveld visualisaties

Screenshot backoffice dossierlijst

Topic 6: backoffice datum veld filter aangepast

Labels	BACKOFFICE
Functioneel	Datum veld volgt nu de logica ‘Van .. - Tot en met …’, vergelijkbaar met de filter voor getalvelden.
Technisch	Filter aangepast.
Documentatie	Backoffice dossierlijst Backoffice zoekscherm Formulierveld elementtypes Formulierveld visualisaties

Screenshot backoffice dossierlijst

Topic 8: Swagger UI per default uitgeschakeld voor eindgebruikers

Labels	SECURITY , BACKEND
Functioneel	Productie omgeving Swagger UI mag nooit bereikbaar zijn. Test omgeving Swagger UI mag enkel bereikbaar zijn voor specifieke gebruikers.
Technisch	Applicatie eigenschap toegevoegd om de Swagger UI in- of uit te schakelen. Toegang voor specifieke gebruikers via whitelisting IP-adressen.
Documentatie	Applicatie eigenschappen. Exposed API.

Migraties

Migratie vanuit vorige LATEST

Wanneer je migreert van 24.1.X naar 24.2.X moet je letten op volgende zaken.

Migratiedetail topic 9: variabele met boolean waarde declareren bij initiatie script

Niet eerder opgemerkte breaking change ten opzichte van de vorige NEXT 23.0.X.

Voorheen gebeurde een variabele met boolean waarde declareren alsvolgt:

CODE

execution.setVariable("myVar",true);
if(myVar){
//do something
}

Bij migratie naar 24.2 moet dit alsvolgt:

CODE

execution.setVariable("myVar",true);
var myVar=execution.getVariable("myVar");
if(myVar){
//do something
}

Dit houdt verband met het wijzigen van de JavaScript engine van Nashorn naar GraalVM bij de update naar JDK 17 en Java 17.

Fix voor apps met veel bestaande scripts: je kan blijven gebruik maken van de Nashorn engine door volgende parameter toe te voegen aan je applicatie eigenschappen.

CODE

skryv.camunda.enableNashorn=true

Migratie vanuit vorige NEXT

Wanneer je migreert van 23.0.X naar 24.2.X zijn dit de belangrijkste zaken waar je op moet letten. Raadpleeg de individuele release notes voor alle tussenliggende versies om de volledige detail te ontdekken.

Versie	Beschrijving	Meer info
24.2.X	`Breaking change!` Declareren van een variabele met boolean waarde bij initiatie script moet anders gebeuren. Dit houdt verband met het wijzigen van de JavaScript engine van Nashorn naar GraalVM bij de update naar JDK 17. Via een specifieke applicatie eigenschap is het mogelijk om te blijven gebruik maken van de Nashorn engine.	Zie hoger
24.1.X	Tekstvelden met masker rijksregisternummer kan je omvormen naar velden van het nieuwe type rijksregisternummer.	Zie release note
24.1.X	Opletten met gelinkte images in communicatietemplates. De brondomeinen moeten gewhitelist zijn in de applicatie eigenschappen.	Zie release note
24.0.X	`Breaking change!` Update naar JDK 17 en Java 17	Zie release note

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
Nieuwe veldtypes (rrn, tel, iban)	De nieuwe veldtypes ondersteund vanaf Skryv platform versie 24.1.X zijn meteen ook toegevoegd in Studio.
Navigatie en algemene UI	Breadcrumb toegevoegd op enkele schermen. Servicetaak template selector overzichtelijker gemaakt.
Bugfixes en kleine verbeteringen	Klik op de link voor de details.

Patches

Onderstaand overzicht toont alle patches binnen deze versie.

Versie	Beschrijving
24.2.11	Typo in Franstalige versie Update artifactory
24.2.10	Toon error wanneer een gebruiker te veel karakters invoert binnen een tekstveld.
24.2.9	Fix: opstart niet blokkeren indien gipod-services niet beschikbaar zijn. Fix: app crash vermijden indien thumbnail generation out-of-memory gaat.
24.2.8	Feature: toestaan om magda mocks te maken die gebruik maken van één enkel endpoint, in plaats van endpoints per service.
24.2.7	Feature: betalingstaak wordt niet ‘afgerond’ indien de betaling werd gecancelled.
24.2.6	JSD-connector: wegnemen van NBSP bij het sturen van data via de JSD-connector
24.2.5	Toestaan aan frontoffice dashboard customisations om twee tabelkolommen te hebben met dezelfde key (key + header combinatie moet wel uniek blijven).
24.2.4	Fix: apps toelaten om te switchen tussen GraalVM en Nashorn als JavaScript engine.
24.2.3	Fix: taak indienen duurde te lang. Query aangepast.
24.2.2	Fix: iframe payhub.
24.2.1	Fix: extension check should be case insensitive.