1005.17.81 Udstilling af DFDG kodelister - kodelister fra de nye forretningsdomæner
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-1 | 2024-1 | 2024-1 | 1.0 | KSS, A-kasser, Plannersystemer, KSD, KY, Andre aftagere |
Indgår i tilsagn
2024-1, bølge 3
2024-1, bølge 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? |
---|---|---|---|
16.10.2023 | 0.1 | Carsten Olsen | Oprettelse |
13.11.2023 | 0.3 | Carsten Olsen | Klar til STAR QA |
13.11.2023 | 0.3 | Knud de Place | Klar til tilsagn |
18.12.2023 | 0.5 | Knud de Place | Ændring: slavekodelisterne kan fra 2024-1 kun hentes i Komposit domænet |
02.01.2023 | 0.5 | Knud | v0.5. I afsnittet “Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer“ er indsat oversigt (filer vedlagt) med de slavekodelister, der fremover udstilles via Komposit domænet. |
02.02.2024 | 1.0 | Knud | v1.0 fra reelt 13.01.2024, men Confluence epic version blev ikke opdateret den dag |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/PLAN-1784
https://starwiki.atlassian.net/browse/BI-3518
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.81.1 - Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) kun udstiller de kodelister som det pågældende domæne er dataejer for
- 5.5 1005.17.81.2 - Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) ikke udstiller “slavekodelister” dvs. kodelister det pågældende domæne ikke er dataejer for
- 5.5.1 Løsningsmodel
- 5.5.2 Kodelistservice for:
- 5.5.3 Komposit.CodeListsService -
- 5.5.4 Kompostiv.CodeLists -
- 5.5.5 DFDG (classic) CodeListService (version 5) -
- 5.6 1005.17.81.3 - Som STAR vil jeg have, at alle DFDG kodelister udstilles samlet fra komposit domænet ((fra de nye forretningsdomæner, men ikke det gamle DFDG classic)) for at lette serviceaftagernes anvendelse af kodeliste uafhængigt af STAR domæne arkitektur
- 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 konsolideret udstillingen af servicesnifladerne for kodelister i de enkelte forretningsdomæner samt have udstillet en samlet kodeliste 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 - og så aftagerne ikke behøver forholde sig til hvilke forretningsdomæner, der udstiller de enkelte kodelister. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.17.81.1 | Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) kun udstiller de kodelister som det pågældende domæne er dataejer for | DFDG | |
1005.17.81.2 | Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) ikke udstiller “slavekodelister” dvs. kodelister det pågældende domæne ikke er dataejer for | DFDG | |
1005.17.81.3 | Som STAR vil jeg have, at alle DFDG kodelister udstilles samlet fra komposit domænet (fra de nye forretningsdomæner, men ikke det gamle DFDG classic) for at lette serviceaftagernes anvendelse af kodeliste uafhængigt af STAR domæne arkitektur | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.17.81.1 | 1005.17.81.2 | 1005.17.81.3 | |||
Som KSS, a-kasse m.v. skal jeg overgå til modellen hvor et domæne kun udstiller de kodelister de er dataejer for eller den fælles kodeliste i Komposit domænet | X | X | |||
Som KSS, a-kasse m.v. skal jeg udfase de steder hvor jeg henter slavekodelister fra et domæne | X | ||||
Som KSS, a-kasse m.v. skal jeg beholde DFDG classic CodelistService (version 5) for de forretningsområder, der endnu ikke er flyttet til de nye domæner og hvor jeg derfor anvender SOAP service |
|
| X |
|
|
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.
Bemærk varsling indeholder kun de kodelister der allerede er flyttet til STAR nye forretningsdomæner. dvs.
Kodelister der allerede er flyttet er tidligere varslet i forbindelse med den specifikke epic hvor kodelisten var berørt, kun selve komposit kodeliste service og metoden er med i denne ekstra “varsling”.
Kodelister der flyttes senere varsles i forbindelse med den pågældende epic, helt som normalt, disse er derfor ikke med i denne ekstra “varsling”
Kodelister der er flyttet fra https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871medtages ikke denne “varsling”, da disse er tidligere varslet i forbindelse med den specifikke epic hvor kodelisten var berørt
(kopiér og indsæt manuelt i tabellen)
Summary | Varslingstype | Eksterne Snitflader | Interne Snitflader | Projekt | Varslingsnote |
---|---|---|---|---|---|
Komposit.CodeListsService.GetCodeList (GET /v1/CodeLists/{name}) | Ny | A-kasse, Andre, KSS, Plannersystemer | BI |
| Ny metode til at hente et værdisæt for en kodeliste på tværs af hele DFDG (Ikke DFDG classic) |
Ny | A-kasse, Andre, KSS, Plannersystemer | BI |
| Ny metode til at hente alle værdisæt for alle kodeliste på tværs af hele DFDG (Ikke DFDG classic) | |
Komposit.CodeListsService.GetErrorCodeList (GET /v1/CodeLists/ErrorCodeList) | Ny | A-kasse, Andre, KSS, Plannersystemer | N/A |
| Ny metode til at hente fejlkode på tværs af hele DFDG (Ikke DFDG classic) |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Rigtige link indsættes
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.
På baggrund af input fra eksterne aftagere om at det er besværligt at skulle forholde sig til, hvilke forretningsdomæner, der udstiller forskellige kodelister, samt bekymring for, om slavekodelister altid holdes synkront opdateret, foretages følgende, der samtidig indgår i som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram:
Udstillingen af servicesnifladerne for kodelister i de enkelte domæner konsolideres
En samlet kodeliste for de moderniserede DFDG forretningsområder udstilles fra Komposit domænet
DFDG (classic) kodelisterne udstilles som hidtil i CodeListService (version 5) - SOAP
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 til at hente kodelister.
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.
For at sikre at serviceaftagere og DFDG har et ensartet mønster for at aftage kodelister fra STAR nye forretningsdomæner opdateres dette mønster og udvides for at lette serviceaftageres tilgang til kodelister uanset om disse er normale kodelister eller dynamiske kodelister.
Med:
Almindelige kodelister menes de kodelister, der er statiske mellem releases og hvis indholdsændringer også varsles i forbindelse med release
Dynamiske kodelister menes kodelister, hvis indhold DFDG typiske ikke ejer og som kommer fra tredjepart, hvor DFDG ingen kontrol har over indholdsændringer. Denne type kodelister er normalt ikke koblet til forretningslogik i DFDG eller sagssystemer. Der er bl.a. tale om
kodelister for forsørgelseshistorik
subjobcentre (som jobcentrene bestiller / ændrer løbende)
a-kasseafdelinger (som a-kasserne bestiller / ændrer løbende)
uddannelsesinstitutionsnumre (fra STIL)
Efter serviceaftageres ønske etableres der et samlet sted, hvor alle kodelister kan hentes således, at serviceaftager ikke behøver at forholde sigt til STAR opdeling af DFDG i forretningsdomæner.
Alle aftagere af kodelister
Aftager af kodelister skal overgå til at hente kodelister i hvert domæne for de kodelister, hvor de moderniserede forretningsdomæner er dataejer, eller til at hente fra den fælles udstilling af kodelister i Komposit domænet. Dette gælde både for normale kodelister og dynamiske kodelister
Alle aftagere af kodelister skal udfase de steder, hvor aftager måtte hente slavekodelister fra et domæne
Kodelister fra DFDG (classic) hentes fortsat i CodeListService (version 5), indtil disse kodelister udgår eller omlægges til de moderniserede forrretningsdomæner
Der er tale om at følgende slavekodelister fremover udstilles fra Komposit domænet - og ikke længere fra de enkelte forretningsdomæner:
Excel:
JSON:
1005.17.81.1 - Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) kun udstiller de kodelister som det pågældende domæne er dataejer for
Løsningsmodel
Eksisterende løsning røres ikke datamæssigt for de kodelister, der er flyttet, og kodelister der endnu er flyttet berøres heller ikke, da de flyttes i forbindelse de enkelte forretningsepics i 1005.17.x serien.
Udstiller pr. domæne alene kodelister og kodelisteværdier, som er direkte tilknyttet det pågældende domænes forretningsdata og som domænet er dataejer for.
Kodelistservice for moderniserede forretningsdomæner
Udstiller pr. domæne alene kodelister og kodelisteværdier som er direkte tilknyttet det pågældende domænes forretningsdata og som domænet er dataejer for.
Komposit.CodeListsService - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4199186445
Se 1005.17.81.3.
Komposit.CodeLists - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3892445301
Se 1005.17.81.3.
DFDG (classic) CodeListService (version 5) - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871
Se 1005.17.81.3.
1005.17.81.2 - Som STAR vil jeg have at hver enkelt forretningsdomæne (silo) ikke udstiller “slavekodelister” dvs. kodelister det pågældende domæne ikke er dataejer for
Løsningsmodel
Eksisterende løsning røres ikke datamæssigt for de kodelister, der er flyttet, og kodelister, der endnu er flyttet, berøres heller ikke, da de flyttes i forbindelse de enkelte forretningsepics i 1005.17.x serien.
Slavekodelister, dvs. kodelister og tilhørende kodelisteværdier som et andet domæne er dataejer for, udstilles ikke mere i andre domæner.
I forbindelse med releasen 2023-4, hvor DFDG etablerede de nye domæners kodelister som Nugetpakker således, at det er 100% sikkert, at de kodelister, der anvendes på tværs af domæner, er ens, havde det sideeffekt for serviceaftagere, at de ikke kunne hente kodelister, der var slavekodelister fra et domæne
Kodelistservice for:
udstiller fremover ikke slavekodelister, dvs. kodelister og tilhørende kodelisteværdier som et andet domænes er dataejer for.
Komposit.CodeListsService - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4199186445
Se 1005.17.81.3.
Kompostiv.CodeLists - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3892445301
Se 1005.17.81.3.
DFDG (classic) CodeListService (version 5) - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871
Se 1005.17.81.3.
1005.17.81.3 - Som STAR vil jeg have, at alle DFDG kodelister udstilles samlet fra komposit domænet ((fra de nye forretningsdomæner, men ikke det gamle DFDG classic)) for at lette serviceaftagernes anvendelse af kodeliste uafhængigt af STAR domæne arkitektur
Komposit.CodeListsService - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4199186445
Udstiller alle kodelistemetoder med alt indhold på tværs af hele DFDG (de moderniserede forretningsdomæner).
GetCodeList (GET /v1/CodeLists/{name})
Henter en specifik kodelistes værdisæt.
GetCodeLists (GET /v1/CodeLists)
Henter en specifik alle kodelisters værdisæt.
GetErrorCodeList (GET /v1/CodeLists/ErrorCodeList)
Henter alle Fejlkoder.
Komposit.CodeLists - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3892445301
Udstiller de mere teknisk og fælles kodelister der ikke forretningsmæssigt er ejet af et specifikt domæne f.eks. https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4137877833
DFDG (classic) CodeListService (version 5) -https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871
https://starwiki.atlassian.net/wiki/spaces/FYS/pages/48889954 berøres ikke i denne epic. Flyttes i forbindelse de enkelte forretningsepics i 1005.17.x serien.
Funktionen af https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871overtages på sigt af https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3892445301 og når alle kodelister er flyttet vil https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871. Dette vil blive varslet på senere tidspunkt når hele DFDG classic lukke en gang i 2025.
VITAS.CodeLists - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/1436254364
Berøres ikke i denne epic flyttes i forbindelse de enkelte forretningsepic for Vitas.
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.
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 |
|
| |||
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
N/A
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
N/A