1005.17.39 Anden aktør henvisninger
, ConverterBeskrivelse 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 | 2023-2 | 2023-3 | 2024-3 | 1.0 | KSS, a-kasse, Converter |
Indgik i tilsagn:
til release 2023-3, bølge 1 og 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? |
|---|---|---|---|
10.02.2023 | 0.1 | Carsten Olsen | Oprettelse |
14.02.2023 | 0.1 | Knud de Place | Videre skrivning |
10.03.2023 | 0.3 | Jesper Brunholm | Løftet til 0.3 klar til tilsagn |
30.03.2023 | 0.3 | Knud | Nyt AC 1005.39.3a (opretholde logik med afkortning AA forløb ved CPR-flytning mellem kommuner og ved dødsfald) |
20.04.2023 | 0.3 | @Knud de Place (STAR) | Ønsket ekstern deltagelse i test indskrevet → indgå på ny i tilsagnsrunde (bølge 3 / 2022-3) |
28.04.2023 | 1.0 | @Knud de Place (STAR) | v1.0. Kodet færdig. |
18.05.2023 | 1.0 | @Knud de Place (STAR) | Opdateret med testscenarie (afkortning af aa-henvisning ved cpr flytning mellem kommuner) |
31.05.2023 | 1.0 | @Knud de Place (STAR) | På baggrund af spørgsmål fra aftager: Tilføjet under “særlige krav til test”, hvilke WSRM’er der er i spil ift. anden aktør henvisninger |
03.08.2023 | 1.0 | @Knud de Place (STAR) | Internt/LSS: Navn på AA vises ikke mere, da navn på cvr og p-nr ikke bæres med rundt i den nye service |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-12800
https://starwiki.atlassian.net/browse/DS-13097
https://starwiki.atlassian.net/browse/DS-12980
https://starwiki.atlassian.net/browse/BI-2736
https://starwiki.atlassian.net/browse/BI-2870
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.39.1 - Som STAR vil jeg have flyttet forretningsområdet for registrering af henvisninger til anden aktør til forretningsdomænet (silo) Borgerkommunikation inkl. at det lever op til de principper, der er fastsat
- 5.5 1005.17.39.2 - Som serviceaftager og STAR vil jeg have udstillet registrering og læsning af henvisninger til anden aktør via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service (ExternalOperatorRegistrationService)
- 5.5.1 Løsningsmodel
- 5.5.2 Ny REST-service - AndenAktoerHenvisningService
- 5.5.2.1 Ny metode til at oprette en henvisning - CreateHenvisning
- 5.5.2.2 Ny metode til at opdatere en henvisning - UpdateHenvisning
- 5.5.2.3 Ny metode til at afslutte eller annullere en henvisning - AfslutHenvisning
- 5.5.2.4 Ny metode til at læse henvisninger på én borger - GetAndenAktoerHenvisninger
- 5.5.2.5 Ny metode til at læse henvisningshistorik på én borger - GetAndenAktoerHistorik
- 5.5.2.6 Ny metode til at skifte anden aktør ejerskab på en henvisning - SkiftAndenAktoer
- 5.5.2.7 Ny metode til - GetHenvisninger
- 5.5.2.8 Ny metode til - GetJobcentre
- 5.6 1005.17.39.3 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service itt. registrering og læsning af henvisninger til anden aktør uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade
- 5.6.1.1 Løsningsmodel
- 5.6.2
- 5.6.2.1 CreateExternalOperatorReferral
- 5.6.2.2 UpdateExternalOperatorReferral
- 5.6.2.3 CancelExternalOperatorReferral
- 5.6.2.4 ChangeExternalOperatorReferralOwnership
- 5.6.2.5 GetExternalOperatorList
- 5.6.2.6 GetExternalOperatorJobcenterList
- 5.7 1005.17.39.3a - Som STAR og KSS/jobcenter vil jeg have logik vedr. flytteflow og dødsfald ift. anden aktør flyttet fra DFDG til BorgerKommunikation
- 5.8 1005.17.39.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) inkl. kontaktperson i DOA
- 5.9 1005.17.39.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.10 1005.17.39.6 - Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer - og orienterer derfor SF om hvilke nye tabeller mv. der skal scrambles
- 5.11 1005.17.39.7 - Henvisninger til anden aktør kan fra release 2024-3 ikke længere registreres ved brug af SOAP-servicen ExternalOperatorRegistrationService
- 5.11.1 Løsningsmodel
- 5.12 1005.17.39.8 - PersonHistoryService (version 4) og PersonStatusService (version 20) udstiller fra release 2024-3 ikke mere henvisninger til anden aktør. I stedet returneres en tom liste.
- 5.12.1 Løsningsmodel
- 5.13 1005.17.39.9 - Død kode i DFDG, i forbindelse med henvisninger til anden aktør fjernes, fjernes
- 5.14 1005.17.39.10 - Landssupport/LSS er skiftet over til at brug den nye REST-servicen i til læsning og registrering af henvisninger til anden aktør
- 5.15 1005.17.39.13 - Som STAR vil jeg have at anden aktør henvisninger forsat benyttes i DFDG classic for at den eksisterende classic stadig fungere mht anden aktør
- 5.16 Tjekliste modernisering DFDG:
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
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.
Afgrænsning af epic
Afgrænsning | |||
|---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for registrering af henvisninger til anden aktør 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 (interne links) |
1005.17.39.1 | Som STAR vil jeg have flyttet forretningsområdet for registrering af henvisninger til anden aktør til forretningsdomænet (silo) Borgerkommunikation inkl. at det lever op til de principper, der er fastsat | DFDG, BI | |
1005.17.39.2 | Som serviceaftager og STAR vil jeg have udstillet registrering og læsning af henvisninger til anden aktør via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service (ExternalOperatorRegistrationService) | DFDG, Jobnet, Vitas | https://starwiki.atlassian.net/browse/DS-12802 https://starwiki.atlassian.net/browse/DS-12832 |
1005.17.39.3 | Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service itt. registrering og læsning af henvisninger til anden aktør uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade | DFDG, Jobnet, Vitas | |
1005.17.39.3a | Som STAR og KSS/jobcenter vil jeg have logik vedr. flytteflow og dødsfald ift. anden aktør flyttet fra DFDG til BorgerKommunikation |
| |
1005.17.39.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.39.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | DFDG, Jobnet | |
1005.17.39.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer - og orienterer derfor SF om hvilke nye tabeller mv. der skal scrambles | DFDG, SF | |
1005.17.39.7 | Henvisninger til anden aktør kan fra release 2024-3 ikke længere registreres ved brug af SOAP-servicen ExternalOperatorRegistrationService
Løses i 2024-3 | DFDG | |
1005.17.39.8 | PersonHistoryService (version 4) og PersonStatusService (version 20) udstiller fra release 2024-3 ikke mere henvisninger til anden aktør. I stedet returneres en tom liste. Løses i 2024-3 | DFDG, Jobnet, VITAS | |
1005.17.39.9 | Død kode i DFDG, i forbindelse med henvisninger til anden aktør fjernes, fjernes | DFDG | |
1005.17.39.10 | DFDG | ||
1005.17.39.11 | Som STAR vil jeg have at anden aktør henvisninger forsat benyttes i DFDG classic for at den eksisterende classic stadig fungere mht anden aktør | DFDG | |
Pakke SIKKERHED-2 i https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3900309829
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.39.2 | 1005.17.39.3 | 1005.17.39.7 | 1005.39.8 | ||
Som KSS skal jeg senest i release 2024-3 overgå til ny REST snitflade for at registrere henvisninger til anden aktør, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | X | ||
Som KSS og a-kasse bruger af PersonStatusService og PersonHistory skal jeg senest i release 2024-3 skifte til REST snitflade læse oplysninger om henvisninger til anden aktør | X |
| X | ||
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 Skiftet sker fra idriftsættelse af release 2023-3, hvorfra registreringsmetoden kan anvendes i prod. | 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 | Ny REST metoder til at hente pr AA der erstatter ExternalOperatorRegistrationService.GetExternalOperatorList | KSS | N/A | D+S | |
Ny | Ny REST metoder til at opdatere der erstatter ExternalOperatorRegistrationService.UpdateExternalOperatorReferral | KSS | N/A | D+S | |
Ny | Ny REST metoder til at skifte AA der erstatter ExternalOperatorRegistrationService.Change.ExternalOperatorReferralOwnership | KSS | N/A | D+S | |
Ny | Ny REST metoder til at oprette der erstatter ExternalOperatorRegistrationService.CreateExternalOperatorReferral | KSS | N/A | D+S | |
Ny | Ny REST metoder til at hente pr jobcenter der erstatter ExternalOperatorRegistrationService.GetExternalOperatorJobcenterList | KSS |
| D+S | |
Ny | Ny REST metoder til at hente en AA henvisningshistorik | KSS(f) | N/A | D+S | |
Ny | Ny REST metoder til at hente en AA henvisning | KSS(f) | N/A | D+S | |
ExternalOperatorRegistrationService (Version 6).Alle metoder | Ændret | Eksisternde SOAP service der udfases i senere release til fordel for Ny REST service. Denne SOAP service bevares i en overgangsperiode parallelt med ny REST service | KSS | BI, Jobnet, VITAS | D+S |
PersonHistoryService (Version 4).GetPersonHistory.GetExternalOperatorHistory | Ændret | PHS kan i en overgangspriode forsat bruges til at hente AA henvisninger | KSS | N/A | D+S |
PersonStatusService (Version 20).GetVariablePersonStatus.ExternalOperatorReferralInfo | Ændret | PSS kan i en overgangspriode forsat bruges til at hente AA henvisninger | KSS | Jobnet, VITAS | D+S |
Se konkrete deadlines for udfasning af SOAP services og overgang til REST på https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3904372800
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 henvisninger til anden aktør følgende:
I DFDG et skift til REST snitflader - og i denne epic uden samtidige forretningsmæssige ændringer - til registrering/opdatering af henvisninger til anden aktør og til læsning af registrerede oplysninger
I Jobnet en overgang til brug af 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.
Efter gældende regler (databekendtgørelsen) skal henvisninger til anden aktør indberettes til DFDG, da DFDG bruger oplysningerne til teknisk adgangsstyring således, at anden aktør alene har adgang til oplysninger om borgere henvist til den pågældende anden aktør.
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 nye REST snitflader, men kan i en overgangsperiode (indtil 2024-3) 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.39.1 - Som STAR vil jeg have flyttet forretningsområdet for registrering af henvisninger til anden aktør til forretningsdomænet (silo) Borgerkommunikation inkl. at det lever op til de principper, der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i Borgerkommunikation
1005.17.39.2 - Som serviceaftager og STAR vil jeg have udstillet registrering og læsning af henvisninger til anden aktør via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service (ExternalOperatorRegistrationService)
Løsningsmodel
Ny REST service - AndenAktoerHenvisningService - til registrering og læsning af henvisninger til anden aktør med POST-, PUT- og GET-operationer i Borgerkommunikation
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder
Ny REST-service - AndenAktoerHenvisningService
Servicen indeholder metoder til registrering og opdatering af henvisninger, til læsning af henvisninger og henvisningshistorik på en enkelt borger ad gangen, til skift af ejerskabsforhold på en henvisning samt læsning af lister over henvisninger.
Ny metode til at oprette en henvisning - CreateHenvisning
Denne metode opretter en anden aktør henvisning for en borger til den angivne anden aktør. Metoden erstatter ExternalOperatorRegistrationService.CreateExternalOperatorReferral
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#CreateHenvisning-(POST-/v1/AndenAktoerHenvisning)
Ny metode til at opdatere en henvisning - UpdateHenvisning
Denne metode opdaterer en borgers anden aktør henvisning. Det er muligt at opdatere start- og/eller slutdato, samt den eksterne reference.
Der kan angives en kommentar vedr. opdateringen. Metoden erstatter ExternalOperatorRegistrationService.UpdateExternalOperatorReferral.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#UpdateHenvisning-(PUT-/v1/AndenAktoerHenvisning/%7BhenvisningId%7D)
Ny metode til at afslutte eller annullere en henvisning - AfslutHenvisning
Denne metode annullerer en anden aktør henvisning for en borger til en given anden aktør. Metoden bruges i forbindelse med at en anden aktør henvisning er fejloprettet eller man af anden grund øjeblikkeligt vil fjerne anden aktør adgang og visning fra Jobnet. Metoden erstatter ExternalOperatorRegistrationService.CancelExternalOperatorReferral.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#AfslutHenvisning-(PUT-/v1/AndenAktoerHenvisning/%7BhenvisningId%7D/action/Afslut)
Ny metode til at læse henvisninger på én borger - GetAndenAktoerHenvisninger
Denne metode læser anden aktør henvisninger for en borger. Metoden erstatter kollektionen ExternalOperatorReferral i PersonStatusService.GetVariablePersonStatus.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#GetAndenAktoerHenvisninger-(GET-/v1/Henvisninger)-@Carsten-Olsen-vil-du-tjekke?
Ny metode til at læse henvisningshistorik på én borger - GetAndenAktoerHistorik
Denne metode læser historik for anden aktør henvisninger for en borger. Metoden erstatter kollektionen ExternalOperatorHistory i PersonHistoryService.GetPersonHistory.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#GetAndenAktoerHistorik-(GET-/v1/Andenaktoer/historik)-@Carsten-Olsen-vil-du-tjekke
Ny metode til at skifte anden aktør ejerskab på en henvisning - SkiftAndenAktoer
Denne metode opdaterer en borgers anden aktør henvisning. Mere specifikt bliver anden aktør referencen (CVR-nr og/eller P-nr) opdateret. Forretningsmæssigt kan det f.eks. ske, når en anden aktør overtager en anden anden aktør. Metoden erstatter ExternalOperatorRegistrationService.ChangeExternalOperatorReferralOwnership.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#GetAndenAktoerHistorik-(GET-/v1/Andenaktoer/historik)-@Carsten-Olsen-vil-du-tjekke
Ny metode til - GetHenvisninger
Metoden returnerer en liste med de jobcentre hvor en give anden aktør har aktive anden aktør henvisninger. Metoden erstatter ExternalOperatorRegistrationService.GetExternalOperatorJobcenterList
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#GetHenvisninger-GET-/v1/AndenAktoerHenvisning/AndenAktoer?jobcenterkode=%7Bjobcenterkode%7D
Ny metode til - GetJobcentre
Metoden returnerer en liste med registrerede anden aktører for alle jobcentre. Metoden erstatter ExternalOperatorRegistrationService.GetExternalOperatorList.
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190/Borgerkommunikation.AndenAktoerHenvisningService+UDV+Version+1+2023-3#GetJobcentre-GET-/v1/AndenAktoerHenvisning/Jobcentre?cvrEnhedsid=%7BcvrEnhedsid%7D&pNummer=%7BpNummer%7D
1005.17.39.3 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service itt. registrering og læsning af henvisninger til anden aktør uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade
Løsningsmodel
Eksisterende SOAP bevares som kalder mod ny POST, PUT og GET-getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til idriftsættelse af release 2024-3.