Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
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? |
---|---|---|---|
14.10.2022 | 0.1 | Carsten Olsen | Oprettelse |
12.04.2024 | 0.1 | Carsten Olsen | Indhold udfyldt afventer evt. kontanthjælpsreform 2025 ændringer |
05.09.2024 | 0.1 | Knud de Place | Indhold udfyldt ud fra lovudkast, der har været i ekstern høring og dialog med 'Ydelser' i STAR |
Interne links (indhold i links ikke relevant for eksterne)
- DS-12131Getting issue details... STATUS
- BI-2470Getting issue details... STATUS
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | |||
---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for bevilling af ydelse fra KY 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.21.1 | Som STAR vil jeg have flyttet forretningsområdet afgørelse om ydelse fra KY til forretningsdomænet (silo) VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat | Kontaktforløb, BI | |
1005.17.21.2 | Som KY og STAR vil jeg have udstillet afgørelse om ydelse fra KY via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service, men forberedt på de forventede kontanthjælpsændringerne pr. 1. juli 2025 | Kontaktforløb | |
1005.17.21.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 | Kontaktforløb | |
1005.17.21.4 | Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) | BI | |
1005.17.21.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | Kontaktforløb | |
1005.17.21.6 | Som STAR vil jeg have, at data er omfattet af dataløft og psedonymisering mod testmiljøer | Kontaktforløb, SF | |
1005.17.21.7 | VisiteringOgStatus udstiller kodelisterne for afgørelse om ydelser fra KY | Kontaktforløb | |
1005.17.21.8 | /wiki/spaces/GI/pages/3690397697 udstiller ikke mere SocialAidCollection. I stedet returneres en tom list | Kontaktforløb | |
1005.17.21.9 | Som serviceaftager og STAR vil jeg have udsendt WSRM og WSB om afgørelser om ydelser | Kontaktforløb | |
1005.17.21.10 | Død kode i DFDG, i forbindelse med bevilling af ydelse fra KY, fjernes | Kontaktforløb | |
1005.17.21.11 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i VisiteringOgStatus, i stedet for UnemploymentRegistrationService fra DFDG classic | Kontaktforløb |
Pakke KY-1 DFDG roadmap
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.17.21.2 | 1005.17.21.8 | 1005.17.21.9 | |||
Som KY skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | ||||
Som KY skal jeg tage REST servicen i brug senest 1. juli 2025 | X | ||||
Som KY skal jeg skifte til ny KY-identifier, hvis der træffes afgørelse om ændring af satsniveau | X | KY/KOMBIT har tidligere oplyst at der skiftes KY-identifier i denne situation (og det er afgørende for indretningen af snitfladen mellem KY og DFDG) | |||
Som bruger af PersonStatusService (KSS) vil jeg skifte til REST snitflade og kald til VisiteringOgStatus.VisiteringOgStatusStatusService (Version 2 [UDV], 2024-2/3/4) for at hente oplysninger fra KY om afgørelser om ydelser. | X | ||||
Som KSS vil jeg overgå til ny WSB, men kan i en overgangsperiode fortsat anvende WSRM | 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 (KY kommunikerer i forvejen til DFDG på borgers aktuelle cpr nr, dvs. hvis oprindelig afgørelser er på gl. cpr.nr. på en KY-identifier, sendes opdateringer til afgørelsen fra KY til DFDG på aktuelle CPR-nr.) | 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 |
---|---|---|---|---|---|
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
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 oplysninger fra KY om afgørelser om ydelser følgende:
I DFDG et skift til REST snitflade - og i denne epic med samtidige forretningsmæssige ændringer foranlediget af forventede ændringer i kontanthjælpssystemet pr. 1.7.2025:
Udvidelse af snitfladen med yderligere oplysninger vedrørende afgørelser om afgørelser vedrørende kontanthjælp
Satsniveautype
§-henvisning
Disse oplysninger skal ikke indberettes for afgørelser om andre typer af ydelser (fx jobafklaringsydelse eller revalideringsydelse). HVIS KY ønsker også at indberette dette for øvrige ydelser skal de påtænkte nye kodelister udvides med flere udfaldsrum
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
KY indberetter afgørelser om ydelser, jf. databekendtgørelsen. Bestemmelserne vil blive opdateret således, at de også kan rumme de nye oplysninger om satsniveau og §-henvisning for de enkelte afgørelse.
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.
KY skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 1. juli 2025) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.
KSS skal ift. læsning af oplysninger i DFDG om afgørelser om kontanthjælp og de de nye oplysninger om satsniveau og §-henvisning for de enkelte afgørelse overgå til REST snitfladen senest 1. juli 2025.
1005.17.21.1 - Som STAR vil jeg have flyttet forretningsområdet afgørelse om ydelse fra KY til forretningsdomænet (silo) VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i VisiteringOgStatus
Udvidelse med oplysninger om Satsniveau og §-henvisning vedrørende afgørelser om kontanthjælp
Mapningark BI
1005.17.21.2 - Som serviceaftager og STAR vil jeg have udstillet afgørelse om ydelse fra KY via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service, men forberedt på de forventede kontanthjælpsændringerne pr. 1. juli 2025
Løsningsmodel
Ny REST service og getmetode i VisiteringOgStatus
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder, dog tillades ny systemadgang på Get-metoderne for jobcentre af hensyn til synkronisering ifm tilflytning af borgere
Der valideres ift. at de de oplysningstyper om satsniveau type og §-henvisning er udfyldt for afgørelser om kontanthjælp med startdato 1.7.2025 eller senere
VisiteringOgStatus.YdelsesVisiteringService (Version 1 [UDV], 2024-4)
Ny REST service til registrering og udstillings af bevilling af ydelse fra KY.
GetYdelse (GET /v1/ydelse)
Metoden henter informationer om en borgers sociale ydelser.
Erstatter GetSocialAid.
UpdateYdelse (PUT /v1/ydelse)
Metoden opretter eller opdaterer en social ydelse for en borger så korrekt kontaktgruppe og personkategori sættes i DFDG.
Erstatter SaveSocialAid
GetYdelse (GET /v1/ydelse/historik)
Metoden henter historiske sociale ydelse for en borger.
Erstatter GetSocialAidHistory
VisiteringOgStatus.VisiteringOgStatusStatusService (Version 2 [UDV], 2024-2/3/4)
Udvidelse af statusservice med ydelser.
Valideringer og lovlige kombinationer
Der valideres ift. at de de oplysningstyper om satsniveau type og §-henvisning er udfyldt for afgørelser om kontanthjælp med startdato 1.7.2025 eller senere
Tilladte kombinationer
§-henvisning Satstype | Id 1 – LAS § 16, stk. 1
| Id 2 – LAS § 16, stk. 2
|
Id 1 - Mindstesats
|
| X Arbejdspligt |
Id 2 - Grundsats
| X |
|
Id 3 - Forhøjet sats
| X |
|
Id 4 - Hjemmeboende sats
| X | X Arbejdspligt |
1005.17.21.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
Løsningsmodel
Eksisterende SOAP bevares som kalder mod ny getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2023-4.
UnemploymentRegistrationService
Version 3 og 4 Udgår til fordel forVisiteringOgStatus.YdelsesVisiteringService . Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-1, da der ikke forventes ændringer i den periode.
GetSocialAid
Udgår og erstattes af GetYdelse (GET /v1/ydelse)
SaveSocialAid
Udgår og erstattes af UpdateYdelse (PUT /v1/ydelse)
GetSocialAidHistory
Udgår og erstattes af GetYdelse (GET /v1/ydelse/historik)
CodeLists
AppropriationOutcomeTypeIdentifier
Udgår til fordel forVisiteringOgStatus.YdelsesAfgoerelsesTypeKodeliste. Kodelister bevares som SOAP snitflade i DFDG classic en overgangsperiode til og med 2025-2.
Endvidere 2 nye kodelister foranlediget af kontanthjælpsreform pr. 1.7.2025:
1005.17.21.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo)
Løsningsmodel (internt STAR acc.kr.)
Initial load af data / Tilpasning af BI load til visiteringOgStatus domænet (silo)
Data leverance til DOA tilpasses
1005.17.21.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 VisiteringOgStatus.YdelsesVisiteringService (2024-4)
Forretningsmæssige senarier mellem tilmelding/afmelding i DFDG og afgørelse om ydelse (fra KY)
1005.17.21.6 - Som STAR vil jeg have 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
Systemforvalter til retter pseudonymiseringsflow
1005.17.21.7 VisiteringOgStatus udstiller kodelisterne for afgørelse om ydelser fra KY
Løsningsmodel
DFDG udstille kodelister for VisiteringOgStatus
VisiteringOgStatus.YdelsesAfgoerelsesTypeKodeliste
Kodeliste flytte 1 til 1 fra AppropriationOutcomeTypeIdentifier
1005.17.1.8 /wiki/spaces/GI/pages/3690397697 udstiller ikke mere SocialAidCollection. I stedet returneres en tom liste
/wiki/spaces/GI/pages/3690397697
GetVariablePersonStatus
Udstiller ikke mere SocialAidCollection - Liste af kontanthjælpsbevillinger. I stedet returneres en tom liste
Erstattes af VisiteringOgStatus.VisiteringOgStatusStatusService (Version 2 [UDV], 2024-2/3/4).ydelser
1005.21.1.9 Som serviceaftager og STAR vil jeg have udsendt WSRM og WSB
Løsningsmodel
Eksisterende WSRM sendes via event og DFDG classic
Ny WSB etableres og sendes efter samme regler som WSRM
BevillingAfYdelse.WSB - AfgoerelseOmYdelse.WSB (Test: 2024-3, Prod 2024-4) [Skitse]
Ny WSB der erstatter WsrmMessageService (Version 11, 2024-2).GetAppropriationNotificationVersion5
For teknisk dokumentation se Eksternkommunikation Webservicebeskeddokumentation
For beskedtyper se EksternKommunikation.EntityTypeCodeList
Feltnavn m.v. | Beskrivelse | Indhold |
EntitetNavn | Navn på beskedtypen | AfgoerelseOmYdelse
|
EntitetId | Identifikation af beskedtype og Unik Id på tværs af alle miljøer | 1000xx |
Beskrivelse | Beskrivelse på beskedtypen | Der er registreret eller opdateret information om afgørelse om af ydelse fra KY, herunder start på og ophør af ydelse |
Startdato | Dato for hvornår beskeden kan modtages |
|
Slutdato | Dato for hvornår besked ikke mere sendes | N/A |
EksternIdentifier | Identifikation på den dataentitet beskeden vedrører | kyYdelsesIdentifier |
Version Identifier | Versionsidentifikation på den dataentitet beskeden vedrører | N/A - kun en samlet historik kan hentes |
IdentifikationstypeId | Reference til type hvad/hvem besked vedrører | Cpr nr (Id 1) |
Aendringstype | Aktion der kan have udløst besked (Create, Update og eller Delete) | Oprettelse (Id 1), Opdatering (Id 2) |
Bodyindhold | Hvis der er data i beskeden udover standard | Nej |
Erstatter WSRM | Hvilke(n) WSRM besked(er) webservicebeskeden erstatter helt eller delvis | WsrmMessageService (version 11)..GetAppropriationNotificationVersion5 |
Forretningsregler for afsendelse | Specifikke regler for afsendelse | Der dannes besked, når en ansøgning om ydelse registreres i KY og når der efterfølgende træffes afgørelse om ydelse og når ydelsen ophører |
Afsendelsesstrategi | Modtager af webservicebesked jvf. | Jobcenter - Egne borger - Nr 2 |
Hent af data | Hvor kan data hentes i DFDG | VisiteringOgStatus.YdelsesVisiteringService.GetYdelse (GET /v1/ydelse) VisiteringOgStatus.YdelsesVisiteringService. GetYdelse (GET /v1/ydelse/historik) VisiteringOgStatus.VisiteringOgStatusStatusService.GetPersonVisiteringOgStatusStatus (GET /v2/VisiteringOgStatusStatus) |
WsrmMessageService (version 11).GetAppropriationNotificationVersion5 - WsrmMessageService (Version 11, 2024-2)
WSRM-beskeden GetAppropriationNotificationVersion5 udgår til fordel for BevillingAfYdelse.WSB.
WSRM bevares som SOAP snitflade i DFDG classic en overgangsperiode til og med 2025-2.
1005.17.1.10 Død kode i DFDG, i forbindelse med oplysninger fra KY om afgørelse om ydelse, fjernes
Løsningsmodel (internt STAR acc.kr.)
Fjernelse af gammel og død kode i DFDG classic
Forventes at ske i senere release
1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen VisiteringOgStatus.YdelsesVisiteringService (Version 1 [UDV], 2024-4), i stedet for UnemploymentRegistrationService
Løsningsmodel (internt STAR acc.kr.)
Landssupport/LSS og Datakanon er skiftet til at brug VisiteringOgStatus.YdelsesVisiteringService (Version 1 [UDV], 2024-4)
Kode brugt i forbindelse med UnemploymentRegistrationService er fjernet fra LSS
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 | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
* 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:
Angiv dato for tjek:
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 | |
---|---|---|---|---|---|---|
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
XXXXX
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
XXXXX