1005.17.31 De øvrige asyldata
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 | @Carsten Olsen | 2024-4 | 2024-4 | 2025-2 | 1.0 | KSS Converter |
Indgik i tilsagn:
2024-4, bølge 2
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 |
16-02-2024 | 0.1 | Carsten Olsen | Release flytte til 2024-3 |
25-07-2024 | 0.3 | Carsten Olsen | Version 0.3 (ikke STAR godkendt pga sommerferie) og ny release 2024-4) |
26.07.2024 | 0.3 | Knud de Place | V0.3 |
29.07.2024 | 0.3 | Carsten Olsen | STAR Release seneste ibrugtagning er flytte fra 2025-1 til 2025-2
|
30.08.2024 | 0.3 | Knud de Place | Varslingstyper er opdateret under "Manuel oversigt som er synlig for eksterne" på baggrund af kommentar fra tilsagnsgiver. |
02.09.2024 | 0.3 | Knud de Place | “Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader” opdateret med beskrivelse af hvordan CPR-skift håndteres i LetAsyl - og hvad det betyder for KSS kald af LetAsyl via DFDG. |
06.09.2024 | 0.3 | Knud de Place | Internt (Jira link - kun tilgængeligt for interne) |
03.10.2024 | 0.5 | Knud de Place | v0.5 - udvikling i gang. Ikke andre ændringer |
09.10.2024 | 0.5 | Carsten Olsen | v0.5 - Fejlkoder nummer ændres, da der er overlap med fejlkoderne for kontrakt efter intergrationsloven. betydningen og hvornår fejlene kastes er den samme. Vi er klar over dette er i modstrid men vores normale principper, men i denne situation, er dette det mest oplagte kompromis. |
16.10.2024 | 0.5 | Knud de Place | Opdateret “Oversigt over berørte services” til rette navngivning af udviklet snitflade. Konsekvensændret under AC-1 og AC-2. Opdateret tabeloversigt i toppen af epic så det nu fremgår, at ibrugtagning kan ske 2024-4 (mod tidligere 2024-4 / 2025-1). |
21.10.2024 | 1.0 | Knud de Place | 1.0. Ikke andre ændringer |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/PLAN-383
https://starwiki.atlassian.net/browse/PLAN-5562
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 AC 1005.17.31.1 - Som serviceaftager og STAR vil jeg have udstillet de øvrige asyldata inkl. bilag via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
- 5.5 AC 1005.17.31.2 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
- 5.5.1.1 Løsningsmodel
- 5.5.2 AsylumService
- 5.6 AC 1005.17.31.3 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 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 øvrige asyldate og bilag 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.31.1 | Som serviceaftager og STAR vil jeg have udstillet de øvrige asyldata inkl bilag via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service | Plan |
|
1005.17.31.2 | Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade | Plan |
|
1005.17.31.3 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | Plan |
|
Pakke ASYL-1 DFDG roadmap
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
| 1005.17.31.1 | 1005.17.31.2 |
|
|
|
Som KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X |
|
|
|
LetAsyl er et eksternt system og der er derfor ingen kobling med DFDGs normale håndtering af, at borger flyttes fra borgers gamle til borgers nye cpr nr. og LetAsyls håndtering af cpr. nr. skift. 02.09.2024: Normalt vil LetAsyl returnere data, når der kaldes med borgers aktuelle cpr.nr. | X |
|
|
| 02.09.2024: I LetAsyl er asylmodtageren kun identificeret ved 1 CPR-nummer af gangen. Hver nat opdateres CPR-numre i LetAsyl fra Udlændingestyrelsens systemer. Dvs. at hvis en asylmodtager skifter fra CPR-nr. A til CPR-nr. B, så vil man på den pågældende dag, hvor skiftet bliver registreret hos US, opleve at LetAsyl kun svarer med data på CPR-nr. A, men melder at CPR-nummer B er ukendt. Den følgende dag og frem er det så omvendt således, at CPR-nr. A meldes som ukendt, mens CPR-nummer B returnerer data. Dvs. LetAsyl returnerer (med ca. 1 dags forsinkelse ift. tidspunkt for registrering af cpr-skift i US' systemer) oplysninger, når der kaldes med borgers aktuelle cpr.nr. - og ikke hvis der kaldes med borgers tidligere 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 |
---|---|---|---|---|---|
AsylumService (Version 1).GetAsylumAttachment | Ny Udgået / | Erstattes af EksterneData.AsylumService (Version 1).GetAsylDataBilag (GET /v1/AsylDataBilag). Bevares i en overgangsperiode. Bemærk denne service er en proxy til Letasyl. | KSS | N/A | Plan |
AsylumService (Version 1).GetAsylumData | Ny Udgået | Erstattes af EksterneData.AsylumService (Version 1).GetAsylData (GET /v1/AsylData). Bevares i en overgangsperiode. Bemærk denne service er en proxy til Letasyl. | KSS | N/A | Plan |
EksterneData.AsylDataService (Version 1).GetAsylDataAttachment (GET /v1/AsylDataBilag) | Ny | Ny REST metode, der erstatter AsylumService (Version 1).GetAsylumData | KSS | N/A | Plan |
EksterneData.AsylDataService (Version 1).GetAsylData (GET /v1/AsylData) | Udgået Ny | Ny REST metode, der erstatter AsylumService (Version 1).GetAsylumAttachment | KSS | N/A | Plan |
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 forsørgelseshistorik følgende:
I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer
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.
Det er ingen indberetningsregler i denne epic, da der alene er tale om GET metoder.
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 2025-2) 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.
AC 1005.17.31.1 - Som serviceaftager og STAR vil jeg have udstillet de øvrige asyldata inkl. bilag via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
Løsningsmodel
Da der tale om service er en proxy mod det eksterne system Letasyl er der
ingen data gemt i DFDG og derfor heller ingen flytning af database eller data fra DFDG classic (og DFDG kan derfor heller ikke returnere data til KSS, hvis ikke KSS kalder med det CPR-nr som borger kendes med i LetAsyl)
ingen opgaver i forbindelse med scrampling af data til testmiljø
interne STAR dataleverancer til DOA m.v.
interne events mellem domæner
død kode der skal fjernes i DFDG classic
ingen LSS understøttelse
Ny REST service og getmetode i EksterneData.AsyldataService (2024-4)
Fejlkoder bevares IKKE, da disse allerede anvendes i forbindelse med kontrakten efter integrationslov, Betydningen og hvornår fejlkoderne kastes ændres ikke
Der ændres ikke i adgangsforhold til service/metoder
EksterneData.AsyldataService (2024-4)
Ny REST service til udstilling af de øvrige aysldata inkl. dokumenter.
GetAsylData (GET /v1/AsylData)
Metode til at hent øvrige asyldata
Erstatter AsylumService.GetAsylumData
GetAsylDataAttachment (GET /v1/AsylDataBilag)
Metode til at hente dokumenter koblet til øvrige asyldata
Erstatter AsylumService.GetAsylumAttachment
AC 1005.17.31.2 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
Løsningsmodel
Eksisterende SOAP i DFDG classic i en overgangsperiode frem til og med 2025-2.
Bemærk der er tale om en SOAP-REST konverter, da AsyldataService en en ren proxy service der kalder videre til LetAsyl
AsylumService
Udgår til fordel for EksterneData.AsyldataService (2024-4).
Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-2, da der ikke forventes ændringer i den periode.
Udfases til fordel for GetAsylData (GET /v1/AsylData)
Udfases til fordel for GetAsylDataBilag (GET /v1/AsylDataAttachment)
AC 1005.17.31.3 - 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
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
Adgang til LetAsyl og dermed testdata. PS der findes en model, denne skal graves frem | ||
* 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.
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 |
| |||||
JobCenter | X | X | ||||
Kommune | X | |||||
STAR |
| |||||
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