Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Oprydning, da ingen SOAP-REST converter eller WSRM-overgangsperiode, jf. versionskommentar 16.11.2024 og orangebrune tekst med opmærksomhedspunkter

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

2025-2


2025-2

2025-2

0.3

KSS, A-kasser, Converter

Indgår i tilsagn:

  • 2024-4, bølge 2

  • 2025-1, bølge 1

  • 2025-2, bølge 1

Ekstern aftager skal være opmærksom på at

  • Tilgængeligt i test for udvikling og seneste ibrugtagning er samme release

  • Der ikke er SOAP- REST konverter

  • WSRM udfases og der kun er WSB'er
    Det betyder at DFDG leverer til ekstern aflevering og serviceaftager skal tage funktionaliteten i brug i den nævnte release

...

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

12-02-2024

0.1

Carsten Olsen

Release flyttet til 2024-3

09.08.2024

0.3

Knud de Place

Release flyttet til 2024-4. v0.3.

19.08.2024

0.3

Jesper Brunholm

Release flyttet til 2025-1

01.11.2024

0.3

Knud

Tidligste ibrugtagning ændret til 2025-2

16.11.2024

0.3

Knud

Ingen converter

19.01.2025

0.3

Knud

Udfyldt Særlige krav til test

20.02.2025

0.3 K

Knud

Oprydning, da ingen SOAP-REST converter eller WSRM-overgangsperiode, jf. versionskommentar 16.11.2024 og orangebrune tekst med opmærksomhedspunkter

Interne links (indhold i links ikke relevant for eksterne)

...

Afgrænsning

Som serviceaftager og STAR

vil jeg have løftet servicesnifladerne for borgeres kontaktdata og huskeservice 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.30.1

Som STAR vil jeg have flyttet forretningsområdet borgeres kontaktdata og huskeservice til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper, der er fastsat

Plan, BI, (Kontaktforløb)



1005.17.30.2

Som serviceaftager og STAR vil jeg have udstillet huskeservice og borgeres egne kontaktinformationer via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service

Plan, (Kontaktforløb)


1005.17.30.3

Udgår - ingen converter

Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade 

DFDG, Jobsøgning-Jobnet (classic)

20.02.2025: Ingen converter

1005.17.30.4

Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne

BI


1005.17.30.5

Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet

Plan, (Kontaktforløb)


1005.17.30.6

Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer 

Plan, SF


1005.17.30.7

Forretningsdomænet BorgerKommunikation udstiller kodelisterne, der anvendes i HuskeService og til borgers kontaktinformation

Plan, (Kontaktforløb)


1005.17.30.8

/wiki/spaces/GI/pages/3690397697 udstiller ikke mere oplysninger om Huskeserviceabonnementer og borgers kontaktinformation - i stedet returneres fra 2025-2 en tom liste

Plan, (Kontaktforløb)


1005.17.x.9

XXXXX modtager XXXXX ved håndtering af XXXXXEvent.

Plan, (Kontaktforløb)



1005.17.30.11

Død kode i DFDG (classic), i forbindelse med HuskeService og borgers kontaktinformation, fjernes

Plan, (Kontaktforløb)


1005.17.x.12

Landssupport/LSS er skiftet over til at brug den nye REST-servicen i BorgerKommunikation, i stedet for PersonNotificationReminderService og evt. PersonRegistrationService fra DFDG classic

Plan, (Kontaktforløb)


1005.17.30.12

WSRM og WSB på borgeres kontaktdata udsendes

Plan, (Kontaktforløb)

...

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger


1005.17.30.2

1005.17.30.3

1005.17.30.8

1005.17.30.12


Som KSS skal jeg overgå til ny REST snitflade, men kan i en overgangsperiode fortsat anvende SOAP-versionen

X

X



20.02.2025: Ingen converter

Som bruger af PersonStatusService vil jeg skifte til REST snitflade og kald til BorgerKommunikationStatusService (ny version 3) for at hente oplysninger om borgers kontaktoplysninger i form af e-mail og telefonnummer samt status for tilmelding til huskeservice



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

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.

KSS og a-kasse skifter fra WSRM til WSB i forhold til besked om opdateringer til borgers kontaktoplysninger i form af e-mail og telefonnummer samt status for tilmelding til huskeservice

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

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1).CreateKontaktinformation (POST /v1/kontaktinformation)

Ny

Ny metode til at registrere borgeres kontaktinformation. Fx mobilnr. og e-mailadresse.

A-kasse, KSS

Jobnet

Plan

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1)GetVerfikationskode (GET /v1/kontaktinformation/verifikationskode)

Ny

Ny metode til at hente ny verifikationskode.

