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

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.

Interne links (indhold i links ikke relevant for eksterne)

https://starwiki.atlassian.net/browse/KON-792

https://starwiki.atlassian.net/browse/BI-2493

Indholdsfortegnelse

Afgrænsning af epic

Pakke HUSK-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.

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

Borgere med krav til søgbart CV skal dog enten have oplyst e-mailadresse eller telefonnummer, jf. BAB § 32, stk. 2.

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.

1005.17.30.1 - Som STAR vil jeg have flyttet forretningsområdet borgeres kontaktdata og huskeservice 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

• Mapningsark til BI til brug for konvertering

1005.17.30.2 - Som serviceaftager og STAR vil jeg have udstillet borgers kontaktoplysninger og oplysninger om huskeservice via nye REST snitflader med samme forretningslogik og operationer som de eksisterende SOAP services

Løsningsmodel

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

• Ny REST service til at verficerer email (kun til intern STAR brug)

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

Denne metode opdaterer borgeres kontaktinformation. Disse omfatter p.t. mobiltelefon, fastnet telefon og mailadresse.

Udvidede forretningsregler i forhold til eksisterende

• Hvis kontaktdatatype angives med NULL i kontaktinformation valideres, om borger er pligtig til at have et søgbart CV (jobparate borgere), i givet fald fås en fejl.
  Valideringen sikrer, at borger eller andre ikke kan slette kontaktinformation, der er en forudsætning for at have et søgbart CV (der er set eksempler på dette i prod. hvor sagsbehandlere har slettet kontaktoplysninger med det resultat, at borgers cv er gjort ikke-søgbart)

Erstatter PersonNotificationReminderService (2020-3).PersonNotificationReminderService (2020-3) og JobnetPersonNotificationReminderService (2020-1).SavePersonContactData

(Slettet) GetKontaktinformationMobilNr (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

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. 

Metoden laves ikke da vi ikke kan vide hvilket mobiltelefonnummer NemSMS har sendt huskeservice til.

Erstatter https://starwiki.atlassian.net/wiki/spaces/GI/pages/4592828547.GetPersonByMobilePhoneNumber)

GetKontaktinformationEmail (GET /v1/kontaktinformation/emailaddress/{email})

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. 

(Slettet) UpdateKontaktinformation (POST /v1/kontaktinformation/status)

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

Metoden laves ikke da der ikke længere er forretningsmæssigt behov for den

Erstatter https://starwiki.atlassian.net/wiki/spaces/GI/pages/4592828547.SavePersonContactStatus)

Eksternkommunikation.KontaktinformationVerifikationService (2025-2)

KontaktinformationVerifikationsService giver STAR mulighed for at få borger til at verificere sin email-adresse.

CreateVerifikationskode (POST /v1/verifikationskode/email)

Metode til at oprette og sende en email verifikationskode til en email.

Erstatter JobnetPersonNotificationReminderService (Version 1, 2020-1).VerifyPersonContactData)

GetKontrollerVerifikationskode (Get /v1/KontrollerVerifikationskode/email)

Denne metode kontrollerer om en verfikationskode er valid for borgers email.

Erstatter JobnetPersonNotificationReminderService (Version 1, 2020-1).RequestNewVerificationCode)

Borgerkommunikation.HuskeserviceService (2025-2)

CreateAbonnement (POST /v1/abonnement)

Denne metode opretter, ændrer eller sletter en borgers abonnementer i huskeservice. Der skal leveres alle abonnementer med ved opdatering da ikke-medsendte slettes. 

Erstatter https://starwiki.atlassian.net/wiki/spaces/GI/pages/1887339116 SavePersonNotificationData og JobnetPersonNotificationReminderService (Version 1, 2020-1).SavePersonNotificationData.

GetAbonnement (GET /v1/abonnement)

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

Erstatter https://starwiki.atlassian.net/wiki/spaces/GI/pages/4592828547.GetPersonContactAndNotificationData

GetAbonnement (GET /v1/abonnement/historik)

