Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
...
Page Properties | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
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 |
07.06.2023 | 0.1 | Carsten Olsen | Link til snitflader og indholdet oprettet |
12.06.2023 | 0.3 | Carsten Olsen og Knud de Place | Gjort klar til tilsagn |
07.07.2023 | 0.3 | Carsten Olsen | STAR har flytte disse Krav til Jobsøgning til det interne domæne “Borgerindsats“ der også indeholder Min plan. Der er ingen ændringer til forretning eller snitflader i denne sammenhæng. |
25.07.2023 | 0.3 | Knud de Place | På baggrund af spg. fra FOA (FB 378852) under tilsagnsbølge 1 er kriterier for eksterne opdateret med, at (også) a-kasser skal overgå til ny REST snitflade, men i en overgangsperiode fortsat kan anvende SOAP-versionen til registrering af krav til jobsøgning. |
13.09.2023 | 0.5 | Knud de Place | Nyt internt ac-13 |
...
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Indholdsfortegnelse
Table of Contents | ||
---|---|---|
|
...
Afgrænsning af epic
Afgrænsning | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for Krav til jobsøgning til REST inkl. Krav til jobsøgnings kobling til Min plan (My plan) 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.5.1 | Som STAR vil jeg have flyttet forretningsområdet Krav til jobsøgning til forretningsdomænet (silo) Borgerindsats inkl. at det lever op til de principper, der er fastsat | DFDG, BI |
| ||||||||||||||||
1005.17.5.2 | Som serviceaftager og STAR vil jeg have udstillet Krav til jobsøgning via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service samt have Krav til jobsøgning til at indgå i den nye REST snitflade for Min plan | DFDG, Jobnet |
| ||||||||||||||||
1005.17.5.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. Bemærk at dette kun berører Krav til Jobsøgning og ikke de øvrige Min plan snitflader | DFDG, Jobnet |
| ||||||||||||||||
1005.17.5.4 | Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) inkl. kontaktperson i DOA | BI |
| ||||||||||||||||
1005.17.5.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.5.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | DFDG, SF |
| ||||||||||||||||
1005.17.5.7 | Borgerindsats udstiller kodelisterne for Krav til Jobsøgning og gl. kodelister fra DFDG classic udgår | DFDG |
| ||||||||||||||||
1005.17.5.8 | /wiki/spaces/GI/pages/3690397697 udstiller ikke mere Krav til jobsøgning (bemærk - er udfaset i tidligere release). I stedet returneres en tom liste. | DFDG |
| ||||||||||||||||
1005.17.5.9 | Borgerindsats modtager Kontaktgruppe, personkategori, tilmelding m.fl. via af event og behandle disse. | DFDG |
| ||||||||||||||||
1005.17.5.10 | Død kode i DFDG, i forbindelse med Krav til jobsøgning, fjernes | DFDG | Flyttes til 1005.17.99 | ||||||||||||||||
1005.17.5.11 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i Borgerindsats , i stedet for SOAP service fra DFDG classic | DFDG |
| ||||||||||||||||
1005.17.5.12 | Udsendelse af webservicebeskeder og udfasning af WSRM (se epic 1005.17.48) | DFDG |
| ||||||||||||||||
1005.17.5.13 | Som STAR og ekstern aftager ønsker jeg services og metoder dekoreret med scopes | DFDG |
|
...
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.17.5.2 | 1005.17.5.3 | 1005.17.5.8 | |||
Som A-kasse og KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | |||
PersonStatusService indeholder ikke længere krav til jobsøgning. | X | Bemærk at collection allerede er udfaset før denne epic | |||
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.
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
Ny | Erstatter Gl. DFDG EmploymentAreaTypeIdentifier | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstatter Gl. DFDG TradeForJobSearchTypeIdentifier | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstatter Gl. DFDG GeographicalAreaTypeIdentifier | A-kasse, KSS | Jobnet | D+S | |
Borgerindsats.KravTilJobsoegningService.CreateKravTilJobsoegning (POST v1/KravTilJobsoegning/) | Ny | Erstatter Gl. DFDG servicemetode CreateJobSearchDefinition | A-kasse, KSS | BI | D+S |
Ny | Erstatter Gl. DFDG servicemetode DeleteJobSearchDefinition | A-kasse, KSS | N/A | D+S | |
Borgerindsats.KravTilJobsoegningService.GetKravTilJobsoegning (GET v1/KravTilJobsoegning/Historik) | Ny | Erstatter Gl. DFDG servicemetode GetJobSearchDefinitions | A-kasse, KSS | Jobnet | D+S |
Ny | Erstatter Gl. DFDG servicemetode GetJobSearchDefinition | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstattes af AnsoegningsOmraadeCodeList | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstattes af GeografiskOmraadeTypeCodeList | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstattes af FagomraadeTypeCodeList | A-kasse, KSS | Jobnet | D+S | |
Ny | Erstattes af tilsvarende metoder Borgerindsats.KravTilJobsoegningService.. Servicen bevares som SOAP snitflade i en overgangsperiode se dog epic | A-kasse, KSS | Jobnet | D+S | |
WsrmMessageService (version 10).GetJobSearchDefinitionEventVersion1 | Ny | Indhold i WSRM uændret. Afsendelseslogik ændret. Test nødvending. | A-kasse, KSS | N/A | D+S |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Jira Legacy | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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 Krav til jobsøgning 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 ændringer til indberetningsregler i denne epic, da der alene er tale ren flytning til REST.
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 2024-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.
1005.17.5.1 - Som STAR vil jeg have flytte forretningsområde Krav til Jobsøgning 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
Excel ark med konverteringsregler til BI
Kontakt til BI på de kan gå igang med deres konvertering/ tjek deres US er klar
1005.17.5.2 - Som serviceaftager og STAR vil jeg have udstillet Krav til jobsøgning via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service
Løsningsmodel
Ny REST service og metoder i Borgerindsats.KravTilJobsoegningService
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder
Borgerindsats.KravTilJobsoegningService
Service erstatter JobSearchDefinitionService (2021-4)
CreateKravTilJobsoegning (POST v1/KravTilJobsoegning/)
Erstatter CreateJobSearchDefinition
Metoden anvendes til at oprette “Krav til jobsøgning”.
DeleteKravTilJobsoegning (DELETE v1/KravTilJobsoegning/{kravTilJobsoegningId}?berigtigelseskommentar)
Erstatter DeleteJobSearchDefinition
Metoden anvendes til at berigtige en forkert indberettet “Krav til jobsøgning” Hvis “Krav til jobsøgning slettes”, vil de “Krav til jobsøgning”, der var indberettet forud for den forkerte, være gældende for borgeren.
GetKravTilJobsoegning (GET v1/KravTilJobsoegning/{kravTilJobsoegningId})
Erstatter GetJobSearchDefinition
Metoden kan anvendes til at hente et sæt “Krav til jobsøgning”. Hvis ikke ID er udfyldt, så hentes seneste aktive "krav til jobsøgning".
GetKravTilJobsoegning (GET v1/KravTilJobsoegning/Historik)
Erstatter GetJobSearchDefinitions
Metoden anvendes til at hente en liste over alle ”Krav om jobsøgning” der er registreret på den ledige. På den måde kan fx en historisk version af “Krav til jobsøgning” findes.
1005.17.5.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 REST-service 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-4.
JobSearchDefinitionService (2021-4)
Udgår til fordel for Borgerindsats.KravTilJobsoegningService. Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2024-4, da der ikke forventes ændringer i den periode.
1005.17.5.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)
Initial load af eventdata der ikke allerede findes i Borgerindsats som Krav til jobsøgning skal anvende
Dataleverance til VOA ændres til Jobserach og omlægges til ny leverancemodel
Nye eksterne data der skal loades til Borgerindsats
Kontaktgruppe (er etableret allerede og modtages)
Personkatagori (er etableret allerede og modtages)
Tilmelding (mangler)
A-kasse medlemskab (er etableret allerede og modtages)
Jobcentertilknytning (er etableret allerede og modtages)
EscoStar (er etableret allerede og modtages)
1005.17.5.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
...
1005.17.5.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 anonymisering og aftale hvornår data skal med i dataløft
Opdater SF regelark om pseudonymisering, de samme regler kan anvendes da der ikke sker ændring til data
Systemforvalter til retter pseudonymiseringsflow
1005.17.5.7 Borgerindsats udstiller kodelisterne til Krav til jobsøgning i Borgerindsats.CodeListService
Løsningsmodel
DFDG udstille kodelister for Krav til jobsøgning.
Borgerindsats.CodeLists
Borgerindsats.GeografiskOmraadeTypeCodeList
Kodeliste flytte 1 til 1 fra GeographicalAreaTypeIdentifier
Borgerindsats.FagomraadeTypeCodeList
Kodeliste flytte 1 til 1 fra TradeForJobSearchTypeIdentifier
Borgerindsats.AnsoegningsOmraadeCodeList
Kodeliste flytte 1 til 1 fra EmploymentAreaTypeIdentifier
1005.17.5.8 /wiki/spaces/GI/pages/3690397697 udstiller ikke mere Krav til jobsøgning (er udfaset i tidligere release). I stedet returneres en tom liste
/wiki/spaces/GI/pages/3690397697
GetVariablePersonStatus
Udstiller ikke mere LatestJobSearchDefinitionInfo. I stedet returneres en tom liste.
Bemærk denne collection er allerede udfaset i tidligere release og der er derfor ingen ændring i forhold den nuværende PSS i denne forbindelse og dette acceptkriterier er alene medtaget til information. Der etableres derfor i denne sammenhæng ikke anden specifik statusservice, med mindre serviceaftager udtrykker et specifik behov.
1005.17.5.9 Borgerindsats modtager og behandle events til brug for Krav til jobsøgning.
Løsningsmodel (internt STAR acc.kr.)
Borgerindsats modtager persondata via ny event receiver
Events
Kontaktgruppe
Handling: Ingen. Min plan blive eventuelt gjort inaktiv i denne forbindelse. Se Min plan for beskrivelse.
Personkatagori
Handling: Ved skift af personkategori fra væk fra jobparat eller åbenlyst uddannelsesparat (ikke relevant for dagpengemodtager og ledighedsydelsesmodtagere) vil DFDG lave en ny version af Min plan hvor Krav til jobsøgning ikke vil fremgå, Der vil være en hændelse "Krav til jobsøgning annulleret" på Min plan.
Dette laves
Tilmelding
Handling: Ingen.
A-kasse medlemskab
Handling: Skift i a-kasse medføre ingen handling.
Jobcentertilknytning
Handling: Skift i jobcentertilknytning medføre ingen handling.
EscoStar
Handling: Ingen.
1005.17.5.10 Død kode i DFDG, i forbindelse med krav til jobsøgning, fjernes
Løsningsmodel (internt STAR acc.kr.)
Fjernelse af gammel og død kode i DFDG classic
Det skal afklares om gammel kode fjernes eller blot afblændes og fjernes når DFDG classic fletnes samlet i givet fald overføres US til 1005.17.99 Backlog
1005.17.5.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i Borgerindsats.KravTilJobsoegningService, i stedet for JobSearchDefinitionService
Løsningsmodel (internt STAR acc.kr.)
Landssupport/LSS er skiftet til at brug Borgerindsats.KravTilJobsoegningService ved brug af nyt ClientApi fra.
Kode brugt i forbindelse med JobSearchDefinitionService er fjernet fra LSS
Acc. kr. 1005.17.5.12 Udsendelse af webservicebeskeder og udfasning af WSRM (se epic 1005.17.48)
Insert excerpt | ||||
---|---|---|---|---|
|
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 | Deltagelse i test | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|---|
Registrerede krav til jobsøgning via SOAP kan udlæses igen via SOAP (JobSearchDefinitionService) | Aftagere, der i første omgang forbliver på SOAP | JobSearchDefinitionService | Knud |
Registrerede krav til jobsøgning viaREST kan udlæses igen via REST | Aftagere, der tager REST-service i brug | KravTilJobsoegningService. | Knud |
Uanset om registrering af krav til jobsøgning sker via SOAP eller REST fremgår det i GetJobSearchDefinitionEventVersion1 WSRM'en, om det er jobcentret eller a-kassen, der har foretaget registreringen | Det ønskes, at KSS og A-kasse deltager i test uanset, om REST snitflade tages i brug i 2023-4:
| WSRM GetJobSearchDefinitionEventVersion1 på WsrmMessageService version 10 (RequestUserMetadata og RequestOrganisationStructure) | Knud |
...
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:
...
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.
...
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
...