1005.17.38 Sammenlagt bruttoledighed for dagpengemodtagere (timeliness)

, ConverterBeskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning



STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

@Jens Andersen

@Knud de Place (STAR)

@Joel Järlesäter (Unlicensed)

@Jesper Brunholm

 

2023-2

2023-3

2024-3

1.0

KSS, Converter

Indgik i tilsagn:

  • til release 2023-3, bølge 1 og 3




Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.



Dato

Version

Hvem

Hvad er ændret?

Dato

Version

Hvem

Hvad er ændret?

05.11.2022

0.1

Knud de Place

Oprettelse

24.02.2023

0.1

Knud

Indsat “(timeliness)” i epic titlen af hensyn til genkendelighed. Opdateret “Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader” (overgang rettet til senest 2024-3, jf. udsendt roadmap)

07.03.2023

0.3

Jesper

Gennemskrevet, klar til tilsagn

20.04.2023

0.3

@Knud de Place (STAR)

Ønsket ekstern deltagelse i test indskrevet → indgå på ny i tilsagnsrunde (bølge 3 / 2022-3)

28.04.2023

0.5

@Knud de Place (STAR)

v0.5. Ikke andre ændringer

04.05.2023

1.0

Jesper Brunholm

Løftet til 1.0 da udvikling er gennemført



Interne links (indhold i links ikke relevant for eksterne)

key po fa ux sme eksterne snitflader interne snitflader status labels
Loading...
Refresh

https://starwiki.atlassian.net/browse/DS-10872

https://starwiki.atlassian.net/browse/DS-13067

https://starwiki.atlassian.net/browse/BI-2496



Indholdsfortegnelse




OBS svartider

OBS ift. svartider

Svartiderne forventes at være væsentlig dårligere ved brug af SOAP-versionerne af de gamle services end ved brug af de nye REST services - og svartiderne forventes at være væsentlig højere på SOAP-services end før omlægningen til REST. Det skyldes, at SOAP-versionerne internt kalder videre til de nye REST versioner.

STAR vil derfor gerne undgå, at holde SOAP-versionerne i live, med mindre det konkret efterspørges af de enkelte aftagere ifm. tilsagn til en given epic.

For en service med svartider i dag på fx 4-8 millisekunder (med 7-9 mio. kald pr. måned) forventes, at svartiden på SOAP-version vil være ca x 100.



Afgrænsning af epic

Afgrænsning

Afgrænsning

Som serviceaftager og STAR

vil jeg have løftet servicesnifladerne for læsning af oplysninger om sammenlagt bruttoledighed (for dagpengemodtagere) til REST som en del af STAR's moderniseringsprogram

for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi. 

Acceptkriterier







Nr.

Beskrivelse

Relevant for

US

1005.17.38.1

Som STAR vil jeg have flyttet forretningsområdet sammenlagt bruttoledighed til forretningsdomænet EksterneData inkl. at det lever op til de principper, der er fastsat

DFDG, BI

1005.17.38.2

Som serviceaftager og STAR vil jeg have udstillet oplysninger om sammenlagt bruttoledighed fra den SOAP-baserede PersonEngagementStatusService til ny REST snitflade (EksterneData.PersonStatusService) med samme forretningslogik og operationer som den eksisterende SOAP service

DFDG

1005.17.38.3

Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade 

DFDG



1005.17.38.4

Som STAR vil jeg have dataleverancer fra VOA / BI om sammenlagt bruttoledighed tilpasset til det nye forretningsdomæne

BI, DFDG



1005.17.38.5

Som STAR vil jeg have at dokumentation for både servicelag og frontend lever op til STAR's principper på releasetidspunktet

DFDG



1005.17.38.6

Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer 

DFDG, SF

 

1005.17.38.7

Hidtidige WSRM med advis om at der er opdaterede data dannes fortsat (WSRMMessageService (Version 10).GetWarningVersion4 (med WarningType id 55 om opdaterede kontaktforløbsdata))

DFDG

1005.17.38.8

Død kode i DFDG, i forbindelse med sammenlagt bruttoledighed, fjernes

DFDG

1005.17.38.9

Landssupporten/LSS er skiftet over til at brug den nye REST-service vedr. sammenlagt bruttoledighed i stedet for at udstille oplysningerne fra PersonEngagementStatusService.

DFDG

1005.17.38.10

Hidtidig e-mail med status på processering af bruttoledighedsdata dannes fortsat

DFDG, BI

Pakke SAMLED-1 Knuds liste - Beta roadmap DFDG



Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger



