27.0.X

Project	Skryv platform
Versienummer	27.0
LTS	Nee
NEXT	JA
LATEST	Ja
Laatste LTS	23.0
Laatste NEXT	25.0
Laatste LATEST	25.0
Eerste release	28 Aug 2025
Ondersteuning tot	31 Dec 2025
Notitie	Dossier opstarten zonder authenticatie (guest mode)
Type	Release note
Status	REVIEW

Focus

Focus 1: dossier opstarten vanuit frontoffice zonder authenticatie

GUEST MODE

Mogelijkheid om als burger vanuit de frontoffice een dossier op te starten zonder authenticatie (m.a.w. zonder te moeten inloggen of aanmelden). Use case zijn dienstverleningen die je zo laagdrempelig mogelijk wil houden. Denk bijvoorbeeld aan een digitaal loket voor anonieme meldingen of klachten.

Focus 2 (Studio): ontwikkeling lokale Studio desktop app

Naast online Studio komt er een Studio desktop app voor configuratoren en developers die voor ontwikkeldoeleinden een lokale Skryv applicatie willen opzetten. Praktische details, instructies en opleiding volgen in de loop van komende maanden. Wie mee wil testen, kan zich melden bij het Studio dev team.

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 25.0.X

Topic	Labels	Titel	Topic detail	Migratie detail
1	GUEST MODE ; FRONTOFFICE	Dossier opstarten vanuit frontoffice zonder authenticatie	Topic info	Migratie info
2	BACKEND ; BREAKING CHANGE	`Breaking change!` Upgrade naar Camunda 7.22 & Spring Boot 3.33	Topic info	Migratie info
3	FRONTOFFICE	Communicatie toevoegen aan frontoffice download zone: nieuwe mogelijkheden	Topic info	-
4	BACKEND	Nieuw input type formulierveld ‘bedrag’	Topic info	-
5	BUGFIX	Opgelost: in bepaalde gevallen worden optionele taken toegewezen zonder dat ze opgestart zijn.	-	-
6	BUGFIX	Opgelost: dossier niet zichtbaar in backoffice wanneer aanvraagformulier geen velden heeft.	-	-
7	BUGFIX	Opgelost: niet meer mogelijk om in of uit te zoomen in backoffice diagrammen.	-	-
8	BUGFIX	Opgelost: cursor springt naar het einde van een veld type rekeningnummer wanneer je dit probeert te editeren.	-	-

Wijziging met vorige NEXT

Zie wijzigingen met vorige LATEST.

Wijziging met vorige LTS

Deze versie is niet aangeduid als LTS.

Topics

Topic 1: Dossier opstarten vanuit frontoffice zonder authenticatie

Labels	GUEST MODE ; FRONTOFFICE
Functioneel	Als frontoffice gebruiker wil ik een dossier kunnen opstarten zonder mezelf te hoeven authenticeren. Zo verlaagt voor mij de drempel om een melding of klacht in te dienen bij het digitaal loket. Gebruikers moeten niet inloggen, maar worden wel aangespoord om dit te doen. Let op: voor de niet-geauthenticeerde aanvrager werkt de guest flow modus volgens het ‘fire and forget’-principe. Je kan een formulier indienen, maar er zijn verder geen opvolgacties of communicaties mogelijk.
Technisch	Er is een applicatie instelling aangemaakt om dossiertypes met guest user creation mode toe te laten. Er is de guest user creation mode (eLoketGuest) die je kan toevoegen in je dossiertype-instellingen. Voorlopig enkel JSON en nog niet beschikbaar in Studio UI. Beperking dat elk dossiertype opstartbaar vanuit guest mode, ook verplicht opstartbaar moet zijn via de gebruikelijke flow met authenticatie. Captcha om te verifiëren dat guest user een menselijke gebruiker is. Deze component zit rechts onderaan het scherm in de frontoffice en werkt automatisch. Map box component beschikbaar gesteld voor formulieren die gebruikt worden in een guest mode dossier flow. Twee extra schermen: Pagina waar je als gebruiker de keuze krijgt tussen verdergaan zonder inloggen of alsnog authenticeren. Pagina waar je als gebruiker terechtkomt na indienen van je formulier.
Documentatie	Applicatie instellingen Dossiertype instellingen Frontoffice inloggen Rondleiding frontoffice

Verdere verduidelijking en screenshots:

Applicatie instellingen

Extra parameter toe te voegen.

allowUnauthenticatedAccess=true

Captcha

Voorlopig is er enkel ondersteuning voor captcha.eu voorzien. Maar omdat dit een dure oplossing is, kijken we uit naar een goedkoper alternatief (zoals google recaptcha).

Dossiertype instellingen

Bijkomende creation mode met key “eLoketGuest”.

CODE

  "creationModes": [
    {
      "key": "eLoketGuest",
      "labelProviderConfiguration": {
        "type": "counter"
      },
      "grantRole": "aanvrager",
      "processMessagesOnStartup": [
        "startParkeerverbodGuest"
      ]
    },
    {
      "key": "eLoket",
      "labelProviderConfiguration": {
        "type": "counter"
      },
      "grantRole": "aanvrager",
      "processMessagesOnStartup": [
        "startParkeerVerbodAuthenticated"
      ]
    }
  ],

Workflow

Workflow opstartbaar vanuit frontoffice, zowel in guest modus (groen message start event) als in gebruikelijke modus mét authenticatie (paars message start event).

Screenshot frontoffice

Na aanklikken gewenst dossiertype op het dashboard beland je op een tussenliggende pagina waarin je de keuze krijgt om verder te gaan mét of zonder authenticatie. Deze pagina kan je niet configureren.

Na indienen van de aanvraag krijgt de guest gebruiker een bevestiging te zien.

