|
Project |
Skryv platform |
|---|---|
|
Versienummer |
32.1.X |
|
LTS |
Nee |
|
NEXT |
ja |
|
LATEST |
Ja |
|
Laatste LTS |
29.1.X |
|
Laatste NEXT |
32.0.X |
|
Laatste LATEST |
32.0.X |
|
Eerste release |
|
|
Ondersteuning tot |
|
|
Notitie |
Kopieer formuliergegevens uit eerder dossier |
|
Type |
Release note |
|
Status |
APPROVED |
Focus
Focus 1: Kopieer formuliergegevens uit een eerder dossier
BACKEND
Dekt de use case af waarbij een aanvrager een nieuw dossier opstart, maar voor het invullen van de formulieren kan steunen op een eerder ingediend dossier. Denk aan het aanvragen van een vergunning voor een evenement dat jaarlijks terugkeert en waarbij sommige basisgegevens jaar na jaar onveranderd blijven. De kopieeractie gebeurt via een service taak in de BPMN-workflow.
Focus 2: Tussentijds opslaan bij invullen van formulieren
BACKOFFICE , FRONTOFFICE
Bij het openen en invullen van formulieren in de backoffice of frontoffice was het voor de gebuiker niet duidelijk wanneer de auto-save functionaliteit werd getriggerd en wanneer niet. Om dit transparanter te maken hebben we dit gelijkgetrokken met andere bestaande applicaties. De auto-save functionaliteit is uitgeschakeld, en gebruikers moeten nu expliciet opslaan of indienen om hun werk vast te leggen. Gebruikers die wegnavigeren van de pagina, krijgen een pop-up als waarschuwing.
Focus 3 (Studio): toevoeging ‘searchable’-vlag formulierdefinities en referentielijsten
Twee in platform-versie 32.0.0 uitgewerkte functionaliteiten zijn nu beschikbaar via de Studio interface. Met de ‘searchable’-vlag kan je aangeven welke formuliervelden indexeerbaar zijn en welke niet. Via referentielijsten kan je een uitgebreide keuzelijst koppelen aan een tekstveld.
Zie Studio updates onderaan deze pagina voor alle recent doorgevoerde wijzigingen in Studio.
Wijzigingen
Wijziging met vorige LATEST (32.0.X)
|
# |
Labels |
Titel |
Topic detail |
Migratie detail |
|---|---|---|---|---|
|
1 |
BACKEND |
Kopieer formuliergegevens uit een eerder dossier |
- |
|
|
2 |
backoffice , FRONTOFFICE |
Geen auto-save meer bij formulieren |
- |
|
|
3 |
BACKEND |
Update FOCUS connector |
- |
|
|
4 |
BACKEND |
Logging MAGDA connector calls |
- |
|
|
5 |
BACKEND |
Kaart formulier element type (Mapbox) |
- |
|
|
6 |
BACKEND |
IBAN en telefoon formulier element types |
- |
|
|
7 |
backend , bugfix |
Bugfixes en kleine verbeteringen |
- |
|
|
8 |
backoffice , FRONTOFFICE |
GovFlanders afhankelijkheden |
- |
Wijziging met vorige NEXT
De vorige NEXT valt samen met de vorige LATEST. Zie overzicht hierboven.
Wijziging met vorige LTS
Deze versie is niet aangeduid als LTS.
Topics
Topic 1: Kopieer formuliergegevens uit een eerder dossier
|
Labels |
BACKEND |
|---|---|
|
Functioneel |
Binnen de scope van een dossier een formulier aanmaken en invullen op basis van eenzelfde formulier uit een eerder opgestart, bestaand dossier. |
|
Technisch |
|
|
Documentatie |
Use case: dossiers die periodiek terugkomen en waarbij je de aanvrager niet alle info opnieuw wil laten invullen. Denk aan het aanvragen van een vergunning voor een evenement dat jaarlijks terugkeert en waarbij sommige basisgegevens jaar na jaar onveranderd blijven.
${skryv.dossierFromScope(execution).copyFormDataFrom(sourceDossierId, formKey, excludedPaths)}
De expressie verwacht volgende input parameters:
-
sourceDossierId: dit is de business key of ID van het brondossier. -
formKey: key van het formulier dat betrokken is in de copy/paste actie. Zowel in brondossier als doeldossier moet het gaan om exact hetzelfde dossier. -
excludedPaths: dit zijn formuliervelden die niet betrokken mogen raken in de copy/paste actie.
Topic 2: Tussentijds opslaan bij invullen van formulieren
|
Labels |
backoffice , FRONTOFFICE |
|---|---|
|
Functioneel |
Gebruikers in backoffice of frontoffice moeten een formulier expliciet opslaan of indienen om hun werk vast te leggen. |
|
Technisch |
Auto-save functionaliteit verwijderd. Pop-up als waarschuwing voor gebruikers die wegnavigeren zonder op te slaan of in te dienen. |
|
Documentatie |
Screenshots
Knoppen om op te slaan en in te dienen.
Pop-up als waarschuwing bij wegnavigeren zonder opslaan.
Topic 3: Update FOCUS connector
|
Labels |
BACKEND |
|---|---|
|
Functioneel |
Wanneer het advies van de politie een bijlage bevat, is het nu mogelijk om deze te downloaden en op te slaan binnen de context van het dossier. |
|
Technisch |
Nieuwe functie saveAdviceAttachment toegevoegd. |
|
Documentatie |
Opmerkingen
-
De FOCUS connector is niet rechtstreeks via eenvoudige expressie aanspreekbaar vanuit de BPMN-workflow, en zit nog in testfase. Gebruik de connector voorlopig enkel in nauw overleg met het Skryv platform team.
-
Bij de repealAdviceRequest functie is de achterliggende REST-call aangepast (van
DELETEnaarPOST). -
De getUnconfirmedAdvice functie retourneert nu een lijst van opgevraagde adviezen, elk met een eigen request ID.
-
De updateAdvice functie is geschrapt, omdat deze niet bestaat in de FOCUS OpenAPI-spec.
Topic 4: Logging MAGDA connector calls
|
Labels |
BACKEND |
|---|---|
|
Functioneel |
Telkens een Skryv app authentieke data ophaalt via MAGDA wordt nu in een aparte log alle details over deze call bijgehouden. Dit is een verplichting opgelegd vanuit Vlaanderen. De audit logging zat tot voorheen verweven in de algemene logging, maar wordt sinds versie 32.0.X opgeslagen in een aparte datasource. |
|
Technisch |
Voeg twee applicatie eigenschappen toe om deze functionaliteit te activeren binnen je Skryv applicatie. Beiden zijn default
|
|
Documentatie |
|
Opmerkingen
-
Logging gebeurt voorafgaand aan de eigenlijke call.
-
Voorlopig worden deze logs bijgehouden in je Skryv applicatie. Daar kunnen ze geconsulteerd worden naar aanleiding van een audit. In een latere fase zal het mogelijk zijn om deze proactief door te spelen aan MAGDA (Digitaal Vlaanderen).
-
De logging werkt automatisch en out-of-the-box vanuit de MAGDA connectorcode.
-
Het is mogelijk om dit framework toe te voegen aan een projectspecifieke, custom connector. Dit gebeurt via een eenvoudige method. Contacteer het Skryv platform team voor begeleiding.
Topic 5: kaart formulier element type (Mapbox)
|
Labels |
BACKEND |
|---|---|
|
Functioneel |
Er zijn bijkomende configuratiemogelijkheden voor het formulier element type |
|
Technisch |
Bijkomende configuratieparameters in de JSON-beschrijving van de formulierdefinitie. |
|
Documentatie |
Screenshot Studio met vaste waardes
JSON-sample met berekende initiële locatie en zoom
{
"name": "locatie",
"label": "Locatie",
"type": "map",
"computedCenterLat": "initieleBreedtegraad",
"computedCenterLng": "initieleLengtegraad",
"computedZoom": "initieleZoom",
"drawMode": "POLYGON",
"defaultLayer": "GRB"
}
Topic 6: IBAN en telefoonnummer element types
|
Labels |
BACKEND |
|---|---|
|
Functioneel |
Voor formulieren die alle landen moeten ondersteunen, is het niet langer nodig om een volledige lijst van 219 landen te configureren. Je kan deze lijst met één enkele eigenschap beschikbaar maken. |
|
Technisch |
|
|
Documentatie |
Screenshot formulier
JSON-sample formulierdefinitie
{
"name": "newPhoneVmdyfp",
"label": "Telefoonnummer",
"type": "phone",
"countries": [
"be",
"fr",
"de",
"nl"
]
},
{
"name": "newIbanY2Ch4D",
"label": "Rekeningnummer",
"type": "iban",
"countries": [],
"allowAllCountries": true
}
Topic 7: Bugfixes & kleine verbeteringen
Backoffice login
BUGFIX
Opgelost dat dubbele login-aanroepen de sessie blokkeerden (het ‘blank page’-probleem). De sessie herstelt zich nu via redirect naar de login pagina.
Bijlagen verwijderen uit S3-bucket
BUGFIX
In een specifiek scenario werden bijlages wel gemarkeerd als contentDeleted, maar werden de bijlages zelf nooit verwijderd uit de S3-bucket.
Bijlagen zonder naam worden geblokkeerd
FRONTOFFICE ; BACKOFFICE
Gebruikers kunnen voortaan geen bijlages zonder naam (bijvoorbeeld ' .pdf') uploaden.
CSV-export
BACKOFFICE ; BUGFIX
CSV-export verliep traag. Bugfix gerelateerd aan de persistent audit logging functionaliteit.
DocMod via Lambda geeft opnieuw dezelfde fouten terug
BACKEND BUGFIX
Wanneer DocMod via Lambda wordt gebruikt, worden fouten opnieuw op dezelfde manier vertaald als bij de HTTP-client.
Elasticsearch re-index issues
BACKEND ; BUGFIX
Twee bugfixes:
-
Nieuwe dossiers werden niet zichtbaar tijdens re-index.
-
Bij een mislukte re-index, bleven we updates sturen naar deze index.
Exports en FGA
BUGFIX
De fijnmazige toegangsrechten (FGA) worden nu ook correct toegepast op exports getriggerd vanuit de backoffice, consistent met de zoekschermen.
Gebruikersnamen eGovFlow 2.0
BUGFIX
Fix voor ontbrekende gebruikersnamen bij gemigreerde gebruikers, zodat processen niet langer vastlopen op lege velden.
Misleidende succesboodschap bij gekoppelde taken
FRONTOFFICE
Wanneer een gebruikerstaak via afterCompletionGoTo automatisch doorgaat naar een volgende gebruikerstaak, werd in de frontoffice onterecht een succesmelding getoond op de tussenstap. Daardoor leek het voor de burger alsof de aanvraag al volledig was afgehandeld. De succesmelding wordt nu onderdrukt wanneer er nog een volgende gebruikerstaak volgt.
Migratie MySQL 8.0 naar Aurora Serverless v2
Upgrade van onderliggende component in de preview omgeving (SaaS-dev cluster).
Exposed API
BACKEND
Persoonsgevoelige Exposed API-filters (zoals rijksregisternummer- en naamfilters) voor het dossierlijst-endpoint kunnen voortaan via de request body in een POST-method worden meegestuurd in plaats van via queryparameters. Zo blijven ze uit toegangs-, proxy- en APM-logs. De bestaande GET-method blijft voorlopig beschikbaar voor backwards compatibility, maar is deprecated en kan later worden verwijderd.
Generic REST connector: API key via configureerbare header
BACKEND
De generic REST connector kan voortaan authenticeren met een statische API key. De header waarin de key wordt meegestuurd is configureerbaar, en de key zelf wordt opgehaald uit een applicatie-eigenschap in plaats van opgeslagen in de connectorconfiguratie.
Bijkomende applicatie eigenschappen:
-
skryv.connectors.rest.api.environments.{omgeving}.api-key -
skryv.connectors.rest.api.environments.{omgeving}.api-key-header
Niet-ondersteund masker deed formuliertaak crashen
BUGFIX
Een niet-ondersteund vooraf gedefinieerd masker veroorzaakt niet langer een crash in de frontoffice. Het veld valt nu terug op een gewoon tekstveld, net als in de backoffice.
Read-only keuzeveld met niet-bekende waarde deed formulier crashen
BUGFIX
Een read-only keuzeveld met een waarde buiten de geconfigureerde opties verstoort de formulierweergave niet langer. Backported naar versie 31.
NullPointerException bij taaktoewijzing
BUGFIX
Taaktoewijzing zonder rol in een autorisatie faalt niet langer zonder error. De eventgedreven toewijzing is nu null-safe en logt fouten zichtbaar, zodat ze niet pas via de 15-minutenfallback worden opgepikt.
Ongewenst gedrag bij mislukken van verwijderen attachment actie
BUGFIX
Bij bulkverwijdering worden mislukte verwijderingen niet langer als verwijderd gemarkeerd, zodat ze opnieuw kunnen worden geprobeerd. Er wordt een fout gelogd: S3 batch delete failed for key {errorKey}: {errorMessage}.
Upgrade naar Camunda 7.24.11
Upgrade van onze ingebouwde workflow engine Camunda 7 van versie 7.24.7 naar 7.24.11. Geen database migratie nodig.
Migraties
Migratie vanuit vorige LATEST (32.0.X)
Migratietopic 1: upgrade GovFlanders afhankelijkheden
Controleer eigen customisaties op zichtbare impact van deze wijzigingen.
"@govflanders/vl-ui-design-system-style": "3.5.7",
"@govflanders/vl-ui-design-system-vanilla": "24.5.0"
Visuele aanpassing aan de modal.
Migratie vanuit vorige NEXT
De vorige NEXT valt samen met de vorige LATEST. Zie migratie-info hierboven.
Migratie vanuit vorige LTS
Deze versie is niet aangeduid als LTS.
Studio updates
Onderstaand overzicht toont de Studio-functionaliteiten die zijn bijgewerkt in het kader van deze platformrelease.
|
Update |
Beschrijving |
|---|---|
|
Beslis welke formuliervelden indexeerbaar zijn en welke niet. Door velden bewust buiten de index te houden, verlaag je de load op Elasticsearch, wat de performantie van de applicatie ten goede komt. |
|
|
Via referentielijsten kan je een uitgebreide keuzelijst samenstellen en deze koppelen aan een tekstveld binnen een formulier. |
|
|
Specifieke types configuratiefouten worden opnieuw opgepikt en gesignaleerd |
Fout gedefinieerde link events (BPMN-workflows) en twee keuzeopties met dezelfde key (formulieren) worden opnieuw als configuratiefout opgepikt en gesignaleerd. |
|
Als configurator kan je nu instellen welke default visualisatie je wenst voor een kaart element in een formulier. Mogelijke opties zijn: straten, satelliet en GRB. |
|
|
Flexibel instelbaar maken van startcoördianten voor kaart element in formulieren |
Het mogelijk om op basis van computed expressions een startlocatie (lengtegraad en breedtegraad) dynamisch te configureren voor een kaart element in een formulier. |
|
Platform versie die binnen Studio aangeduid is voor de applicatie, wordt nu gevisualiseerd op het issues panel. |
|
|
Studio is nu uitgerust met een dark mode. |
|
|
Klik op de link om het overzicht te bekijken. |
Overzicht van de recent voorgestelde Studio updates. Klik hier voor meer uitgebreide info over alle Studio updates.
Patches
Onderstaand overzicht toont alle patches binnen deze versie.
|
Versie |
Beschrijving |
|---|---|
|
32.1.XX |