1005.17.19 Asyl overgivelsesdata (2)
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
---|---|---|---|---|---|---|
@Knud de Place (STAR) @Jens Andersen | @Joel Järlesäter (Unlicensed) @Carsten Olsen | 2023-4 | 2023-4 | 2024-4 | 1.0 | Converter |
Indgik i tilsagn:
Release 2023-3, bølge 1
Release 2023-4, bølge 1
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 |
20.03.2023 | 0.3 | Joel Järlesäter | Klar til tilsagn |
13.09.2023 | 0.3 | Knud | Nyt internt ac-11 |
29.09.2023 | 1.0 | Knud de Place | v1.0 ift. eksterne - ikke andre ændringer |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-12130
https://starwiki.atlassian.net/browse/DS-13531
https://starwiki.atlassian.net/browse/DS-13528
https://starwiki.atlassian.net/browse/BI-2464
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 3 Afgrænsning af epic
- 4 Oversigt over berørte webservices
- 5 Beskrivelse af epic
- 5.1 Baggrund
- 5.2 Regler
- 5.3 Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
- 5.4 1005.17.19.1 - Som STAR vil jeg have flyttet forretningsområdet Asyl-overgivelsesdata til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat
- 5.5 1005.17.19.2 - Som STAR vil jeg have flyttet forretningsområdet Asyl-overgivelsesdata til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat
- 5.5.1.1 Løsningsmodel
- 5.5.2
- 5.6 1005.17.19.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
- 5.6.1.1 Løsningsmodel
- 5.6.2
- 5.6.3
- 5.7 1005.17.19.4 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til nye forretningsdomæne (silo)
- 5.8 1005.17.19.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.9 1005.17.19.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.10 1005.17.19.7 PersonStatusService (version 20) udstiller ikke mere CVInfo.Cv.AsylumTransitionInfo. I stedet returneres NULL
- 5.10.1 PersonStatusService (Version 20)
- 5.10.1.1 GetVariablePersonStatus
- 5.10.1 PersonStatusService (Version 20)
- 5.11 1005.17.1.8 Borgerindsats modtager kontaktgrupper, ved håndtering af event.
- 5.12 1005.17.1.9 Død kode i DFDG, i forbindelse med asyl-overgivelsesdata, fjernes
- 5.13 1005.17.1.10 Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Borgerindsats , i stedt for , i DFDG Classic.
- 5.14 Tjekliste modernisering DFDG:
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
Afgrænsning af epic
Afgrænsning | |||
---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for Asyl-overgivelsesdata 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.19.1 | Som STAR vil jeg have flyttet forretningsområdet Asyl-overgivelsesdata til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat | DFDG, BI | https://starwiki.atlassian.net/browse/DS-12220 https://starwiki.atlassian.net/browse/DS-12221 |
1005.17.19.2 | Som serviceaftager og STAR vil jeg have udstillet Asyl-overgivelsesdata via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service | DFDG, Jobnet, Vitas | https://starwiki.atlassian.net/browse/DS-12220 https://starwiki.atlassian.net/browse/DS-12221
|
1005.17.19.3 | Som serviceaftager vil jeg gerne beholde den/de eksisterende SOAP service(s) uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade.
| DFDG, Jobnet, Vitas | https://starwiki.atlassian.net/browse/DS-13529
|
1005.17.19.4 | Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til det nye forretningsdomæne (silo) | BI | |
1005.17.19.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | DFDG, Jobnet | |
1005.17.19.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | DFDG, SF | |
1005.17.19.7 | PersonStatusService (version 20) udstiller ikke mere CVInfo.Cv.AsylumTransitionInfo. I stedet returneres NULL | DFDG | Er der behov for dette? |
1005.17.19.8 | Borgerindsats modtager kontaktgrupper ved håndtering af event. | DFDG | |
1005.17.19.9 | Død kode i DFDG, i forbindelse med Asyl-overgivelsesdata, fjernes | DFDG | https://starwiki.atlassian.net/browse/DS-13530
|
1005.17.19.10 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Borgerindsats Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | GetAsylOvergivelse (GET /v1/Asylovergivelse), i stedet for https://starwiki.atlassian.net/wiki/spaces/GI/pages/3949298693, i DFDG Classic. | DFDG | |
1005.17.19.11 | Som STAR og ekstern aftager ønsker jeg services og metoder dekoreret med scopes | DFDG |
Pakke ASYL-2 i Knuds liste - Beta roadmap DFDG
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.17.19.2 | 1005.17.19.3 | 1005.17.19.8 | |||
Som KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen. Det kan ske fra release 2023-4, men skal senest ske release 2024-4 | X | X | |||
Som bruger af PersonStatusService vil jeg skifte til REST snitflade og kald til Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | GetAsylOvergivelse (GET /v1/Asylovergivelse) for at hente asyl-overgivelsesdata. Det kan ske fra release 2023-4, men skal senest ske release 2024-4 | X | Er det OK for KSS, at ny snitflade skal tages i brug i (forventeligt) 2023-4 ? | |||
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 |
---|---|---|---|---|---|
Borgerindsats.AsylovergivelseService (version 1).CreateAsylOvergivelse | Ny | Ny REST-metode til oprettelse af asyl overgivelsesdata. | KSS |
| D+S |
Borgerindsats.AsylovergivelseService (version 1).GetAsylOvergivelse | Ny | Ny REST-metode til hente asyl overgivelsesdata. | KSS | Jobnet(t.o.) | D+S |
Borgerindsats.AsylovergivelseService (version 1).UpdateAsylOvergivelse | Ny | Ny REST-metode til opdatering af asyl overgivelsesdata. | KSS |
| D+S |
Andet | Udgår senest i 2024-4. Brug metode på nye REST-service: Borgerindsats.AsylovergivelseService (version 1).CreateAsylOvergivelse | KSS |
| D+S | |
Andet | Udgår senest i 2024-4. Brug metode på nye REST-service: Borgerindsats.AsylovergivelseService (version 1).UpdateAsylOvergivelse | KSS |
| D+S | |
PersonStatusService (version 20).GetVariablePersonStatus - Elementet Cv.CvInfo.AsylumTransition | Andet | Elementet udgår i 2024-4. Brug i stedet metode på ny REST-service | KSS | Jobnet(t.o.) | D+S |
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 asyl-overgivelsesdata følgende:
I DFDG et skift til REST snitflade - og i denne epic med få samtidige forretningsmæssige ændringer, idet brugen af CV-numre udgår og CvEditEnddate udgår i registreringen af Asyl-overgivelse til kommunen.
I Jobnet en overgang til ny REST snitflade samt ny frontend arkitektur (denne opgave er ikke en del af denne epic, men vil blive specificeret i en efterfølgende epic)
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Dataområdet er omfattet af kapitel 47 i databekendtgørelsen, jf. senest bkg. nr. 257 af 8. marts 2023.
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.
HVIS DET ER NØDVENDIGT: Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 2024-4) forblive på eksisterende SOAP service ift. registrering af overtagelsedato 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.
1005.17.19.1 - Som STAR vil jeg have flyttet forretningsområdet Asyl-overgivelsesdata til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i Borgerindsats
1005.17.19.2 - Som STAR vil jeg have flyttet forretningsområdet Asyl-overgivelsesdata til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat
Løsningsmodel
Ny REST service i Borgerindsats
Fejlkoder bevares fsva. valideringer, der bevares.
CvEditEnddate udgår i registreringen af Asyl-overgivelse til kommunen (pga. tidligere indført ændret dataflow ved indlæsning af cv-oplysninger fra LetAsyl, jf. E 951.26 CV-hængepartier (ift. LetAsyl import vs CvCore - og CV-søgning ift. mindre intensiv indsats) (2022-3) og 951.29 CV-hængepartier (ift. LetAsyl import vs CvCore) (2022-4)).
Afledt af dette udgår en række valideringer med tilhørende fejlkoder
Der ændres ikke i adgangsforhold til service/metoder.
https://starwiki.atlassian.net/wiki/spaces/GI/pages/3935273020
Ny REST service til registrering af af Asyl-overgivelsesdata.
Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | CreateAsylOvergivelse (POST /v1/Asylovergivelse)
Ny metode til at registrere/oprette Asyl-overgivelsesdata.
Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | UpdateAsylOvergivelse (PUT /v1/Asylovergivelse)
Ny metode til at opdatere Asyl-overgivelsesdata.
Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | GetAsylOvergivelse (GET /v1/Asylovergivelse)
Ny metode til at hente Asyl-overgivelsesdata.
1005.17.19.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
HVIS DET ER NØDVENDIGT: Eksisterende SOAP bevares som kalder mod ny get- create-, og update-metode, 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-4.
https://starwiki.atlassian.net/wiki/spaces/GI/pages/3949298693
https://starwiki.atlassian.net/wiki/spaces/GI/pages/3949298693#GetVariablePersonStatus
PersonStatusService.GetVariablePersonStatus udstiller elementet Cv.CvInfo.AsylumTransitionInfo til og med 2024-4.
https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4098228994
CvService stiller igennem metoderne CreateAsylumTransition og UpdateAsylumTransition videre til ny REST-service i Borgerindsats til og med 2024-4.
1005.17.19.4 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til nye forretningsdomæne (silo)
Løsningsmodel (internt STAR acc.kr.)
Initial load af data / Tilpasning af BI load til borgerindsats domænet (silo)
Data kommer fra VOA
1005.17.19.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
1005.17.19.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 tilretter pseudonymiseringsflow
1005.17.19.7 PersonStatusService (version 20) udstiller ikke mere CVInfo.Cv.AsylumTransitionInfo. I stedet returneres NULL
PersonStatusService (Version 20)
GetVariablePersonStatus
Udstiller ikke mere CVInfo.Cv.AsylumTransitionInfo. I stedet returneres NULL.
1005.17.1.8 Borgerindsats modtager kontaktgrupper, ved håndtering af event.
Løsningsmodel (internt STAR acc.kr.)
Borgerindsats modtager kontaktgruppedata via ny event receiver
1005.17.1.9 Død kode i DFDG, i forbindelse med asyl-overgivelsesdata, fjernes
Løsningsmodel (internt STAR acc.kr.)
Fjernelse af gammel og død kode i DFDG classic
1005.17.1.10 Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Borgerindsats Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | GetAsylOvergivelse (GET /v1/Asylovergivelse), i stedt for https://starwiki.atlassian.net/wiki/spaces/GI/pages/3949298693, i DFDG Classic.
Løsningsmodel (internt STAR acc.kr.)
Landssupport/LSS er skiftet til at brug Borgerindsats.AsylovergivelseService (Version 1 [UDV] 2023-4) | GetAsylOvergivelse (GET /v1/Asylovergivelse) ved brug af nyt ClientApi fra Borgerindsats.
Kode brugt i forbindelse med Cv.CvInfo.AsylumTransitionInfo 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 asyl-overfivelsesdata i Borgerindsats silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle asyl-overfivelsesdata 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 Borgerindsats
Nye snitflader: Nej, flytning til domæne Borgerindsats
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.
Angiv hvem der har foretaget dette tjek: Knud
Angiv dato for tjek: 20.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 Borgerindsats.
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