, ConverterBeskrivelse 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-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

Afgrænsning af epic

Pakke SIKKERHED-2 i https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3900309829

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.

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

Forretningsregler: https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695179#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)-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)-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)-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)-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)-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)-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)-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.

  • 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).

https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3462234310

Følgende metoder flyttes til REST og erstattes af tilsvarende metoder i https://starwiki.atlassian.net/wiki/spaces/GI/pages/3970695190

CreateExternalOperatorReferral

UpdateExternalOperatorReferral

CancelExternalOperatorReferral

ChangeExternalOperatorReferralOwnership

GetExternalOperatorList

GetExternalOperatorJobcenterList

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

Som STAR og KSS/jobcenter vil jeg have logik vedr. flytteflow og dødsfald ift. anden aktør flyttet fra DFDG til BorgerKommunikation.

Gældende forretning, jf. https://starwiki.atlassian.net/wiki/spaces/GI/pages/3442737917#TransferDataService(2022-1)-Andenakt%C3%B8rforl%C3%B8bafkortes og https://starwiki.atlassian.net/wiki/spaces/LOG/pages/30638103 opretholdes.

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

Løsningsmodel (internt STAR acc.kr.)

• Konvertering: Initial load af data / Tilpasning af BI load til Anden aktør henvisninger til Borgerkommunikationen domænet (silo)

• Fremadrettet leverance af data til DOA

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

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 

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

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 efter anvisninger / beskrivelse af nye tabeller mv. fra D&S

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øsningsmodel 

• DFDG udfaser ExternalOperatorRegistrationService

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øsningsmodel 

• DFDG udfaser anden aktør kollektionerne i PSS og PHS

• Kollektionerne udstiller i stedet en tom liste

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

Løsningsmodel (internt STAR acc.kr.)

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

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

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug AndenAktoerHenvisningService ved brug af nyt ClientApi fra Borgerkommunikation

  • Visning af henvisninger i accordion

  • Registrering og opdatering af henvisninger via højre-menu

  • Kode brugt i forbindelse med ExternalOperatorRegistrationServoce er fjernet fra LSS

  • Navn på AA vises ikke mere, da navn på cvr og p-nr ikke bæres med rundt i den nye service

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

Løsningsmodel (internt STAR acc.kr.)

• DFDG classic modtager anden aktør henvisninger via ny event receiver 

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.

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

• Eksterne afhængigheder indenitfiseret (Kommunalt sagsbehandlingssystem, A-kasse sagsbehandlingssystem, Kommunalt bookingsystem (WorkForcePlanner (WFP), M4 Booking, Schultz Booking). Kommunalt ydelsessystem (KY), Kommunalt sygedagpengesystem (KSD), EG kommune informatiom 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 Brogerkommunikation

• Nye snitflader: Nej, flytning til domæne Brogerkommunikation

• 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 Borgerkommunikation. 

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

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

Anden aktør har ikke adgang til Sagsbehandlerlogin på Jobnet pt.