Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Opdateret modelbeskrivelse (under “Generel model om og anvendelse af statusservice inkl. i relation til almindelige get-metoder”) på baggrund af tlf bemærkninger fra KMD om at beskrivelsen ikke helt afspejler ændringer til at servicen udstiller kollektioner som PSS. Konsekvensændret under AC-2.

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.

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

10.11.2023

0.3

Knud de Place

På baggrund af spg fra FOA præciseret at BorgerKommunikationStatusService (v1) forbliver i live (FB 402694)

29.11.2023

0.3

Knud de Place

På baggrund af tilsagnskommentarer er der under AC-3 tilføjet oplistning af kollektioner, der fra 2024-1 vil være tomme i PSS, og hvilke der ikke påvirkes af denne epic (frem for, at der alene var henvisning til farvemarkeringer af kollektioner på en underside).

30.11.2023

0.3

Knud

På baggrund af ændringer 29.11.2023 kommer epic også med i bølge 3 2024-1 tilsagn.

18.12.2023

0.3

Jesper Brunholm, Carsten Olsen

Pba. dialog med eksterne laves StatusService med collections, dette er beskrevet under 1005.17.51.2

19.12.2023

0.3

Knud

(f) / frivillig fjernet som markering på baggrund af tilsagnsbem fra KMD

02.01.2024

0.5

Knud

v0.5. Ikke andre ændringer.2024

0.5

Knud

v0.5. Ikke andre ændringer

04.01.20224

0.5

Knud

Opdateret modelbeskrivelse (under “Generel model om og anvendelse af statusservice inkl. i relation til almindelige get-metoder”) på baggrund af tlf bemærkninger fra KMD om at beskrivelsen ikke helt afspejler ændringer til at servicen udstiller kollektioner som PSS. Konsekvensændret under AC-2.

Interne links (indhold i links ikke relevant for eksterne)

...

Afgrænsning

Som serviceaftager og STAR

vil jeg have løftet servicesnifladerne for borgerstamdata i PersonStatusService til forretningsdomænet (silo) BorgerKommunikation 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

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

DFDG, BI


1005.17.51.2

Som serviceaftager og STAR vil jeg have udstillet en personstatusservice i BorgerKommunikation via ny REST snitflade med Get-operationer og filtrering som den eksisterende SOAP service (PersonStatusService i DFDG classic) med variabelt output af collections

DFDG

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyKON-94

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyKON-685

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyKON-1076

1005.17.51.3

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

  • Er uændret for de data, der ikke er flyttet til den nye domænestatus service (dem med blå i Borgerkommunikation.BorgerkommunikationStatusService (Version 2, [UDV] 2024-1) ), dvs. PSS er i 2024-1 uændret for

    • temporær adresse (indenlandsk og udenlandsk)

    • borgerKontaktdata (PersonContactDataInfo)

    • Borgerbeskedbakke (CitizenMessageInfo)

    • huskeserviceabonnement (PersonNotificationInfo)

    • akassemedlemsskab (UnemploymentFundInfo)

    • persongruppetilknytninger (PersonGroupMarkingInfo)

  • Ikke mere udstiller udstiller de flyttede dataelementer (dem med grøn i Borgerkommunikation.BorgerkommunikationStatusService (Version 2, [UDV] 2024-1), dvs. PSS fra 2024-1 ikke mere udstiller

    • køn (PersonGenderCode)

    • nordisk borger (NordicCitizen)

    • civilstatus (MaritalStatusCode)

    • personnummerHistorik (PersonCivilRegistrationIdentifierHistoryCollection)

    • navne- og adressebeskyttelse

    • adresse

    • boernUnder18 (FamilyMemberCollection)

    • anden aktør henvisningsperioder

    • personFagprofessionelKontakt (PersonContactType)

for at sikre at jeg har de relevante statusdata tilgængelige.

DFDG, Jobnet


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

DFDG


1005.17.51.5

1005.17.1.5 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i borgerkommunikation, parallelt med PSS

DFDG


1005.17.51.6

Som borger på Jobnet (classic) kan de flyttede statusdata stadig anvendes

Jobnet

...

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger


1005.17.51.2

1005.17.51.3



Som A-kasse og KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen, dog for PSS’en uden de dataelementer der er flyttet til den nye GetPersonKommunikationStatus (GET /v1/BorgerkommunikationStatus).

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)

X

X




Som bruger af PersonStatusService vil jeg skifte til REST snitflade og kald til GetPersonKommunikationStatus (GET /v1/BorgerkommunikationStatus)for at hente

  • Forretningsområde - Borgerstamdata - etableret i tidligere release

  • Forretningsområde - Gæsteadgang - etableret i tidligere release

  • Forretningsområde - Personkommentar - etableret i tidligere release

  • 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

Bemærk de øvrige områder kommer i senere releases

X




...

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

Varslingstype

Varslingsnote

Eksterne snitflader

Interne snitflader

Project

BorgerkommunikationStatusService (Version 1).GetPersonKommunikationStatus

Andet

Version 1 forbliver i live

A-kasse(t.o.), KSS(t.o.)

N/A

Kontaktforløb

BorgerkommunikationStatusService (Version 2).GetBorgerNemSMSabonnement (GET /v1/NemSMSabonnement)

Ny

Flytning af eksisterende SOAP metode til denne REST metode (Det er kun STAR der har adgang til denne)

A-kasse(f), KSS(f)

N/A

Kontaktforløb

BorgerkommunikationStatusService (Version 2).GetPersonKommunikationStatus (GET /v1/BorgerkommunikationStatus)

Ændret

Version 2 af statusmetode nu med Borgerstamdata /øvrige oplysninger/Personhistorik /adresseBørn /Anden Aktør forløb/Fagprofessionel kontakt/Personkommentar

A-kasse(f), KSS(f)

N/A

Kontaktforløb

PersonStatusService (Version 20).GetVariablePersonStatus

Andet

De berørte dateelementer er varslet i forbindelse med øvrige epic 1005.17.x, generelt vil de returnere tomme collections

A-kasse, KSS

N/A

Kontaktforløb

...

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. 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 en overgangsperiode indtil PersonStatusService endelig udfasses vil de resterende dataelementer stadig kunne tilgås på PSS, indtil dataelementet flyttes. En sådan flytning varsles separat.

...

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

  • Statusservice udstiller kun data ejet af det forretningsdomæne den tilhø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 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 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 get-metoder i forretningsservicerne, hvis der kun ø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æ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 get-metoder i forretningsservicerne

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

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

...

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 - BorgerkommunikationStatusService (2024-1)

...

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

...

Service og metode beholdes, men uden data i de dataelemneter, der er i den nye V2 af BorgerkommunikationStatusService (2024-1). 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.

...

Test scenarie

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

Identificeret af

Test af at a-kasserne kan læse data for egne medlemmer

  • test af positive scenarier (data som a-kassen må læse)

  • test af negative scenarier (data som a-kassen ikke må læse)




Test af at der kan kaldes som System og læses data på tværs af jobcentre uden at bruge gæsteadgang






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


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

Se regler underPersonStatusService (Version 20, 2023-4)

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

...