1005.17.38.2

1005.17.38.3

1005.17.38.7 





Som bruger af PersonEngagementStatusService skal jeg senest i 2024-3 skifte til REST snitfladen for at læse registreringer om sammenlagt bruttoledighed.

Aftagere bedes overveje at tage EksterneData.PersonStatusService i brug direkte i 2023-3, og melde tilbage på dette ifm. tilsagn.

X

X





Som ved alle gennemstillinger vil der være dårligere performance på PersonEngagementStatusService når den skal gennemstille til REST service.

KSS kan som hidtil abonnere på WSRM'er med advis om at der er opdaterede data dannes fortsat (WSRMMessageService (Version 10).GetWarningVersion4 (med WarningType id 55 om opdaterede kontaktforløbsdata))





X





KSS og a-kasse kan håndtere, at pegepinden til data om borger flyttes fra borgers gamle til borgers nye cpr nr. ved cpr.skift

X

X





A-kasser og jobcentre kan abonnere på (for tiden WSRM-beskeden) GetCprChanged, hvis der er behov for, at vide, hvornår DFDG flytter pegepinden til data om borger fra gammelt til nyt cpr nr.



Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

PersonEngagementStatusService (version 1).GetPersonEngagementStatus

Andet

Metode udgår senest i 2024-3. Brug i stedet den REST-baserede EksterneData.PersonStatusService.GetPersonStatus

KSS, Plannersystemer

BI

D+S

EksterneData.StatusService (version 1).GetPersonStatus

Ny

Metode oprettes med kollektion af oplysninger om sammenlangt bruttoledighed for dagpengemodtagere (beregnet af STAR)

KSS, Plannersystemer

BI

D+S

WSRMMessageService (Version 10).GetWarningVersion4 

Uændret

Der dannes som hidtil advis med WarningType id 55 om opdaterede kontaktforløbsdata.

KSS, Plannersystemer

N/A

D+S



Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Loading...
Refresh



Beskrivelse af epic

Baggrund

Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til PersonEngagmentStatusService og metoden læsning af oplysninger om sammenlagt bruttoledighed (for dagpengemodtagere) følgende:

  • I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer

Regler

Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.

Der er ikke regler der regulerer, at STAR beregner sammenlagt ledighed for dagpengemodtagere eller at KSS aftager disse data.


Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer

Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 2024-1) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.

Perioden kan dog ændres, hvis der efterfølgende kommer forretningsændringer til servicen. En sådan efterfølgende ændring af perioden, vil fremgå i epic med de nye forretningsændringer. Bemærk også infoboksen om svartider ovenfor.

Processering af data og udsendelse af WSRM’er lægges på samme tidspunkt, i de tidlige morgentimer, som hidtil.

AC 1005.17.38.1 - Som STAR vil jeg have flyttet forretningsområdet sammenlagt bruttoledighed til forretningsdomænet EksterneData inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

  • Etablering af database i EksterneData.

AC 1005.17.38.2 - Som serviceaftager og STAR vil jeg have udstillet oplysninger om sammenlagt bruttoledighed fra den SOAP-baserede PersonEngagementStatusService til ny REST snitflade (EksterneData.PersonStatusService) med samme forretningslogik og operationer som den eksisterende SOAP service

Der er tale om at følgende metoder i PersonEngagementStatusService omlægges til ny REST-service

  • GetPersonEngagementStatus

Løsningsmodel

  • Ny kollektion med oplysninger om sammenlagt bruttoledighed (for dagpengemodtagere) i REST statusservice i EksterneData.

  • Fejlkoder bevares

  • Der ændres ikke i adgangsforhold til service/metoder for jobcentersystemerne

Forretningsside for statusservice

EksterneData.PersonStatusService (2023-1)

Metoden GetPersonStatus oprettes med kollektion med oplysninger om sammenlagt bruttoledighed (for dagpengemodtagere)

Udviklingsversion: EksterneData.PersonStatusService [UDV] (Version 1, 2023-2)

Udviklet version:

Se udkast i link ovenfor

AC 1005.17.38.3 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade 

Løsningsmodel

  • Eksisterende SOAP-registreringsmetoder bevares 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-1.

Serviceaftager skal dog være forberedt på, at svartiden ved kald af SOAP-udgaverne forventes at være forringet, jf. Info-boks i top af epic-dokumentet. Af samme årsag beder vi om at aftagerne overvejer at tage den nye REST service i brug i 2023-3, og tager stilling til dette ifm. tilsagn