Deze pagina kan je wel configureren via de dossiertype instellingen.

CODE

"guestDossierConfirmation": {
    "title": "Bedankt voor je aanvraag!",
    "description": "We gaan zo snel mogelijk voor je aan de slag."
    },

Topic 2: Upgrade naar SpringBoot 3.3 en Camunda 7.22

Labels	BACKEND ; BREAKING
Functioneel	-
Technisch	Belangrijke upgrade van enkele onderliggende technische componenten. Deze zijn nu op een LTS versie gebracht.
Documentatie	Camunda 7.22 release notes SpringBoot 3.3 release notes

Topic 3: nieuwe mogelijkheden communicatie toevoegen aan frontoffice download zone

Labels	FRONTOFFICE ; BACKEND
Functioneel	Als frontoffice gebruiker wil ik verschillende versies van een communicatie als PDF kunnen raadplegen nadat deze herhaaldelijk door eenzelfde service taak is toegevoegd aan de frontoffice download zone.
Technisch	Nieuwe methode toegevoegd aan bestaande service. Opgelet: Studio UI service taak template nog niet aangepast.
Documentatie	Frontoffice download zone Skryv service Service taak template in Studio UI (nog niet aangepast)

Bestaande services

Deze verwijst naar de laatst aangemaakte communicatie (mogelijk niet met de meest up-to-date gegevens). Indien communicatie nog niet bestaat, dan wordt deze ‘on-the-fly’ aangemaakt.

CODE

.getLatestOrCreateCommunicationByTemplateName(communicationTemplate)

Deze maakt de communicatie ‘on-the-fly’ opnieuw aan (met de meest up-to-date gegevens).

CODE

.createCommunicationByTemplateName(communicationTemplate)

Bestaande methode

Deze publiceert een link naar de meest recent aangemaakte communicatie in de frontoffice download zone. Vervolgens kan de gebruiker deze ophalen en downloaden als PDF.

CODE

.addToDownloadZone(labelForDownloadZone, fileNameForDownload)

Nieuwe methode

Deze publiceert een PDF op basis van de meest recent aangemaakte communicatie. Vervolgens kan de gebruiker deze downloaden.

CODE

.addToDownloadZoneAsPdf(labelForDownloadZone, fileNameForDownload)

Topic 4: nieuw formulierveld type ‘bedrag’

Labels	FRONTOFFICE ; BACKOFFICE ; BACKEND
Functioneel	Als frontoffice of backoffice gebruiker wil ik bij een formulierveld waar ik een bedrag moet invullen, een '€'-teken zien staan. Ik wil ook validatie bij het invullen (max. twee decimalen, minimum en/of maximum) en een correcte formattering.
Technisch	Nieuw data input type ‘currency’ toevoegbaar aan JSON-formulierdefinitie. In Studio UI is dit ‘bedrag’. Validatieregel maximum twee decimalen. Mogelijkheid om een minimum en/of maximum in te stellen.
Documentatie	Formulierveld types overzicht Formuliervelden visualisaties Formuliervelden specifieke eigenschappen

Screenshot ingevuld backoffice formulier.

Voorbeeld in JSON.

CODE

{
  "name": "totaal",
  "label": "Totaal",
  "type": "currency",
  "validators": [
    {
      "minimum": 0
    },
    {
      "maximum": 15
    }
   ]
}

Migraties

Migratie vanuit vorige LATEST

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

Migratie 1: guest mode

De flow bij opstart van een dossier is licht gewijzigd. Dossiertypes die gebruik maken van een dossierinformatie pagina checken best of de flow nog logisch is vanuit het standpunt van de frontoffice gebruiker.

Migratie 2: upgrade naar Camunda 7.22 en SpringBoot 3.3

Breaking change!

Door wijzigingen in de DMN-engine zijn mogelijks bepaalde FEEL-expressies geïmpacteerd. Zo wordt het speciale karakter '?' niet langer gesupporteerd.

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

Zie migratie vanuit vorige LATEST.

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
Verbeterde validatie engine issues panel	Voorheen checkte de validatie engine bij elke change alle artefacten in de applicatie. In sommige applicaties nam dit te veel resources in beslag. Vanaf heden gebeurt de check meer gericht en dus efficiënter.
Ontwikkeling lokale Skryv Studio desktop app	Er is een pipeline en build-systeem opgezet om nieuwe versies van lokale Studio desktop app aan te maken. In lokale Studio desktop app kan je switchen tussen verschillende tabbladen. De tabs hebben nu elk ook een aangepaste titel. Bij simultane bewerking van artefacten in lokale Studio en de IDE, geeft lokale Studio een waarschuwing. De gebruiker moet de pagina opnieuw laden om de externe changes binnen te nemen en verder te gaan met configureren. Bugfix: template.definitions.json bestand werd niet aangemaakt bij het opstarten van lokale Studio. Bugfix: aanmaak en aanpassing in beslissingstabellen werd niet opgepikt door lokale Studio.
Navigatie en algemene UI	Verbeterde implementatie van het issues panel zodat deze niet langer conflicteert met bestaande schermcomponenten. Elke template in de workflow waar je een artefact (formulier, communicatie, beslissing, enzovoort) kan selecteren, biedt nu ook de mogelijkheid om rechtstreeks naar dat artefact te navigeren of een nieuw artefact aan te maken.
Bugfixes en kleine verbeteringen	De Skryv business decision rule task template maakte default gebruik van een door Camunda gereserveerde variabele, wat leidde tot foutmeldingen. Basis weergave formulier expressiebouwer gaf expressies met chaining operators foutief weer.

Patches

Onderstaand overzicht toont alle patches binnen deze versie.

Versie	Beschrijving
27.0.XX	-