25.0.X

Project	Skryv platform
Versienummer	25.0.X
LTS	Nee
NEXT	Ja
LATEST	Ja
Laatste LTS	23.0
Laatste NEXT	24.2
Laatste LATEST	24.2
Eerste release	18 Jun 2025
Ondersteuning tot	30 Sep 2025
Notitie	SpringBoot en Camunda update + toevoeging licentie- en verbruiksgegevens
Type	Release note
Status	APPROVED

Focus

Focus 1: Verbruik

VERBRUIK

Focus voor 25.0.X is om een start te maken met het bijhouden van gebruiksgegevens binnen elke applicatie (aantal drafts, aantal dossiers, maximum aantal dossiers zoals gedefinieerd in de licentie) en het visualiseren van die gegevens in de backoffice admin sectie.

Focus 2: Upgrade naar SpringBoot 3.1 en Camunda 7.20

Dankzij de upgrade naar SpringBoot 3.1 is het nu ook mogelijk geworden om over te schakelen op Camunda 7.20. Dit is een versie die op lange termijn ondersteund blijft. Opgepast: dit brengt potentiële breaking changes met zich mee.

Focus 3: content blocks

Standaardblokken tekst (eventueel verrijkt met afbeeldingen) die je over verschillende communicatie templates heen kan gebruiken.

Focus 4 (Studio): Skryv platform versie selector in Studio

Door de Skryv platform versie waarop je applicatie draait aan te duiden in Studio, krijg je als configurator enkel toegang tot die Studio functionaliteiten die compatibel zijn met de aangeduide platform versie.

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.2.

Topic	Labels	Titel	Topic detail	Migratie detail
1	VERBRUIK ; BACKEND	Onderscheid tussen ‘Concept dossiers’ en ‘Ingediende dossiers’ + functie schrijven om dossier van ‘Concept’ naar ‘Ingediend’ te brengen.	Topic info	Migratie info
2	VERBRUIK ; BACKEND	Licentiebestand (JSON) waarin specifieke afspraken met de klant genoteerd kunnen worden (start en eind datum, facturatieperiode, maximum aantal concept en ingediende dossiers, enzovoort).	Topic info	-
3	FRONTOFFICE	Spinner in dossiertabel tijdens actie filteren op dossiertype.	Topic info	-
4	BUGFIX ; BACKOFFICE	Filter ‘Van’ - ‘Tot en met’ voor velden van type getal bijgesteld. 0 werd niet herkend als waarde.	Topic info	-
5	BACKEND ; BREAKING	`Breaking change!` Update naar SpringBoot 3.1 & naar Camunda 7.20	Topic info	Migratie info
6	BACKOFFICE	Optionele gebruikerstaken (niet via CMMN, maar via input parameter `isOptional=true`) worden nu aangeboden onder de ‘Acties’ knop binnen de backoffice.	Topic info	-
7	BACKEND	Introductie van content blocks. Dit zijn standaardblokken tekst (eventueel verrijkt met afbeeldingen) die je over verschillende communicatie templates heen kan gebruiken.	Topic info	-
8	BACKEND	Nieuwe Magda connector met mogelijkheid om voertuiggegevens op te halen op basis van nummerplaat.	Topic info	-

Wijziging met vorige NEXT

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

Versie	Titel	Meer info
Idem als bij Wijzigingen met vorige LATEST (zie hoger)

Wijziging met vorige LTS

Deze versie is niet aangeduid als LTS.

Topic details

Topic 1: onderscheid concept dossiers en ingediende dossiers

Labels	VERBRUIK ; BACKEND
Functioneel	Als configurator wil ik bepalen of een nieuw dossier al dan niet in ‘concept’ ('draft') modus start. Als configurator wil ik de optie hebben om het dossier een aangepast label te geven in ‘concept’ modus. Ik wil ook het moment bepalen wanneer een ‘concept’ dossier effectief een ‘ingediend’ dossier wordt.
Technisch	Toevoeging van een dossiereigenschap die het dossier als ‘concept’ (draft) of ‘ingediend’ (submitted) markeert. Toevoeging van een instelling in de dossietype instellingen (dosdef) om het dossier op te laten starten in ‘concept’ modus. Toevoeging van functionaliteit in de dossiertype instellingen (dosdef) om het dossier een aangepast label te geven in ‘concept’ modus. Toevoeging van een specifieke functie die je kan oproepen via een service taak binnen de wokflow. Hiermee kan je van een ‘concept’ (draft) dossier een ‘ingediend’ (submitted) dossier maken.
Documentatie	Wat is een dossier? (uitleg onderscheid en use case) Dossierinformatie (nieuwe eigenschap ‘concept’) Workflow expressies syntax (nieuwe functie ‘submitDossier’) Dossiertype instellingen ('startAsDraft' & ‘draftLabelProviderConfiguration’)

