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.

Interne links (indhold i links ikke relevant for eksterne)

KON-1075 - Getting issue details... STATUS

DS-14836 - Getting issue details... STATUS

BI-3388 - Getting issue details... STATUS

Indholdsfortegnelse

Afgrænsning af epic

Pakke BORGER-1 I DFDG roadmap

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)

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 borgerstamdata og tilhørende statusservice følgende:

• I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer

• I Jobnet en overgang til 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.

Det er ingen indberetningsregler i denne epic, da der alene er tale om GET metoder på en statusservice.
OBS: Det konkrete indhold i statusservice og de enkelte dataelementer skal endelig afklares med serviceaftagerer som en del af denne epic, det betyder at den vedlagte servicesnitflade vil blive tilpasset i processen. I forbindelse med tilsagnsproces må serviceaftager derfor meget gerne giv input.

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 ny REST snitflade for de dataelementer der flyttes når statusservice ønskes, i en overgangsperiode indtil PersonStatusService endelig udfasses vil de resterende dataelementer stadig kunne tilgås på PSS indtil dataelementet flyttes. En sådan flytning varsles seperat.

Generel model om og anvendelse af statsusservice inkl. i relation til almindelige getmetoder

• Statusservice udstiller generelt ikke data, der ikke kan nås via de almindelige getmetode.
  Dog kan der være statusvariable, der er udregnet på baggrund data der udstilles via den almindelige getmetode som vil findes i statusservice.
  Baggrunden er de almindelig getmetode skal kunne bruges alene, og status service blot et et supplement til disse for et givent forretningsdomæne

• Statusservice udstiller kun data ejet af det forretningsdomæne den tilhøre.
  Dog kan der være undtagelser, hvis der er specifikke grunde herfor
  Baggrunden er at et enkelte domæne er entydig ejer af egne data og derfor har ansvaret for at udstille disse. Data fra andre forretningsdomæner skal derfor hentes fra disse domæner enten via statusservice eller almindelig getmetoder i det givne domæne

• Statusservice er som udgangspunkt borgercentrisk
  Dog kan der tænkes andre udgangspunkt for statusservice f.eks. en virksomhed
  Baggrunden er statusservice skal give adgang til de aktuelle data for en given borger.

• Statusservice udstiller alle de af forretningsdomænet ejet data for en borger samlet og det er ikke muligt for serviceaftager at til eller af vælge dataelementer (Således som det er muligt vha. variables i PSS i dag)
  Dog er det jo altid mulig at benytte de almindelige getmetoder, hvis der kun ønske specifikke data på en borger
  Baggrunden er at et forretningsdomæne kun udstiller de data det domæne ejer og der derfor kun en delmængede at borgerenes data i hele DFDG, modsat PSS der udstiller alle data for hele DFDG. Date er grupperet forretningsmæssigt i forhold specifikke forretningsdomæner der er i en logisk sammenknytning.
  Er der situationer hvor en serviceaftager ikke har brug for hele det datasæt en statusservice returnerer, anvendes blot de almindelige getmetoder

• Statusservice udstiller ikke nødvendigvis alle dataattributter fra den almindelige getmetoder
  Baggrunden er at at den netop er en statusservice der giver den aktuelle status på de vigtigste data

• Statusservice udstiller ikke nødvendigvis alle data f.eks. historisk data på et dataelement.
  Hvis der finde en gethistorikmetode, kan en sådan anvendes til de historiske data
  Baggrunde at at den netop er en statusservice der giver den aktuelle status på de vigtigste data

• Statusservice vil kun udstille data til en given serviceaftager må se, dvs. dataelementer eller attributter der ikke er adgang til vil blive filtreret fra
  Baggrunde at også status service skal sikre at kun data som en serviceaftager har adgang til at se medtages.
  Det er i øvrigt de samme filtreringer der er på de almindelige getmetoder

• Fælles kæmpe status service tilsvarende den gamle PersonStatusService (PSS)
  STAR har ikke pt planer om en erstatning for PSS, en sådan ville dog kunne etableres i STAR nye arkitektur
  Baggrund en sådan kæmpe PSS vil have de samme preformance og andre udfordringer som den gamle PSS

1005.17.51.1 - Som STAR vil jeg have flyttet forretningsområdet borgerstamdata (statusservice) til forretningsdomænet (silo) BorgerKommunikation inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Da det er tale om en getmetoder er der ingen DB opgave

• Vi flytte dataelementer i statusservice efterhånden som de underliggende data flytter fra DFDG classec til forretningsdomænet

