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.

Interne links (indhold i links ikke relevant for eksterne)

https://starwiki.atlassian.net/browse/DS-12124

https://starwiki.atlassian.net/browse/BI-2446

Indholdsfortegnelse

Afgrænsning af epic

Pakke SCREEN-1 i DFDG roadmap

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)

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 forberedelsesskemaet (profilafklaring / screening) 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 ift. eksterne aftagere.

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.

Det er som hidtil frivilligt for a-kasser og jobcentre at anvende forberedelsesskemaet.

Hvis serviceaftager anvender ScreeningService (SOAP), skal serviceaftager imidlertid 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.7.1 - Som STAR vil jeg have flytte forretningsområde forberedelsesskemaet (Screeningservice og CitizensSreeningService) til forretningsdomænet (silo) VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Etablering af database i VisiteringOgStatus.

• Mapningsdokument til BI

1005.17.7.2 - Som serviceaftager og STAR vil jeg have udstillet forberedelsesskemaet inkl. besvarelser (Screeningservice og CitizenSreeningService) via ny REST snitflade VisiteringOgStatus.SpoergeskemaService med samme forretningslogik og operationer som de eksisterende SOAP services

Løsningsmodel

• Ny REST service i VisiteringOgStatus.SpoergeskemaService erstatter Screeningservice (ekstern rettet service) og CitizensSreeningService (intern service).

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

• Internt: Tekster hentes fra eksterndata db så den senere kan vedligeholdes samlet inkl. være sproguafhængige er epic https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4215734277

SpoergeskemaService - VisiteringOgStatus.SpoergeskemaService (2024-2)

GetSpoergeskema - GetSpoergeskema (GET /v1/Spoergeskema/Spoergsmaal/FoesteGruppe)

Intern metode. Erstatter CitizenScreeningService.GetFirstGroupOfQuestions

Metoden anvendes til at hente det første sæt af spørgsmål som borger kan besvare i forberedelsesskemaet ifm selvbetjening på Jobnet.

CreateSpoergeskema - CreateSpoergeskema (POST /v1/Spoergeskema/Spoergsmaal/NaesteGruppe)

Intern metode. Erstatter CitizenScreeningService.GetNextGroupOfQuestions

Denne metode giver mulighed for at aflevere borgerens svar til DFDG. Næste gruppe af spørgsmål i spørgeskemaet sendes retur. Den bagvedliggende survey engine, som understøtter forgreninger i spørgsmålsflowet, sørger på baggrund af borgerens afgivne svar, at hente den næste relevante gruppe af spørgsmål frem.

CreateSpoergeskema - CreateSpoergeskema (POST /v1/Spoergeskema/Spoergsmaal/IndsendOgBehandl)

Intern metode. Erstatter CitizenScreeningService.SubmitAndPerformScreening

Denne metode giver mulighed for at submitte spørgeskemaet og foretage evt. beregningen.

GetSpoergeskemaresultat - GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat/Pdf)

Erstatter CitizenScreeningService.GetScreeningResultAsPdf og ScreeningService.GetScreeningResultAsPdf

Denne metode giver mulighed for at hente seneste spørgeskema for en given borger som pdf.

GetSpoergeskemaresultatFindes - GetSpoergeskemaresultatFindes (GET /v1/Spoergeskema/Resultat/Findes)

Erstatter ScreeningService.ScreeningResultExists

Denne metode giver mulighed for at se, om der foreligger et spørgeskemaafklaringsresultat for en given borger.
Kan måske udgå, snak med de serviceaftager om denne bruges eller kan undværes da GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat) GetSpoergeskemaresultat kan bruges i stedet.

GetSpoergeskemaresultat - GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat)

Erstatter CitizenScreeningService.GetScreeningResult og ScreeningService.GetScreeningResult

Denne metode giver mulighed for at hente første spørgeskemaresultatet for en given borger.