Functie

Deze functie kan je oproepen via een service taak met template ‘Schrijf een expressie'.

CODE

${skryv.dossierFromScope(execution).submitDossier()}

Dossiertype instellingen

Via deze instellingen start een dossier bijvoorbeeld met label 2025-DRAFT-043 en krijgt deze na uitvoeren van de functie label 2025-SUBMITTED-015.

CODE

{
  "key": "myDosdef",
  "startAsDraft": "true",
  "draftLabelProviderConfiguration": {
    "type": "counter",
    "counterLabel": "DRAFT",
    "includeYearPrefix": true,
    "counterDigits": 3
  },
  "labelProviderConfiguration": {
    "type": "counter",
    "counterLabel": "SUBMITTED",
    "includeYearPrefix": true,
    "counterDigits": 3
  }
}

Topic 2: licentiebestand

Labels	VERBRUIK ; BACKEND
Functioneel	Als Skryv project manager wil ik de gemaakte licentieafspraken kunnen neerschrijven in een bestand om een heldere communicatie met de klant mogelijk te maken. Als business owner wil ik vanuit Skryv het licentiebestand ontvangen en toevoegen binnen de applicatie. Als business owner wil ik deze licentieafspraken kunnen raadplegen via de backoffice admin sectie van de applicatie.
Technisch	Aanmaak van een JSON-bestand die de licentieafspraken bevat. De inhoud van dit JSON-bestand is versleuteld en enkel leesbaar door de server. Zo kunnen gebruikers zelf geen aanpassingen doorvoeren in het bestand. Voor elke nieuwe licentieperiode zal een extra licentiebestand toegevoegd worden. Zo ontstaat een historiek. Licentieafspraken: Naam Dossiertype Startdatum licentie Einddatum licentie Lijst met facturatieperiodes, met voor elke periode: Startdatum Einddatum Naam Limieten: Maximum aantal draft dossiers Maximum aantal submitted dossiers Lijst met e-mailadressen in functie van uitsturen notificaties
Documentatie	Backoffice admin > Verbruik

Opmerking JSON-bestand

Opgepast: data-tijden zijn in UTC aan te duiden (dus overal gevolgd door Z, wat staat voor Zulu-time). Hou er rekening mee dat tijdens de winterperiode België een uur achterop loopt tegenover UTC. Tijdens de zomerperiode is dat twee uren.

	Winterperiode	Zomerperiode
UTC	12:00	12:00
België (CEST)	11:00	10:00

Topic 3: spinner in frontoffice dossiertabel

Labels	FRONTOFFICE
Functioneel	Als frontoffice gebruiker trigger ik de dossiertype filter in het dashboard. Tijdens uitvoering van de filteractie zie ik een spinner in de dossiertabel. Zo weet ik dat de actie ‘in uitvoering is’.
Technisch	Spinner in dossiertabel
Documentatie	Frontoffice dashboard

Topic 4: ‘Van - Tot en met’ filter voor getalvelden

Labels	BACKOFFICE ; BUGFIX
Functioneel	Als backoffice gebruiker wil ik een kolom met getalvelden kunnen filteren. De filter werkt volgens de logica ‘Van - Tot en met'. Een ingevulde waarde is steeds inclusief (zelfde logica als bij een kolom met datumvelden). Ook 0 wordt nu herkend als geldige waarde.
Technisch	Filter functionaliteit aangepast
Documentatie	Dossierlijst backoffice

Topic 5: upgrade naar Camunda 7.20 en Spring Boot 3.1

Labels	BACKOFFICE ; BREAKING
Functioneel	-
Technisch	Belangrijke upgrade van enkele onderliggende technische componenten. Deze zijn nu op een LTS versie gebracht.
Documentatie	-

Topic 6: optionele taken onder acties knop in backoffice

Labels	BACKOFFICE
Functioneel	Gebruikstaken die gemarkeerd zijn als optioneel via de input parameter `isOptional:true` komen niet in de lijst van vereiste acties terecht, maar zijn beschikbaar onder de acties knop in de backoffice.
Technisch	Filter toegevoegd in backoffice.
Documentatie	Gebruikstaken Optionele acties in backoffice. Traditionele manier van werken via CMMN & optionele acties. Zie ook release note 24.1.X: gebruikstaak optioneel maken. Zie ook release note 24.1.X: optionele gebruikstaken filteren in frontoffice.

Een belangrijk verschil met de methode via CMMN is dat er bij een optionele gebruikerstaak vooraf geen bevestigingspopup gevisualiseerd wordt. Dit specifieke gedrag kan je echter ook zonder CMMN realiseren door twee gebruikerstaken na elkaar te configureren: een optionele bevestigingstaak gevolgd door een vereiste taak.