AC 1005.17.38.4 Som STAR vil jeg have dataleverancer fra VOA / BI om sammenlagt bruttoledighed tilpasset til det nye forretningsdomæne

Løsningsmodel (internt STAR acc.kr.)

  •  Tilpasning af BI load til EksterneData domænet (silo) med oplysninger fra STAR/VOA om sammenlagt bruttoledighed

AC 1005.17.38.5 Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet

Løsningsmodel (internt STAR acc.kr.)

  • QA af regler fra kode mod dokumenteret regler og fejlkode

  • Ajourfører dokumentation

Sider der skal rettes og QA er (liste er ikke udtømmende)

  • Servicesnitflade 

AC 1005.17.38.6 -Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer 

Løsningsmodel (internt STAR acc.kr.)

  • Tilpasning af regler af for pseudonymisering og aftale hvornår data skal med i dataløft (kun hvis er i dag sker dataløft til testmiljøer)

  • Systemforvalter til retter pseudonymiseringsflow 

AC 1005.17.38.7 - Hidtidige WSRM om med advis om at der er opdaterede data dannes fortsat (WSRMMessageService (Version 10).GetWarningVersion4)

Hidtidige WSRM om med advis om at der er opdaterede data dannes fortsat (WSRMMessageService (Version 10).GetWarningVersion4) indtil der i senere release omlægges til nye webservicebeskeder:

  • WSRMMessageService (Version 10).GetWarningVersion4 (med WarningType id 55 om opdaterede kontaktforløbsdata)

 

AC 1005.17.38.8 - Død kode i DFDG, i forbindelse med bruttoledighed, fjernes

Løsningsmodel (internt STAR acc.kr.)

  • Fjernelse af død kode i DFDG classic

 

AC 1005.17.38.9 - Landssupporten/LSS er skiftet over til at bruge EksterneData.PersonStatusService vedr. i sammenlagt bruttoledighed i stedet for at udstille oplysningerne fra PersonEngagementStatusService

Landssupporten/LSS er skiftet over til at brug den nye REST-service vedr. i sammenlagt bruttoledighed i stedet for at udstille oplysningerne fra PersonEngagementStatusService.

Løsningsmodel (internt STAR acc.kr.)

  • Landssupport/LSS er skiftet til at brug EksterneData.PersonStatusService ved brug af nyt ClientApi fra EksterneData.

  • Kode brugt i forbindelse med PersonEngagementStatusService ifm. visning af sammenlagt bruttoledighed er fjernet fra LSS

AC 1005.17.38.10 Hidtidig e-mail med status på processering af bruttoledighedsdata dannes fortsat

Vi udsender mailen dagligt, efter vores WSRM job er kørt, og sender følgende information:

  • Har vi modtaget bruttoledighedsevent efter seneste kørsel

  • Er bruttoledighedsdata lagt i databasen så de er tilgængelige for PersonStatus servicen

  • Antal udsendte WSRM'er og tidspunkt for seneste WSRM 

Fx: Bruttoledighedsstatus 2023-03-03

  • Bruttoledighedsdata modtaget: OK, seneste opdatering 2023-03-03 04:20:10

  • Bruttoledighedsdata tilgængelig: OK, seneste opdatering 2023-03-03 04:22:17

  • Bruttoledighedsdata WSRM'er udsendt: OK, 18.429 WSRM'er sendt, seneste WSRM 2023-03-03 06:18:43    

Eksempel ved ingen nye events: Bruttoledighedsstatus 2023-03-03

  • Bruttoledighedsdata modtaget: Ingen nye data modtaget

  • Bruttoledighedsdata tilgængelig: OK, seneste opdatering 2023-03-02 04:32:11

  • Bruttoledighedsdata WSRM'er udsendt: Ingen WSRM'er sendt    

 

