1005.17.1 Forsørgelseshistorik
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? |
---|---|---|---|
01-08-2022 | 0.1 | Carsten Olsen | Oprettelse |
23-09-2022 | 0.5 | Knud | v0.5 - klar til udvikling |
17-11-2022 | 1.0 | Jesper | v 1.0 Udvikling afsluttet |
06.11.2023 | 1.0 | Knud | SOAP-versionen fjernesi 2024-1 , dvs, en release senere end i aktuel version af roadmap. |
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | |||
---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for forsørgelseshistorik 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.1.1 | Som STAR vil jeg have flyttet forretningsområdet forsørgelseshistorik til forretningsdomænet (silo) Ydelsesudstilling inkl. at det lever op til de principper, der er fastsat | DFDG, BI | |
1005.17.1.2 | Som serviceaftager og STAR vil jeg have udstillet forsørgelseshistorikken via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service | DFDG, Jobnet, Vitas | - DS-10020Getting issue details... STATUS |
1005.17.1.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, Jobnet, Vitas | - DS-10039Getting issue details... STATUS |
1005.17.1.4 | Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til det nye forretningsdomæne (silo) | BI | - BI-2275Getting issue details... STATUS |
1005.17.1.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | DFDG, Jobnet | N/A |
1005.17.1.6 | Som STAR vil jeg have, at data er omfattet af dataløft og annonysering mod testmiljøer | DFDG, SF | N/A |
1005.17.1.7 | Ydelsesudstilling udstiller kodelisterne ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList i Ydelsesudstilling.CodeListService | DFDG | - DS-10020Getting issue details... STATUS |
1005.17.1.8 | /wiki/spaces/GI/pages/3690397697 udstiller ikke mere SustenanceClassificationInfo. I stedet returneres en tom liste og SustenanceHistoryClassificationTypeIdentifier udstilles ikke mere i DFDG CodeListService | DFDG | - DS-10038Getting issue details... STATUS |
1005.17.1.9 | ExternalData.Person i Ydelsesudstilling er moderniseret for at forbedre og sikre revisionssporet. | DFDG | - DS-9828Getting issue details... STATUS |
1005.17.1.10 | Ydelsesudstilling modtager persondata ved håndtering af BorgerstamdataOpdateretEvent. | DFDG |
-
DS-9828Getting issue details...
STATUS
- DS-10024Getting issue details... STATUS |
1005.17.1.11 | Død kode i DFDG, i forbindelse med forsørgelseshistorik, fjernes | DFDG | |
1005.17.1.12 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Ydelsesudstilling, i stedt for /wiki/spaces/GI/pages/1884555304 | DFDG | - DS-10082Getting issue details... STATUS |
Pakke FORSHIST-1 i Knuds liste - Beta roadmap DFDG
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.17.1.2 | 1005.17.1.3 | 1005.17.1.8 | 1005.17.1.7 | ||
Som KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | |||
Som bruger af PersonStatusService vil jeg skifte til REST snitflade og kald til Ydelsesudstilling for at hente forsørgelseshistorik. | X | ||||
Som serviceaftager på ny REST snitflade skal man være opmærksom på at kodelisterne (ligesom i SustenanceHistoryService) ikke er statisk i traditionel DFDG forstand | X |
Bemærk at tilsagn til ændringerne i denne epic er håndteret i epic 961.11
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.
(Ingen ændringer som ikke er varslede i epic 961.11)
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 2023-4) 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.
Acc.kr. 1005.17.1.1 - Som STAR vil jeg have flytte forretningsområde forsørgelseshistorik til forretningsdomænet (silo) Ydelsesudstilling inkl. at det lever op til de principper der er fastsat
Løsningsmodel (internt STAR acc.kr.)
- Etablering af database i Ydelsesudstilling
Acc.kr. 1005.17.1.2 - Som serviceaftager og STAR vil jeg have udstillet forsørgelseshistorikken via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service
Løsningsmodel
- Ny REST service og getmetode i Ydelsesudstilling
- Fejlkoder bevares
- Der ændres ikke i adgangsforhold til service/metoder
/wiki/spaces/GI/pages/3751280641
Ny REST service til udstillings af forsørgelseshistorik.
Getforsoergelseshistorik (GET /v1/forsoergelseshistorik/
Ny metode til at hente forsørgelsesperioder for en borger. Det er muligt at benytte dato-filtrering i input.
Acc.kr. 1005.17.1.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.
/wiki/spaces/GI/pages/4593385544
Udgår til fordel for /wiki/spaces/GI/pages/3751280641. Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2023-4, da der ikke forventes ændringer i den periode.
Acc.kr. 1005.17.1.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 Ydelsesudstilling domænet (silo)
- Data kommer fra VOA
Acc.kr. 1005.17.1.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 /wiki/spaces/GI/pages/3751280641 inkl. undersider
- Servicesnitflade SustenanceHistoryService
- Logisk datamodel Offentlig forsørgelsesperiode
- STAR applikationer og systemer på B. DFDG - Det fælles datagrundlag - Applikationsdesign
- Vitas /wiki/spaces/CITY/pages/1381204643
- Transition i forhold til registrerings- og statusservices
Acc.kr. 1005.17.1.6 - Som STAR vil jeg have data er omfattet af dataløft og annonysering mod testmiljøer
Løsningsmodel (internt STAR acc.kr.)
- Tilpasning af regler af for anonymisering og aftale hvornår data skal med i dataløft
- Systemforvalter til retter anonymiseringsflow
Acc.kr. 1005.17.1.7 Ydelsesudstilling udstiller kodelisterne ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList i Ydelsesudstilling.CodeListService
Løsningsmodel
- DFDG udstille kodelister for ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList
Bemærk: Disse kodelister er ikke statiske standardkodelister idet indholdet kommer fra VOA. Dette mønster er det samme som for de oprindelige kodelister SustenanceHistoryCategoryTypeIdentifier og SustenanceHistoryDomainTypeIdentifier fra /wiki/spaces/GI/pages/4593385544
Ydelsesudstilling.ForsoergelseshistorikKategoriCodeList
Kodeliste flytte 1 til 1 fra SustenanceHistoryCategoryTypeIdentifier
Ydelsesudstilling.ForsoergelseshistorikomraadeCodeList
Kodeliste flytte 1 til 1 fra SustenanceHistoryDomainTypeIdentifier
Acc.kr. 1005.17.1.8 /wiki/spaces/GI/pages/3690397697 udstiller ikke mere SustenanceClassificationInfo. I stedet returneres en tom liste
/wiki/spaces/GI/pages/3690397697
GetVariablePersonStatus
Udstiller ikke mere SustenanceClassificationInfo. I stedet returneres en tom liste
Acc.kr. 1005.17.1.9 ExternalData.Person i Ydelsesudstilling er moderniseret for at forbedre og sikre revisionssporet.
Løsningsmodel (internt STAR acc.kr.)
- Udvider persondata modellen i externedata til at kunne håndtere opdateringer via events inkl, sikkert revisionspor
Acc.kr. 1005.17.1.10 Ydelsesudstilling modtager persondata ved håndtering af BorgerstamdataOpdateretEvent.
Løsningsmodel (internt STAR acc.kr.)
- Ydelsesudstilling modtager persondata via ny event receiver
Acc.kr. 1005.17.1.11 Død kode i DFDG, i forbindelse med forsørgelseshistorik, fjernes
Løsningsmodel (internt STAR acc.kr.)
- Fjernelse af gammel og død kode i DFDG classic
Acc.kr. 1005.17.1.12 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i Ydelsesudstilling, i stedet for SustenanceHistoryService (2020-3)
Løsningsmodel (internt STAR acc.kr.)
- Landssupport/LSS er skiftet til at brug Ydelsesudstilling.GetForfoergelseshistorik ved brug af nyt ClientApi fra Ydelsesudstilling.
- Kode brugt i forbindelse med SustenanceHistoryService 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
- Services
- 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 |
---|---|---|
GET Forsørgelseshistorik (SOAP) | Det er muligt at udtrække en borgeres forsørgelseshistorik ved kald til SustenanceHistoryService (Version 6).GetSustenanceHistory. | Joel Järlesäter |
GET Forsørgelseshistorik | Det er muligt at udtrække en borgeres forsørgelseshistorik ved kald til Ydelsesudstilling.ForsoergelseshistorikService (v1) | Joel Järlesäter |
GET Ydelsesudstilling.CodeListService (REST) | Ydelsesudstilling udstiller kodelisterne ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList i Ydelsesudstilling.CodeListService | Joel Järlesäter |
* 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: Joel og Carsten
Angiv dato for tjek: 20-09-2022
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 Ydelsesudstilling. BI sikre at der kun loades data for den periode der er relevant (samme model som benyttes i dag)
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
Adgang til alle data.
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
Jobcenter og a-kasse sagsbehandler må gerne se disse data på Jobnet.