UpdateSpoergeskemaValgt - UpdateSpoergeskemaValgt (Post /v1/Spoergeskema//ValgtAfJobcenter)

Erstatter ScreeningService.ToggleScreeningRegistration

Denne metode giver mulighed for at ændre oplysninger om, hvorvidt der er valgt spørgeskema for hver af de tre målgrupper (borgere under 30, borgere over 30 eller dagpengemodtagere) for det angivne hovedjobcenter.

GetSpoergeskemaValgt - GetSpoergeskemaValgt (GET /v1/Spoergeskema/ValgtAfJobcenter)

Erstatter ScreeningService.GetScreeningRegistration

Denne metode giver mulighed for at hente oplysninger om, hvorvidt der er valgt spørgeskema for hver af de tre målgrupper (borgere under 30, borgere over 30 eller dagpengemodtagere) for det angivne hovedjobcenter.

GetSpoergeskemaListe - GetSpoergeskemaListe (GET /v1/Spoergeskema/Liste)

Erstatter ScreeningService.GetScreeningRegistrationList

Denne metode giver mulighed for at hente en liste over alle hovedjobcentre med oplysninger om, hvorvidt der er valgt spørgeskema for hver af de tre målgrupper (borgere under 30, borgere over 30 eller dagpengemodtagere). Metoden anvendes af Landssupportsystemet, hvor der gives et overblik, og oplysningerne kan ændres.

GetSpoergeskemaresultater - GetSpoergeskemaresultater (GET /v1/Spoergeskema/Resultater)

Erstatter ScreeningService.GetScreeningResults

Denne metode henter en oversigtsliste af spørgeskemaresultater, så aftager har en mulighed for at hente relevante spørgeskema.

VisiteringOgStatusStatusService (version 2) - VisiteringOgStatus.VisiteringOgStatusStatusService (Version 2 [UDV], 2024-2/3/4)

GetPersonVisiteringOgStatusStatus - GetPersonVisiteringOgStatusStatus (GET /v1/VisiteringOgStatusStatus)

Udvides med spoergeskemaselvbetjening

VisiteringOgStatusStatusService (version 1) - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4140401254

Version 1 udgår til fordel for version 2.

1005.17.7.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 services bevares som kalder mod ny getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 202X-X.

ScreeningService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3537830010

Udgår i 2024-4 til fordel for VisiteringOgStatus.SpoergeskemaService (2024-2). ScreeningService bevares internt som SOAP snitflade i en overgangsperiode til og med 2024-4, da der ikke forventes ændringer i den periode. 

ScreeningResultExists

Metoden udgår og erstattes af GetSpoergeskemaresultatFindes (GET /v1/Spoergeskema/Resultat/Findes)

GetScreeningResult

Metoden udgår og erstattes af GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat)

GetScreeningResultAsPdf

Metoden udgår og erstattes af GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat/Pdf)

ToggleScreeningRegistration

Metoden udgår og erstattes af UpdateSpoergeskemaValgt (Post /v1/Spoergeskema//ValgtAfJobcenter)

GetScreeningRegistration

Metoden udgår og erstattes af GetSpoergeskemaValgt (GET /v1/Spoergeskema/ValgtAfJobcenter)

GetScreeningRegistrationList

Metoden udgår og erstattes af GetSpoergeskemaListe (GET /v1/Spoergeskema/Liste)

GetScreeningResults

Metoden udgår og erstattes af GetSpoergeskemaresultater (GET /v1/Spoergeskema/Resultater)

CitizenScreeningService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/2571240097

Intern:

Udgår til fordel for SpoergeskemaService. CitizenScreeningService bevares som SOAP snitflade i en overgangsperiode til og med 2025-2, da der ikke forventes ændringer i den periode. 

GetFirstGroupOfQuestions

Metoden udgår og erstattes af GetSpoergeskema (GET /v1/Spoergeskema/Spoergsmaal/FoesteGruppe)

GetNextGroupOfQuestions

Metoden udgår og erstattes af CreateSpoergeskema (POST /v1/Spoergeskema/Spoergsmaal/NaesteGruppe)

SubmitAndPerformScreening

Metoden udgår og erstattes af CreateSpoergeskema (POST /v1/Spoergeskema/Spoergsmaal/IndsendOgBehandl)

GetScreeningResult

Metoden udgår og erstattes af GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat)

GetScreeningResultAsPdf

Metoden udgår og erstattes af GetSpoergeskemaresultat (GET /v1/Spoergeskema/Resultat/Pdf)

CodeListService (version 5) - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4098392871

ScreeningResultCategoryTypeIdentifier

Udgår og erstattes af VisiteringOgStatus.ResultatkategoriTypeCodeList

ScreeningTargetGroupTypeIdentifier

Udgår og erstattes af VisiteringOgStatus.MaalgruppeForSpoergeskemaTypeCodeList

PersonStatusService (version 20) - PersonStatusService (version 20)

Berøres ikke data der ikke er noget screening/spørgeskema i den.

JobnetCitizenStatusService (version 11) - JobnetCitizenStatusService (Version 11, 2023-3)

Løsningsmodel

• Intern: JCSS udstiller ScreeningSelfService med oplysning omkring screening, det skal den forsætte med data skal i stedes hentes ved servicekald til VisitationOgStatus.VisiteringOgStatus.VisiteringOgStatusStatusService

