Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning Page Properties

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

Jesper Brunholm

2024-1

2024-1

Frivillig da der er ny service. Bemærk dog at dele af PersonStatusService er udfaset for de berørte dataelementer

0.1

KSS, A-kasser

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?

...

14.10.2022

...

0.1

...

Carsten Olsen

...

Oprettelse

...

08.06.2023

...

0.1

...

Jesper Brunholm

...

Tilføjelse af personnummerhistorik

...

01.11.2023

...

0.3

...

Carsten Olsen

...

Klargøring til tilsagnsproces

Interne links (indhold i links ikke relevant for eksterne)

Jira LegacyserverSystem JIRAserverId479d1618-4a6f-3f88-8ee1-04c6b02c448akeyKON-1075Beskrivelse 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)

Indholdsfortegnelse

...

Afgrænsning af epic

...

...

...

Indholdsfortegnelse

Afgrænsning af epic

...

...

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)

...

Summary

...

fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

Automatisk oversigt

...

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 statusserviceer tale om GET metoder på en statusservice. Ift. a-kasserne gælder dog, at der er regler om, hvad a-kassen skal læse i DFDG ifm. fx tilmelding som jobsøgende og medlemstilgang (databkg. § 129, stk. 3 - bkg. nr. 1220 af 28. september 2023).

OBS:

• Det konkrete indhold i statusservice og de enkelte dataelementer skal endelig afklares med

...

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

Generel model om og anvendelse af

...

statusservice inkl. i relation til almindelige

...

get-metoder

• Statusservice udstiller generelt ikke data, der ikke kan nås via de almindelige getmetodeget-metoder på forretningsservicerne i de enkelte forretningsdomæner.
  Dog kan der væreborgerstamdata og statusvariable, der er udregnet på baggrund data, der udstilles via den almindelige getmetode get-metode, som vil findes i statusservice.
  Baggrunden er at de almindelig getmetode get-metoder skal kunne bruges alene, og status service statusservice blot er et et supplement til disse for et givent forretningsdomæneforretningsdomæne, bortset fra visse borgerstamdata, der alene findes i statusservice

• Statusservice udstiller kun data ejet af det forretningsdomæne den tilhøretilhører.
  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 almindelige get-metoder 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, at 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, men det er muligt og det er ikke muligt for serviceaftager at til- eller af vælge fravælge dataelementer / kollektioner (Således således som det er muligt vha. variables i PSS i dag)
  Dog er det jo altid fortsat også mulig at benytte de almindelige getmetoderget-metoder i forretningsservicerne, hvis der kun ønske ønskes specifikke forrretningsdata 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 delmængde af 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 get-metoder i forretningsservicerne

• Statusservice udstiller ikke nødvendigvis alle dataattributter fra den de almindelige getmetoderget-metoder
  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 Baggrunden er 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 som aftagertypen må se, dvs. Dvs. dataelementer eller attributter, der ikke er adgang til, vil blive filtreret fra i serviceoutput.
  Baggrunde Baggrunden er at også status service statusservice skal sikre, at kun data som en serviceaftager har må have adgang til at se, medtages.
  Det er i øvrigt de samme filtreringer, der er på de almindelige getmetoderget-metoder.

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

...

Løsningsmodel (internt STAR acc.kr.)

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

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

• Ny REST version (2) 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

...

• • Der kan opnås Gæsteadgang til alle metoder og alle kollektioner

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 (

...

PersonStatusService i DFDG classic)

Løsningsmodel

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

• Da DFDG data flyttes fra DFDG (classic) over til den de nye domæne, domæner over en længe længere periode

Note: En aftager Flere aftagere 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. se Generel model om og anvendelse af statsusservice inkl. i relation til almindelige getmetoder

BorgerkommunikationStatusService

...

- /wiki/spaces/GI/pages/4172152860

Henter generelle stamdata om en borger, herunder navn, adresse, kontaktinformationer, jobcenter og a-kasse tilknytning ud i varable collections.

Der etableres en ny version 2 af service

GetPersonKommunikationStatus (GET /v2/BorgerkommunikationStatus)

Metoden udvides med følgende dataelementer

• Forretningsområde - Borgerstamdata/øvrige oplysninger - etableres i 2024-1

• Forretningsområde - Borgerstamdata/Personhistorik - etableres i 2024-1

• Forretningsområde - Borgerstamdata/adresse - etableres i 2024-1

• Forretningsområde - Borgerstamdata/Børn - etableres i 2024-1

• Forretningsområde - Anden Aktør forløb - etableres i 2024-1

• Forretningsområde - Fagprofessionel kontakt - etableres i 2024-1

• Forretningsområde - Personkommentar - etableres i 2024-1

Forretningsregler

• Flitrering i forhold til serviceaftager
  Regelsæt følger PSS og dokumentation er endnu ikke flyttet. Indtil dette sker kan dokumentationen findes her

  • A-kasser, herunder filtrering af output

    • A-kassers adgang til aktuelle oplysninger

    • A-kassers adgang til historiske oplysninger

    • Flere medlemsperioder i samme a-kasse

    • Særregler for a-kassers adgang til oplysninger

  • Filtrering af indhold og udfasede collections

  • Filtrering i andre services

GetBorgerNemSMSabonnement (GET /v2/NemSMSabonnement)

Intern STAR metode.

Henter information om hvorvidt en borger er tilmeldt NemSMS eller ej.