A-kasse(f), KSS(f)

Jobnet

Plan

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1).UpdateKontaktinformation (POST /v1/kontaktinformation/verificering)

Ny

Ny metode til at verificere borgeres kontaktinformation.

A-kasse(f), KSS(f)

Jobnet

Plan

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1).GetKontaktinformation (GET /v1/kontaktinformation/emailaddresse/{email})

Ny

Denne metode udsøger borgere, der er tilmeldt huskeservice med en given e-mailadresse og den periode personen har været tilmeldt med den pågældende e-mailadresse.  Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger.

A-kasse(f), KSS(f)

N/A

Plan

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1).GetKontaktinformation (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

Ny

Denne metode udsøger borgere, der er tilmeldt huskeservice med et givet mobilnummer og den periode personen har været tilmeldt med det pågældende mobilnummer. Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger.

A-kasse(f), KSS(f)

N/A

Plan

Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (version 1).UpdateKontaktinformation (POST /v1/kontaktinformation/status)

Ny

Denne metode giver DFDG mulighed for at ændre status (kontaktdatastatus) på en borgers mailadresse eller mobiltelefonnummer

N/A

N/A

Plan

Borgerkommunikation.HuskeService (Version 1).CreateAbonnement (POST /v1/abonnement)

Ny

Denne metode opretter, ændrer eller sletter en borgers abonnementer i huskeservice. Der skal leveres alle abonnementer med ved opdatering ellers opfattes det som en sletning.

A-kasse, KSS

Jobnet

Plan

Borgerkommunikation.HuskeService (Version 1).GetAbonnement (GET /v1/abonnement/historik)

Ny

Ny metode. Denne metode benyttes til at hente historiske kontaktoplysninger samt en kollektion, der specificerer en borgers abonnement til huskeservice.

A-kasse, KSS

Jobnet

Plan

Borgerkommunikation.HuskeService (Version 1).GetAbonnement (GET /v1/abonnement)

Ny

Ny metode. Denne metode benyttes til at hente kontaktoplysninger samt en kollektion, der specificere en borgers abonnement til huskeservice.

A-kasse, KSS

Jobnet

Plan

BorgerkommunikationStatusService (version 3).GetPersonKommunikationStatus (GET /v3/BorgerkommunikationStatus)

Ny

Ny version 3 med ny kollektion om borgers e-mail og telefonoplysninger. Endvidere ændring til udstilling af borgers kommunetilhørsforhold

A-kasse, KSS

N/A

Plan

Borgerkommunkation.Codelists.KontaktdataCodeList

Ny

Ny kodeliste i Borgerkommunikation

A-kasse, KSS

N/A

Plan

Borgerkommunkation.Codelists.KontaktdataStatusCodelList

Ny

Ny kodeliste i Borgerkommunikation

A-kasse, KSS

N/A

Plan

BorgerKontaktinformation.WSB

Ny

WSB dannes når der er ændringer til borger e-mailadresse eller telefonnummer

A-kasse, KSS

SF

Plan

JobnetPersonNotificationReminderService (version 1).Alle

Ny

Udgår til fordel på ny REST-service.

A-kasse, KSS

Jobnet

Plan

PersonCommunicationStatusService (version 1).GetPersonCommunicationStatus

Udgået

Metoden udgår. Ser ikke ud til at blive kaldt af a-kasser, Fasit eller Momentum

N/A

N/A

Plan

PersonNotificationReminderService (version 1).Alle

Ny

Udgår til fordel på ny REST-service.

A-kasse, KSS

Jobnet

Plan

PersonStatusService (version 20).GetVariablePersonStatus

Udgået

Elementerne PersonContactInfoData og PersonNotification består indtil 2025-2, hvorefter de vil returnere tomme lister

N/A

N/A

Plan

WsrmMessageservice (version 10).GetPersonContactInfo

Ny

Erstattes af BorgerKontaktinformation. WSRM-beskeden kan ikke benyttes i en overgangsperiode.

A-kasse, KSS

SF

Plan

...

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 Kontaktinformation og HuskeService 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.

Der er ikke regler om jobcentres og a-kassers registrering af kontaktoplysninger på borgere eller om tilmelding til huskeservice.

...

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, men kan i en overgangsperiode (indtil 2025-1) 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.

...

  • Nye REST services med Create- og Get-metoder i Borgerkommunikation

  • Fejlkoder bevares, dog kommer der også nye fejlkoder

  • Der ændres ikke i adgangsforhold til service/metoder, dog udgår de specifikke metoder, der var lavet af hensyn til Jobnet (classic).  

Borgerkommunikation.

...

BorgerKontaktinformationService (

...

2025-

...

2)

CreateKontaktinformation (POST /v1/kontaktinformation)

...

Erstatter PersonNotificationReminderService (Version 1, 2020-3).SavePersonContactStatus)