• VisiteringOgStatus.VisiteringOgStatusStatusService udvides med screeningsdata svarende til:

1005.17.7.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo)

Løsningsmodel (internt STAR acc.kr.)

• Initial load af data / Tilpasning af BI load til VisiteringOgStatus domænet (silo)

• Data / besvarelser af forberedelsesskemaet leveres til DOA

1005.17.7.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 og forretningsside, der erstatter tilsvarende sider for ScreeningService og CitizenScreeningService

• https://starwiki.atlassian.net/wiki/spaces/LOG/pages/3531964421

• https://starwiki.atlassian.net/wiki/spaces/GI/pages/5308663

• https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4211179538

1005.17.7.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 til retter pseudonymiseringsflow 

1005.17.7.7 - VisiteringOgStatus udstiller kodelisterne ForberedelsesskemaType og ForberedelsesskemaSvarType i VisiteringOgStatus.CodelistService

Løsningsmodel 

• DFDG (classic) udstiller i dag i CodeListService (version 5) kodelister for

  • ScreeningTargetGroupTypeIdentifierType

  • ScreeningResultCategoryTypeIdentifierType

De udstilles fremover i VisiteringOgStatus:

ResultatKategoriCodeList - VisiteringOgStatus.ResultatkategoriTypeCodeList

Erstatter ScreeningResultCategoryTypeIdentifier

SpoergeskemaMaalgruppeCodeList - VisiteringOgStatus.MaalgruppeForSpoergeskemaTypeCodeList

Erstatter ScreeningTargetGroupTypeIdentifier

SpoergsmaalsKategoriCodeList - https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4211867649

Erstatter Enum

SvarmulighedstypeCodeList - https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4212326404

Erstatter Enum

1005.17.1.8 - PersonStatusService (version 20) og PersonHistoryService (version 4) udstiller stadig ikke data om spørgeskema. Dvs ingen ændringer til disse to service

PersonStatusService (version 20)

Berøres ikke data der ikke er noget screening/spørgeskema i den.

https://starwiki.atlassian.net/wiki/spaces/GI/pages/4099047425

Berøres ikke data der ikke er noget screening/spørgeskema i den.

1005.17.1.9 - VisiteringOgStatus modtager tekster ved håndtering af BorgerstamdataOpdateretEvent.

Løsningsmodel (internt STAR acc.kr.)

• VisiteringOgStatus modtager tekster via ny event receiver 
  Denne del laves ikke i regi af denne epic men først når https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4215734277 er implementeret

• Øvrige data er lavet i domæne

1005.17.1.10 - Død kode i DFDG, i forbindelse med forberedelsesskema (profilafklaring / screening), fjernes

Løsningsmodel (internt STAR acc.kr.)

• Fjernelse af gammel og død kode i DFDG classic

Acc.kr. 1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i VisiteringOgStatus, i stedet for ScreeningService

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug SpoergeskemaService ved brug af nyt ClientApi fra VisiteringOgStatus.

  • Accordeon med visning af besvarelser (her vist for borger uden besvarelse)

  • Open

    

  • Menupunkt under Stamoplysninger → Profilafklaring

    • Open

      

       

• Kode brugt i forbindelse med ScreeningService er fjernet fra LSS

Acc. Kr. 1005.17.7.13 Som serviceaftager og STAR vil jeg have webservicebeskeder

Løsningsmodel

WsrmMessageService (version 10) - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4041180511

GetScreeningResultVersion10

Beskeden kan benyttes i en overgangsperiode.

1005.17.7.13 Som STAR vil jeg have spørgsmål og kvitteringstekster i ekstern data of styret fra fælles hold

Løsningsmodel (internt STAR acc.kr.)

• Kviteringstekster og spørgsmål ligges i Ekstern data men event revicer for nyt DASR tekst modul laves ikke dat det ikker er klart

• Kviteringstekster og spørgsmål hentes fra Ekstern data, vi udvvider med sprog, men det skal ikke med i snitfladen endnu

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 identificeret (Jobnet, VITAS, JobAG, BI integrationsplatform andre domæner m.v.)

• Eksterne afhængigheder identificeret (Kommunalt sagsbehandlingssystem, A-kasse sagsbehandlingssystem, Kommunalt bookingsystem (WorkForcePlanner (WFP), M4 Booking, Schultz Booking). Kommunalt ydelsessystem (KY), Kommunalt sygedagpengesystem (KSD), EG kommune information m.fl.)

Særlige krav til test

* 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 )

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