Acc.kr. 1005.17.51.2 - Som serviceaftager og STAR vil jeg have udstillet en personstatusservice i BorgerKommunikation via ny REST snitflade med samme operationer og filtrering som den eksisterende SOAP service (PersonStatsService i DFDG classic)

Løsningsmodel

• For hvert domæne etableres en statusservice, her domænte Borgerkommunikation. for indhold se Gennemgang af forretningsdomæner - STARs økosystem

• Da DFDG flyttes fra DFDG classic over til den nye domæne, over en længe periode

Note: En aftager har ønsket, at der i request kan angives for hvilke kollektioner, der ønskes returneret data. Dette ønske imødekommes ikke, da evt. behov for data for kun én eller få kollektioner kan opfyldes ved at aftager i stedet kalder Get-metoder på de enkelte forretningsservices.

Løsningsmodel

• Ny REST version 3 af servicen Borgerkommunikation.BorgerkommunikationStatusService

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

  • Ved systemkald skal - som i PSS - kunne læses data for alle borgere - og ikke kun for egne borgere

• Data i en ny version 3 (grøn tekst = udvidelse ift. v2)

  • Personnummer

  • Personstatus (fra CPR)

  • Navnestruktur

    • fornavne

    • mellemnavn

    • efternavn

  • Statsborgerskab (behov for at ændre til kollektion pga. dobbelt statsborgerskab?)

  • Indrejsedato

  • Bopælskommune

  • Jobcentertilknytning

    • JC kode

    • JC navn

    • Kommunekoder (som JC repræsenterer)

  • Personkommentater

    • [elementer ikke angivet her]

  • Gæsteadgange

    • [elementer ikke angivet her]

  • PersonCivilRegistrationIdentifierHistoryCollection

  • NordicCitizen

  • MaritalStatusCode

  • A-kassemedlemskab

  • AA-henvisninger

  • Samling af borgers evt. tidligere cpr nr

  • Adresse, herunder markering for evt. beskyttet adresse

  • Kontaktoplysninger

XXXXX.XXXXX LINK  

Ny REST service til udstillings af XXXXX .

XXXXX.XXXXX

Ny metode til at hente XXXXX

/wiki/spaces/GI/pages/1422590229

Service udgår

Acc.kr. 1005.17.51.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade

Løsningsmodel

• Eksisterende SOAP bevares som kalder mod ny getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2023-4.

XXXXX.XXXXX LINK

Udgår til fordel for XXXXX.XXXXX LINK. Servicen bevares som SOAP snitflade i en overgangsperiode til og med 202X-X, da der ikke forventes ændringer i den periode. 

PersonStatusService (Version 20, 2023-4)

Acc.kr. 1005.17.51.4 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til nye forretningsdomæne (silo)

Løsningsmodel (internt STAR acc.kr.)

• Initial load af data / Tilpasning af BI load til XXXXX domænet (silo)

• Data kommer fra VOA

Acc.kr. 1005.17.51.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 

Acc.kr. 1005.17.51.6 - Som STAR vil jeg have data er omfattet af dataløft og annonysering mod testmiljøer

Løsningsmodel (internt STAR acc.kr.)

• Tilpasning af regler af for anonymisering og aftale hvornår data skal med i dataløft

• Systemforvalter til retter anonymiseringsflow 

Acc.kr. 1005.17.51.7 Ydelsesudstilling udstiller kodelisterne ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList i Ydelsesudstilling.CodeListService

Løsningsmodel 

• DFDG udstille kodelister for XXXXX 

XXXXX.XXXXX LINK

Kodeliste flytte 1 til 1 fra SustenanceHistoryCategoryTypeIdentifier

Acc.kr. 1005.17.1.8 /wiki/spaces/GI/pages/3690397697 udstiller ikke mere XXXXX . I stedet returneres en tom liste

/wiki/spaces/GI/pages/3690397697

GetVariablePersonStatus

Udstiller ikke mere XXXXX. I stedet returneres en tom liste

Acc.kr. 1005.17.1.9 XXXXX modtager persondata ved håndtering af BorgerstamdataOpdateretEvent.

Løsningsmodel (internt STAR acc.kr.)

• XXXXX modtager persondata via ny event receiver 

Acc.kr. 1005.17.1.10 Død kode i DFDG, i forbindelse med forsørgelseshistorik, fjernes

Løsningsmodel (internt STAR acc.kr.)

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

Acc.kr. 1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i XXXXX, i stedet for XXXXX

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug XXXXX ved brug af nyt ClientApi fra XXXXX.

• Kode brugt i forbindelse med XXXXX er fjernet fra LSS

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 Ydelsesudstilling 

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

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

•  Ja, det er tjekket, at epic ikke indeholder dette.

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

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

XXXXX

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

XXXXX