/wiki/spaces/FYS/pages/4397334529

CreateAbonnement (POST /v1/abonnement)

...

Info

NB. Ændringen vedr. kommuneelementet er også omtalt i 1005.17.29 Midlertidig adresse (Temporær adresse), så det bliver kommunikeret så tidligt som muligt til aftagerne uafhængigt af om E 1005.17.29 eller E 1005.17.30 kommer til tilsagn først.

1005.17.30.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 (20.02.2024 udgår)

Løsningsmodel

  • Eksisterende SOAP bevares som kalder mod ny getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2025-2 for de berørte services, jf. nedenfor. Dog ikke for PersonCommunicationStatusService.GetPersonCommunicationStatus, der ikke ser ud til at blive kaldt af a-kasser, Fasit eller MomentumMomentum.

PersonCommunicationStatusService (version 1)

Metoden GetPersonCommunicationStatus udfases (uden forudgående SOAP-REST converter). Ser ikke ud til at blive kaldt af a-kasser, Fasit eller Momentum.

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).CreateKontaktinformation (POST /v1/kontaktinformation)

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).GetKontaktinformation (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).GetKontaktinformation (GET /v1/kontaktinformation/emailaddress/{email})

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).UpdateKontaktinformation (POST /v1/kontaktinformation/status)

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).CreateKontaktinformation (POST /v1/kontaktinformation)

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).UpdateKontaktinformation (POST /v1/kontaktinformation/verifisering)

...

Erstattes af Borgerkommunikation.BorgersKontaktinformationService BorgerKontaktinformationService (20242025-32).GetVerfikationskode (GET /v1/kontaktinformation/verfikationskode)

...

  • Initial load af data / Tilpasning af BI load / konvertering til Borgerkommunkation domænet

1005.17.30.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet

...

  • Servicesnitflade 

1005.17.30.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer

...

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

  • Systemforvalter tilretter pseudonymiseringsflow 

1005.17.30.7 Borgerkommunikation udstiller kodelisterne, der anvendes i HuskeService og til borgers kontaktinformation

...

Kodeliste flytte 1 til 1 fra DFDG (classic)

1005.17.1.8 - /wiki/spaces/GI/pages/3690397697 udstiller fra 2025-2 ikke mere huskeserviceabonnementer og borgers tlf og e-mailadresse . I stedet returneres tomme lister

...

  • PersonNotification - Giver PersonNotificationInfo collection: Huskeserviceabonnementer

  • PersonContactInfoData - Giver PersonContactInfoData collection: Huskeservice kontaktinformation

I stedet returneres fra 2025-2 tomme lister

1005.17.1.9 - XXXXX modtager persondata ved håndtering af BorgerstamdataOpdateretEvent.

...

  • XXXXX modtager persondata via ny event receiver 

1005.17.1.10 - Død kode i DFDG, i forbindelse med borgers kontaktdata og Huskeservice, fjernes

Løsningsmodel (internt STAR acc.kr.)

...

  • Landssupport/LSS er skiftet til at brug Huskeservice og BorgerKontaktinformationService ved brug af nyt ClientApi fra Borgerkommunikation.

  • Kode brugt i forbindelse med følgende er fjernet fra LSS

    • PersonCommunicationStatusService (version 1).GetPersonCommunicationStatus

    • PersonStatusService (version 20).GetVariablePersonStatus - elementerne

      • PersonNotification - Giver PersonNotificationInfo collection: Huskeserviceabonnementer

      • PersonContactInfoData - Giver PersonContactInfoData collection: Huskeservice kontaktinformation

    • PersonNotificationReminderService (Version 1)

1005.17.30.12 - WSRM og WSB på borgeres kontakdata udsendes

...

  • Ny WSB etableres

  • Eksisterende WSRM bevares ikke i overgangsperiode og serviceaftager kan frit flytte i overgangsperioden fra WSRM til WSB.

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

...

Udgår til fordel for WSB BorgerKontaktinformation.WSB (2025-1). GetPersonContactInfoVersion1 bevares ikke i en overgangsperiode.

EksternKommunikation.EntityTypeCodeList

...

  • 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

(19.01.2025)

Test scenarie

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

Identificeret af

Borgers valg af huskeservice kan udlæses af sagsbehandler

Se berørte services


Sagsbehandlers registrering for borger kan ses på Jobnet


Se berørte services


Afhængigt af borgers valg af sms / e-mail dannes de relevante huskeservice beskeder på sms eller mail



* 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

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

...