999.14 Nytænkning - Registrering af afholdte samtaler inkl. omlægning fra SOAP til REST
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? |
|---|---|---|---|
14.09.2022 | 0.1 | Udskilt fra E 999.5 | |
01.11.2022 | 0.5 | Jesper Brunholm | WSRM GetPersonInterview bevares og GetAfholdtSamtaleVersion1 oprettes ikke, da der ikke er behov for strukturændringer. |
| 16.01.2022 | 0.5 | Knud | Er nu v1.0 fsva. eksterne dele. Afholdte samtaler, der indberettes med de gamle SOAP-services og den nye REST service gemmes i samme tabel, så (alle) afholdte samtaler kan ske med Kontaktforloeb.AfholdtSamtaleService (version 1).GetAfholdteSamtaler. |
Indholdsfortegnelse
OBS svartider
OBS ift. svartider
Svartiderne forventes at være væsentlig dårligere ved brug af SOAP-versionerne af de gamle services end ved brug af de nye REST services - og svartiderne forventes at være væsentlig højere på SOAP-services end før omlægningen til REST. Det skyldes, at SOAP-versionerne internt kalder videre til de nye REST versioner.
STAR vil derfor gerne undgå, at holde SOAP-versionerne i live, med mindre det konkret efterspørges af de enkelte aftagere ifm. tilsagn til en given epic.
For en service med svartider i dag på fx 4-8 millisekunder (med 7-9 mio. kald pr. måned) forventes, at svartiden på SOAP-version vil være ca x 100.
16.01.2023: SOAP-services til registrering af afholdte samtaler holdes i live i 2023-1.
Som STAR har jeg brug for at jobnet fremover henter informationer om afholdte samtaler i Kontakforløb-domænet, så denne funktionalitet fortsat virker efter omlægningen fra SOAP til REST.
Afgrænsning af epic
| Afgrænsning | ||
|---|---|---|
Som KSS, plannersystem og a-kasse skal jeg i 2022-4, 2023-1, 2023-2, 2023-3 eller senest i 2023-4 ibrugtage nye REST-versioner af services til registrering af indkaldelser, frister (frister kun fsva. KSS) og afholdte samtaler for at overgå fra brug af DFDG end-of-life (SOAP) services til blivende (REST) services. Denne epic omhandler konkret omlægning af registrering af afholdte samtaler fra SOAP til REST snitflade. | ||
| Acceptkriterier | ||
| Nr. | Beskrivelse | Relevant for |
| 999.14.1 | DFDG etablerer ny AfholdtSamtaleService (REST) til registrering og opdatering af afholdte samtaler OBS - STAR ser meget gerne (af hensyn til oplevede svartider), at aftagerne tager denne service i brug i 2023-1. | DFDG |
| 999.14.2 | DFDG fjerner senest OBS - STAR vil af hensyn til oplevede svartider gerne undgå at holde gamle SOAP-versioner i live i 2023-1 16.01.2023: SOAP-services til registrering af afholdte samtaler holdes i live i 2023-1. | DFDG |
| 999.14.3 | DFDG udfaser InterviewService (v2).GetInterviewInfo og PersonStatusService (version 20).GetVariablePersonStatus. PersonInterviewInfo | DFDG |
| 999.14.4 | LSS og Datakanon understøtter de nye services | DFDG |
| 999.14.5 | Afholdte samtaler i DFDG/Brokerservices konverteres til det ny domæne | DFDG |
| 999.14.6 | Jobnet henter fremover informationer om afholdte samtaler i Kontakforløb-domænet, så denne funktionalitet fortsat virker efter omlægningen fra SOAP til REST. | |
: Kan blive før 2023-4, hvis alle aftagere inden da er overgået til de nye REST-services på de berørte områder.
Se OBS ovenfor i Info-boks om svartider på SOAP-versionerne.
| Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
| 999.14.1 | 999.14.2 | 999.14.3 | |||
Som KSS og A-kasse anvender jeg (senest) i relase 2023-4 REST-servicen Kontaktforloeb.AfholdtSamtaleService til registrering og indberetning af afholdte samtaler | X | ||||
| Som KSS og a-kasse ophører jeg (senest) i relase 2023-4 med at registrere og opdatere afholdte samtaler via InterviewService og PersonRegistrationService | X | ||||
| KSS og A-kasse tager i 2023-1 Kontaktforloeb.AfholdtSamtaleService.GetAfholdteSamtaler i brug til hentning af afholdte samtaler | 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.
(kopiér og indsæt manuelt i tabellen)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
| InterviewService (v2).GetInterviewInfo | Udgået | Metoden udfases i 2023-1. Aftagere skal i stedet benytte AfholdtSamtaleService.GetAfholdteSamtaler | KSS, A-kasse, planner systemer | Jobnet | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).CreateAfholdtSamtale | Ny | Afløser InterviewService.CreateInterview og tilsvarende metode på PRS, der udgår senest i 2023-4 | KSS, A-kasse, planner systemer | Jobnet, BI | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).UpdateAfholdtSamtale | Ny | Afløser InterviewService.UpdateInterview og tilsvarende metode på PRS, der udgår senest i 2023-4 | KSS, A-kasse, planner systemer | Jobnet, BI | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).GetAfholdteSamtaler | Ny | Ny metode til at hente information om afholdte samtaler. Afløser InterviewService.GetInterviewInfo og PSS PersonInterviewInfo collection | KSS, A-kasse, planner systemer | Jobnet, BI | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).CreateMoededeltager | Ny | Afløser InterviewService.AddInterviewParticipant og tilsvarende metode på PRS, der udgår senest i 2023-4 | KSS, A-kasse, planner systemer | BI | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).UpdateMoededeltager | Ny | Afløser InterviewService.UpdateInterviewParticipant og tilsvarende metode på PRS, der udgår senest i 2023-4 | KSS, A-kasse, planner systemer | BI | D+S |
| Kontaktforloeb.AfholdtSamtaleService (version 1).DeleteMoededeltager | Ny | Afløser InterviewService.DeleteInterviewParticipant og tilsvarende metode på PRS, der udgår senest i 2023-4 | KSS, A-kasse, planner systemer | BI | D+S |
| PersonStatusService (version 20).GetVariablePersonStatus.PersonInterviewInfo | Udgået | Kollektionen udfases i 2023-1. Aftagere skal i stedet benytte AfholdtSamtaleService.GetAfholdteSamtaler | KSS, A-kasse, planner systemer | Jobnet | D+S |
Bemærk at der i ISB 999 er lavet en oversigt over løsningens indhold i forskellige releases
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Beskrivelse af epic
Baggrund
Første delaftale om nytænkning af beskæftigelsesindsatsen (juni 2021)
Regeringen, Dansk Folkeparti, Socialistisk Folkeparti og Enhedslisten er enige om, at beskæftigelsesindsatsen skal nytænkes, så jobcentrene bruger ressourcerne der, hvor de har størst effekt og kommer flest ledige til gavn.
Delaftalen fremgår på bm.dk. Link til aftalen: 2021-juni-aftaletekst_foerste-delaftale-om-nytaenkning-af-beskaeftigelsesindsatsen.pdf.
Anden delaftale om nytænkning af beskæftigelsesindsatsen (juni 2022)
Regeringen (Socialdemokratiet), Socialistisk Folkeparti, Enhedslisten, Dansk Folkeparti og Bent Bøgsted på vegne af arbejdsfællesskabet af løsgængere (Liselott Blixt, Hans Kristian Skibby, Karina Adsbøl, Marie Krarup og Lise Bech) er enige om at nytænke beskæftigelsesindsatsen, så jobcentrene bruger ressourcerne der, hvor de har størst effekt og kommer flest ledige til gavn.
Delaftalen fremgår på bm.dk.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Se nærmere i E 999.3.
Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
Mellem release 2023-1 og 2023-4 vil der - hvis det efterspørges - være en overgangssituation, hvor
- InterviewService (og tilsvarende metoder på PersonRegistrationService) og AfholdtSamtaleService kan anvendes parallelt.
- InterviewService og tilsvarende metoder i PersonRegistrationService til registrering og opdatering af afholdte samtaler (SOAP) udgår senest med release 2023-4.
- Læsning af afholdte samtaler fra 2023-1 skal ske med Kontaktforloeb.AfholdtSamtaleService (version 1).GetAfholdteSamtaler.
16.01.2023: SOAP-services holdes i live i 2023-1.
Afholdte samtaler, der indberettes med de gamle SOAP-services og den nye REST service gemmes i samme tabel, så (alle) afholdte samtaler kan ske med Kontaktforloeb.AfholdtSamtaleService (version 1).GetAfholdteSamtaler.
AC 999.14.1 - DFDG etablerer ny AfholdtSamtaleService (REST) til registrering og opdatering af afholdte samtaler
Der laves ingen ny WSRM, da struktur og dataindhold på WsrmMessageService (version 10).GetPersonInterviewVersion9 og WsrmMessageService (version 11).GetPersonInterviewVersion10 er tilstrækkelig.
Udviklingsversion
Forretningside: /wiki/spaces/GI/pages/3656548521
Snitflade: /wiki/spaces/GI/pages/3781492751
A-kasse adgang og filtrering
Der er brug for samme a-kasseadgang og filtrering på de nye services/metoder som på de nuværende SOAP-versioner.
AC 999.14.2 - DFDG fjerner senest i 2023-4 understøttelsen af InterviewService.CreateInterview og UpdateInterview samt PersonRegistrationService.CreatePersonInterview, UpdatePersonInterview og InterviewParticipant-metoderne
AC 999.14.3 - DFDG udfaser InterviewService (v2).GetInterviewInfo og PersonStatusService (version 20).GetVariablePersonStatus.PersonInterviewInfo
AC 999.14.4 - LSS og Datakanon understøtter de nye services
AC 999.14.5 - Afholdte samtaler i DFDG/Brokerservices konverteres til det ny domæne
AC 999.14.6 - Jobnet henter fremover informationer om afholdte samtaler i Kontakforløb-domænet
Som STAR har jeg brug for at jobnet fremover henter informationer om afholdte samtaler i Kontakforløb-domænet, så denne funktionalitet fortsat virker efter omlægningen fra SOAP til REST. BVL-589 - Getting issue details... STATUS
Særlige krav til test
| Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
|---|---|---|
Afholdte samtaler kan registreres via ny og gl. service → afledte WSRM'er dannes og validerer | WSRM | |
| Afholdte samtaler kan opdateres via ny og gl. service → afledte WSRM'er dannes og validerer | WSRM | |
Afholdte samtaler kan registreres via ny og gl. service → Indgår i borgers Min plan, hvis relevante samtaletype | Min plan | |
| Afholdte samtaler kan registreres via ny og gl. service → kan ses i LSS | LSS | |
| Datakanon kan fortsat registrere afholdte samtaler | LSS/Datakanon |
* 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:
Efter idriftsættelse:
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
- Nye dataområder:
- Nye snitflader:
- Nye komponenter:
- Nye miljøer:
- Nye teknologier:
- Nye aftagertyper:
- Eller afvigelser fra principperne:
- Eventuelle behov for reduktion af teknisk gæld skal afdækkes:
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: Knud
Angiv dato for tjek: 16.01.2023
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.
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
Ingen ændringer ift. hvilke samtaletyper a-kassen må se. Se filtreringsregler på forretningsside for PersonStatusService.
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
Ingen ændringer ift. hvilke samtaletyper a-kassen må se. Se filtreringsregler på forretningsside for PersonStatusService.