Acc.kr. 1005.17.51.3 Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service /wiki/spaces/GI/pages/3690397697

PersonStatusService (Version 20, 2023-4)

GetVariablePersonStatus

Løsningsmodel

Service og metode beholdes, men uden data i de dataelemneter der er i den nye V2 af BorgerkommunikationStatusService (2024-1).
Bemærk at udfasning af disse dataelementer er varslet i forbindelse med det tidligere epic der etablere de nye REST forretningsservice og er derfor ikke varslet i forbindelse med denne epic.

Acc.kr. 1005.17.51.4 - 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.1.5 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i borgerkommunikation, parallelt med PSS

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til også at brug GetPersonKommunikationStatus (GET /v1/BorgerkommunikationStatus) ved brug af nyt ClientApi.

• Kode brugt i forbindelse med eksisterende PSS bevares i LSS for nuværende

1005.17.51.6 Som borger på Jobnet (classic) vil jeg de flyttede statusdata stadig anvendes

Løsningsmodel (internt STAR acc.kr.)

• I det omfang Jobnet classic anvender data fra PSS / JSCC der berøres skal disse hentes fra ny REST service

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

...

Test scenarie

...

Berørte systemområder (herunder nye batchjobs*) 

...

.

Version 1 forbliver i live i overgangsperiode (udfasning vil ske i kommende epic - når en evt. kommende v3 skal etableres)

Collections i den nye version (dem med grå er planlagte og kommer først i en senere release) :

• personstatusstruktur (personnummer, personstatus, køn, navn, nordisk statsborgerskab, ægteskabelig status, statsborgerskab og immigrationsdato)

• personkommentarer

• gaesteadgang

• personnummerHistorik

• adresse (temporær adresse, navne- og adressebeskyttelse)
  (temporær adresse kommer i senere udgave)

• boernUnder18

• andenaktoerhenvisning

• personFagprofessionelKontakt

• borgerKontaktdata

• borgerbeskedbakke (kommer i senere udgave)

• huskeserviceabonnement (kommer i senere udgave)

• akassemedlemsskab (kommer i senere udgave)

• persongruppetilknytninger (kommer i senere udgave)

Metoden GetPersonKommunikationStatus - GetPersonKommunikationStatus (GET /v2/BorgerkommunikationStatus)

Metoden udvides med følgende dataelementer

• Forretningsområde - Borgerstamdata/øvrige oplysninger - etableres i 2024-1

• Forretningsområde - Borgerstamdata/Personhistorik - etableres i 2024-1

• Forretningsområde - Borgerstamdata/adresse - etableres i 2024-1

• Forretningsområde - Borgerstamdata/Børn - etableres i 2024-1

• Forretningsområde - Anden Aktør forløb - etableres i 2024-1

• Forretningsområde - Fagprofessionel kontakt - etableres i 2024-1

Forretningsregler

• Filtrering i forhold til serviceaftager
  Regelsæt følger PSS og dokumentation er endnu ikke flyttet til forretningssiden for den nye statusservice. Indtil dette sker kan dokumentationen findes her

  • A-kasser, herunder filtrering af output

    • A-kassers adgang til aktuelle oplysninger

    • A-kassers adgang til historiske oplysninger

    • Flere medlemsperioder i samme a-kasse

    • Særregler for a-kassers adgang til oplysninger

  • Filtrering af indhold og udfasede collections

  • Filtrering i andre services

Metoden GetBorgerNemSMSabonnement - GetBorgerNemSMSabonnement (GET /v2/NemSMSabonnement)

Intern STAR metode.

Henter information om hvorvidt en borger er tilmeldt NemSMS eller ej.

1005.17.51.3 Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service /wiki/spaces/GI/pages/3690397697

/wiki/spaces/GI/pages/4134109369

GetVariablePersonStatus

Løsningsmodel

Service og metode beholdes, men uden data i de dataelemneter, der er i den nye V2 af /wiki/spaces/GI/pages/4172152860. Følgende udgår af PSS i 2024-1:

• køn (PersonGenderCode)

• nordisk borger (NordicCitizen)

• civilstatus (MaritalStatusCode)

• personnummerHistorik (PersonCivilRegistrationIdentifierHistoryCollection)

• adresse

• navne- og adressebeskyttelse

• boernUnder18 (FamilyMemberCollection)

• anden aktør henvisningsperioder (ExternalOperatorReferralInfo)

• personFagprofessionelKontakt (PersonContactType)

Bemærk at udfasning af disse dataelementer er varslet i forbindelse med tidligere epics, der etablerede de nye REST forretningsservice og er derfor ikke varslet i forbindelse med denne epic.

1005.17.51.4 - 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.1.5 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i borgerkommunikation, parallelt med PSS

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til også at brug GetPersonKommunikationStatus (GET /v1/BorgerkommunikationStatus) ved brug af nyt ClientApi.

• Kode brugt i forbindelse med eksisterende PSS bevares i LSS for nuværende

1005.17.51.6 Som borger på Jobnet (classic) vil jeg de flyttede statusdata stadig anvendes

Løsningsmodel (internt STAR acc.kr.)

• I det omfang Jobnet classic anvender data fra PSS / JSCC der berøres skal disse hentes fra ny REST service

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

...

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

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

Se regler underPersonStatusService (Version 20, 2023-4) /wiki/spaces/GI/pages/4134109369

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

...