Denne metode benyttes til at hente historiske kontaktoplysninger samt en kollektion med borgers abonnement til huskeservice.

Erstatter https://starwiki.atlassian.net/wiki/spaces/GI/pages/4592828547.GetPersonContactAndNotificationDataHistory

BorgerkommunikationStatusService (2025-2) (Version 4)

Borgerkommunikation.BorgerkommunikationStatusService (Version 4, [UDV] 2025-2)

I regi af denne epic ændres BorgerkommunikationStatusService (med ny version 4) således:

• Metoden GetBorgerkommunikationStatus udvides med borgerKontaktInformation og huskeservice. Erstatter PersonNotification og PersonContactInfoData i PersonStatusService (2024-2)

• Udstillingen af borgers kommunetilhørsforhold i kommune-elementet ændres, så alene kommunenr. 101-861 udstilles - og således ikke længere grønlandske kommunenr., 999 eller 9999

Kommune-elementet vil returnere en tom liste hvis borgers kommunenr. er uden for intervallet 101-861

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

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.

PersonStatusService (version 20)

PersonNotification

Giver PersonNotificationInfo collection: Huskeserviceabonnementer

PersonContactInfoData

Giver PersonContactInfoData collection: Huskeservice kontaktinformation

PersonNotificationReminderService (Version 1)

SavePersonNotificationData

Erstattes af Borgerkommunikation.HuskeserviceService (2025-2).CreateAbonnement (POST /v1/abonnement)

SavePersonContactData

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).CreateKontaktinformation (POST /v1/kontaktinformation)

GetPersonContactAndNotificationData

Erstattes af Borgerkommunikation.HuskeserviceService (2025-2).GetAbonnement (GET /v1/abonnement)

GetPersonContactAndNotificationDataHistory

Erstattes af Borgerkommunikation.HuskeserviceService (2025-2).GetAbonnement (GET /v1/abonnement/historik)

GetPersonByMobilePhoneNumber

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).GetKontaktinformation (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

GetPersonByEmailAddress

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).GetKontaktinformation (GET /v1/kontaktinformation/emailaddress/{email})

SavePersonContactStatus

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).UpdateKontaktinformation (POST /v1/kontaktinformation/status)

JobnetPersonNotificationReminderService (2020-1)

SavePersonNotificationData

Erstattes af Borgerkommunikation.HuskeserviceService (2025-2).CreateAbonnement (POST /v1/abonnement)

SavePersonContactData

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).CreateKontaktinformation (POST /v1/kontaktinformation)

VerifyPersonContactData

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).UpdateKontaktinformation (POST /v1/kontaktinformation/verifisering)

RequestNewVerificationCode

Erstattes af Borgerkommunikation.BorgerKontaktinformationService (2025-2).GetVerfikationskode (GET /v1/kontaktinformation/verfikationskode)

1005.17.30.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo)

Løsningsmodel (internt STAR acc.kr.)

• 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

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.30.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering 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 tilretter pseudonymiseringsflow 

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

Løsningsmodel 

• BorgerKommumikation udstille kodelister for:

  • Borgerkommunikation.KontaktdataCodelLis

  • Borgerkommunikation.KontaktdataStatusCodelList

Kodeliste flytte 1 til 1 fra DFDG (classic)

1005.17.1.8 - PersonStatusService (version 20) udstiller fra 2025-2 ikke mere huskeserviceabonnementer og borgers tlf og e-mailadresse . I stedet returneres tomme lister

PersonStatusService (Version 20)

GetVariablePersonStatus

Udstiller ikke mere

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

Løsningsmodel (internt STAR acc.kr.)

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

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

1005.17.1.11 - Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i Borgerkommunikation, i stedet for services fra DFDG (classic)

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at bruge HuskeserviceService 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å borgers kontaktdata og huskeservice udsendes

Løsningsmodel

• Nye WSBer 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

GetPersonContactInfoVersion1

Udgår til fordel for WSB https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4421615638. GetPersonContactInfoVersion1 bevares ikke i en overgangsperiode.

EksternKommunikation.EntityTypeCodeList

Nye værdier for WSB