Tjekliste modernisering DFDG:

  • DFDG

    • Services

      • Er pakken af service snittet jf. behov i DFDG, Jobnet, eksterne m.f.

      • Er der behov for at bevare SOAP snitfladen

      • Er dansk navngivning QA'et

      • Er der teknisk gæld eller andet der skal rettes op på (evt. spike til team/arkitekt for at identificerer)

    • Konvertering

      • Initielt load / konvertering og i hvilke siloer

    • WSRM'er

      • Skal eksisterende WSRM udsendes og hvor længe

      • Skal ny besked etableres nu eller senere

    • Kodelister, er disse flyttet til ejende domæne, er der lavet slavekodelister

    • Eventbroker

      • Er nye beskeder der skal etableres, QA af indehold og navngivning

      • Er det dokumenteret hvilke beskeder, der anvendes, og hvilke forretningsregler der er i den forbindelse

    • StatusService

      • Udfasning i PersonStatusService (PSS) 

      • Udvidelser til domænespecifikke statusservices

      • Udfasning i PersonHistoryService (PHS)

      • Udvidelse til domænespecifikke historik services

    • LSS (Landssupportsystem) og/eller Datakanon og herunder Registerudtræk (hvis STAR har dataejerskab)

    • Datamonitor. ny eller ændret overvågninger

    • Dokumentation

      • QA i forhold til at alle forretningsregler / fejlkode er tilstede

      • Dokumentation følger nye principper

  • Nye batchjobs / ændret behandling af events

    • Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon) 

  • Dataløft

    • Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.

  • Ændringer i forhold til aflevering at Rigsarkivet

  • GDPR sletninger m.v.

  • Interne afhængigheder indenitfiseret (Jobnet, VITAS, JobAG, BI integrationsplatform andre domæner m.v.)

  • Eksterne afhængigheder indenitfiseret (Kommunalt sagsbehandlingssystem, A-kasse sagsbehandlingssystem, Kommunalt bookingsystem (WorkForcePlanner (WFP), M4 Booking, Schultz Booking). Kommunalt ydelsessystem (KY), Kommunalt sygedagpengesystem (KSD), EG kommune informatiom m.fl.)

Særlige krav til test

Test scenarie

Ønsket ekstern deltagelse i test

Berørte systemområder (herunder nye batchjobs*) 

Identificeret af

Test scenarie

Ønsket ekstern deltagelse i test

Berørte systemområder (herunder nye batchjobs*) 

Identificeret af

KSS kan kalde statusservice og udlæse sammenlagt ledighed

  • REST udgave

  • SOAP-udgave

Det ønskes, at KSS deltager i test uanset, om REST snitflade tages i brug i 2023-3, herunder test af SOAP udgave hvis denne fortsat anvendes

PersonEngagementStatusService (version 1).GetPersonEngagementStatus

EksterneData.StatusService (version 1).GetPersonStatus

Knud

 

 

 

 

 

 

 

 

* Batchjobs

  • bør testes både med delta og fuldt load,

  • bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden

  • bør testes i samarbejde med teams som har afhængigheder

  • kørselstid, særligt hvis det er en del af NightlyBatch

Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse:

  • Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres:  

  • Skal der køres konvertering:  

  • Skal der køres databasescripts for opdatering af tabeller i databasen:  

BI foretager initial load af forsørgelseshistorik i ydelsesudstilling silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle forsørgelseshistorik på DFDG classic.

Efter idriftsættelse:

N/A

Arkitektur- og implementeringsnoter 

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

  • Nye dataområder: Nej, flytning til domæne Ydelsesudstilling 

  • Nye snitflader: Nej, flytning til domæne Ydelsesudstilling

  • Nye komponenter: Nej 

  • Nye miljøer: Nej 

  • Nye teknologier: Modernisering 

  • Nye aftagertyper: Nej 

  • Eller afvigelser fra principperne: Nej 

  • Eventuelle behov for reduktion af teknisk gæld skal afdækkes: N/A 



Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.

Husk GDPR stillingtagen

Ingen personfølsomme data i epics

Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.

 Ja, det er tjekket, at epic ikke indeholder dette.
  • Angiv hvem der har foretaget dette tjek: Knud

  • Angiv dato for tjek: 07.03.2023

Opbevaring af oplysninger i STARs it-systemer

Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.

Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.

Dette er ikke et nyt dataområde blot en flytning fra DFDG classic og til XXXXX

Hvem må tilgå oplysningerne?

Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.

Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.  

Korrekte sikkerhedsattributter på services

PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.

Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )



Alle borgere

Egne borgere

Tidligere egne borgere

Gæsteadgang

Anden Aktør - egne borgere

Anden Aktør - gæsteadgang



Alle borgere

Egne borgere

Tidligere egne borgere

Gæsteadgang

Anden Aktør - egne borgere

Anden Aktør - gæsteadgang

A-kasse



X









JobCenter



X





X



Kommune



X









STAR

X











AUB













UDK













STIL















A-kasse filtrering

Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin

A-kassen har ikke adgang til bruttoledighedsdata

Sagsbehandlerlogin på Jobnet - tag stilling til adgang!

En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.

En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.

Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.

Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin

Data udstilles ikke på Jobnet