, ConverterBeskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
...
| Page Properties | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Indgik i tilsagn:
|
...
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 | Ønsket ekstern deltagelse i test indskrevet → indgå på ny i tilsagnsrunde (bølge 3 / 2022-3) | |
28.04.2023 | 1.0 | v1.0. Kodet færdig. | |
18.05.2023 | 1.0 | Opdateret med testscenarie (afkortning af aa-henvisning ved cpr flytning mellem kommuner) | |
31.05.2023 | 1.0 | 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 | Internt/LSS: Navn på AA vises ikke mere, da navn på cvr og p-nr ikke bæres med rundt i den nye service |
...
| Table of Contents | ||
|---|---|---|
|
| Info |
|---|
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 | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |
| ||||||||||||||||||||||||||||||||
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 |
| ||||||||||||||||||||||||||||||||
...
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. | ||
...
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.
...
Denne metode opretter en anden aktør henvisning for en borger til den angivne anden aktør. Metoden erstatter ExternalOperatorRegistrationService.CreateExternalOperatorReferral
Forretningsregler: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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: Borgerkommunikation.AndenAktoerHenvisningService (2023-3) /wiki/spaces/GI/pages/3970695179
Teknisk snitflade i UDV-version: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3970695190#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
...
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.
ExternalOperatorRegistrationService metoderne kalder videre mod AndenAktoerHenvisningService
Kollektionerne vedr. anden aktør i PSS og PHS holdes i live (data replikeres fra BK til DFDG af hensyn til sikkerhedsmodellen kan holdes i live).
...
Følgende metoder flyttes til REST og erstattes af tilsvarende metoder i Borgerkommunikation.AndenAktoerHenvisningService [UDV] (Version 1, 2023-3) /wiki/spaces/GI/pages/3970695190
CreateExternalOperatorReferral
...
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:
...
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
N/A
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
...