1005.17.39 Anden aktør henvisninger

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
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

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?

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)

key PO FA UX SME Eksterne snitflader Interne Snitflader status labels
Loading...
Refresh

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

 

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

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

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

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

1005.17.39.9

Død kode i DFDG, i forbindelse med henvisninger til anden aktør fjernes, fjernes

DFDG



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

DFDG

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

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

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

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

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

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).GetHenvisninger GET /v1/AndenAktoerHenvisning/AndenAktoer?jobcenterkode={jobcenterkode}

Ny

Ny REST metoder til at hente pr AA der erstatter ExternalOperatorRegistrationService.GetExternalOperatorList

KSS

N/A

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).SkiftAndenAktoer (PUT /v1/AndenAktoerHenvisning/action/SkiftAndenAktoer)

Ny

Ny REST metoder til at opdatere der erstatter ExternalOperatorRegistrationService.UpdateExternalOperatorReferral

KSS

N/A

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).UpdateHenvisning (PUT /v1/AndenAktoerHenvisning/{henvisningId})

Ny

Ny REST metoder til at skifte AA der erstatter ExternalOperatorRegistrationService.Change.ExternalOperatorReferralOwnership

KSS

N/A

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).CreateHenvisning (POST /v1/AndenAktoerHenvisning)

Ny

Ny REST metoder til at oprette der erstatter ExternalOperatorRegistrationService.CreateExternalOperatorReferral

KSS

N/A

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).GetJobcentre GET /v1/AndenAktoerHenvisning/Jobcentre?cvrEnhedsid={cvrEnhedsid}&pNummer={pNummer}

Ny

Ny REST metoder til at hente pr jobcenter der erstatter ExternalOperatorRegistrationService.GetExternalOperatorJobcenterList

KSS

 

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).GetAndenAktoerHistorik (GET /v1/Andenaktoer/action/historik)

Ny

Ny REST metoder til at hente en AA henvisningshistorik

KSS(f)

N/A

D+S

Borgerkommunikation.AndenAktoerHenvisningService (Version 1).GetAndenAktoerHenvisninger (GET /v1/Henvisninger)

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.

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Loading...
Refresh

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

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-CreateHenvisning(POST%2Fv1%2FHenvisning)CreateHenvisning(POST%2Fv1%2FAndenAktoerHenvisning)

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-UpdateHenvisning(PUT%2Fv1%2FAndenAktoerHenvisning%2F%7BhenvisningId%7D)

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-AfslutHenvisning(PUT%2Fv1%2FAndenAktoerHenvisning%2F%7BhenvisningId%7D%2Faction%2FAfslut)

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-GetAndenAktoerHenvisninger

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-GetAndenAktoerHistorik

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-SkiftAndenAkt%C3%B8r(PUT%2Fv1%2FAndenAktoerHenvisning%2Faction%2FSkiftAndenAkt%C3%B8r)

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

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-GetHenvisningerGET%2Fv1%2FAndenAktoerHenvisning%2FAndenAktoer%3Fjobcenterkode%3D%7Bjobcenterkode%7D

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.

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179/Borgerkommunikation.AndenAktoerHenvisningService+2023-3#Borgerkommunikation.AndenAktoerHenvisningService(2023-3)-GetJobcentreGET%2Fv1%2FAndenAktoerHenvisning%2FJobcentre%3FcvrEnhedsid%3D%7BcvrEnhedsid%7D%26pNummer%3D%7BpNummer%7D

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.