Opgelet: er is nog wat werk aan de winkel om de optionele gebruikerstaken ook correct te visualiseren binnen de taak- en dossieroverzichten.

Topic 7: content blocks

Labels	BACKEND
Functioneel	Als configurator kan ik standaard stukken tekst definiëren binnen een content block, en deze vervolgens gebruiken over meerdere communicatie templates heen.
Technisch	Hiervoor werd een nieuwe optie (`partial`) toegevoegd aan de `purpose` eigenschap binnen het .json communicatie template definitie bestand. Dit laat toe om een .hbs communatiecatie template aan te duiden als content block. Nieuwe handlebar om de content block op te halen en weer te geven in een communicatie: `{{#block "partialBlockContent"}}{{/block}}` Functionaliteit ook toegevoegd in Studio interface.
Documentatie	Communicatie template definitie bestand Communicatie template editor: content blocks Studio update rond content blocks

Opgelet voor recursiviteit . Als je binnen een content block nogmaals verwijst naar dezelfde content block (circulaire referentie), krijg je een infinite loop. De taak die de communicatie probeert aan te maken, gaat in incident state en het document wordt niet gecreëerd.

Topic 8: nieuwe magda connector ophalen voertuiggegevens

Labels	BACKEND
Functioneel	Als configurator wil ik de magda mobility service aanspreken. Hiermee is het mogelijk om voertuiggegevens op te halen op basis van een nummerplaat.
Technisch	Documentatie volgt.
Documentatie	Overzicht connectoren Workflow expressies syntax

Migraties

Migratie vanuit vorige LATEST

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

Migratiedetail topic 1: onderscheid concept dossiers versus ingediende dossiers

In heel wat bestaande applicaties wordt het onderscheid tussen concept en ingediende dossiers al gemaakt, en dit enkel en alleen op basis van het label. Typisch is er een apart labelformaat bij opstart vanuit frontoffice geconfigureerd (dit representeert dan een ‘concept’ dossier), met daarnaast het standaard labelformaat (dit representeert dan een ‘ingediend’ dossier). De overgang van ‘concept’ naar ‘ingediend’ gebeurt dan via de functie .recalculateLabel(). Deze werkwijze blijft ondersteund. Er is geen geautomatiseerde migratie vanuit deze werkwijze naar de nieuwe werkwijze voorzien. Indien je beslist om bij de oude manier van werken te blijven, moet je er rekening mee houden dat de telling van concept en ingediende dossiers niet correct zal verlopen en je dus geen correcte verbruiksstatistieken zal kunnen consulteren in de backoffice admin sectie.

Migratiedetail topic 6: update naar SpringBoot 3.1 en Camunda 7.20

Breaking change!

Externe migratie info:

Applicaties met extensies en/of customizaties moeten extra waakzaam zijn. Een lijst van known issues is beschikbaar bij het Skryv platform team.

Migratie vanuit vorige NEXT

Wanneer je migreert van 24.2 naar 25.0 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
XX.XX
XX.XX

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
Dossiertype instellingen UX	Het scherm voor dossiertype instellingen is grondig gewijzigd met het oog op een betere gebruiksvriendelijkheid.
Bugfixes en kleine verbeteringen	Bij switchen naar een ander BPMN elementtype of naar een andere service taak template worden alle eigenschappen (bijvoorbeeld listeners of input parameters) gereset.
Nieuwe veldtypes tel, rrn, iban	De nieuwe veldtypes zijn nu ook geïntegreerd binnen de gepredefinieerde groepen.
Issues panel	Verbeterde UI + functionaliteit is uitgerold naar alle gebruikers.
Content blocks	Content blocks zijn standaard blokken die je kan gebruiken over meerdere communicatie templates heen.
Skryv platform versie selector	Laat toe om in Studio de Skryv platform versie waarop je applicatie is gebaseerd, te selecteren. Hierdoor worden Studio functionaliteiten die enkel nuttig zijn voor hogere Skryv platform versies, doelbewust verborgen. Eerste voorbeelden hiervan zijn het gebruik van de nieuwe veldtypes telefoon, rijksregisternummer, iban en de validatie per formuliersectie functionaliteit.
Navigatie en algemene UI	Enkele belangrijke verbeteringen aan de service taak template ‘communicatie in FO plaatsen’.
Studio desktop app	Eerst aanzet voor een lokale Studio desktop app. Deze is voorlopig enkel beschikbaar voor interne Skryv-configuratoren.
Conceptdossiers	Configuratie van conceptdossiers mogelijk via de dossiertype instellingen in Studio. Voor meer info omtrent conceptdossiers, zie hoger op deze pagina.

Patches

Onderstaand overzicht toont alle patches binnen deze versie.

Versie	Beschrijving
XX.XX.1	-