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)

DS-12126 - Getting issue details... STATUS

PLAN-5845 - Getting issue details... STATUS

BI-2453 - Getting issue details... STATUS

Indholdsfortegnelse

Afgrænsning af epic

Pakke MESS-1 i Knuds liste - Beta roadmap DFDG

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 Dialogmodulet (CitizenMessageService og JobnetCitizenMessageService) følgende:

• I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer, dog løses Teknisk gæld ift. at der kan vedlægges flere dokumenter - og at dette skal ske i en kollektion

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

Eksisterende registrerings- og indberetningsregler i databkg. ift. brug af Dialogmodulet fortsætter uændret, herunder ift. obligatorisk brug af visse beskedtyper.

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.10.1 - Som STAR vil jeg have flyttet forretningsområdet Dialogmodulet (CitizenMessageService og JobnetCitizenMessageService) 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

Acc.kr. 1005.17.10.2 - Som serviceaftager og STAR vil jeg have udstillet Dialogmodulet (CitizenMessageService) via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service

Løsningsmodel

• Ny REST service i Borgerkommunikation

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder

• Nogle gamle metoder, der ikke mere anvendes, medtages ikke se 1005.17.10.3 

• Nyt: Hvis en besked er markeret til, at den ikke skal vises i Jobnets beskedbakke, skal den frifiltreres i udstillingen til Jobnet (Beskeder oprettet med ‘visIBeskedbakke’ = Faslse / tidl. ‘ShowInMessageBox’ = False skal ikke udstilles til Jobnet (løsning af S2312-497))

BorgerBeskedService (Version 1 [UDV], 2024-4)

Ny REST service til udstillings af metoder i forbindelse med dialogmodulet / borger beskedbakke.

CreateBorgerbesked (POST /v1/Borgerbesked)

Metoden bruges til at oprette og sende en besked via en kommunikationskanal. For kommunikationskanaler som SMS, mail og notifikationer på Jobnet, vil dette være at betragte som envejskommunikation til borger, uden mulighed for at borger kan returnere med svar.

Erstatter CitizenMessageService.CreateMessage og JobnetCitizenMessageService (2016-4).CreateMessage

CreateBorgerbeskedsvar (POST /v1/Borgerbesked/Svar/{borgerbeskedIdentifier})

Metoden bruges som svar på en eksisterende meddelelse – dermed kan skabes beskedtråd.

Erstatter CitizenMessageService.CreateMessageReply og JobnetCitizenMessageService (2016-4).CreateMessageReply

Getbesked (GET /v1/BorgerBesked/{borgerbeskedIdentifier})

Metoden bruges til at hente en specifik besked relateret til en borger. Beskeden indeholder hovedbeskeden og evt. tilhørende svar til denne hovedbesked.

Erstatter CitizenMessageService.GetMessage og JobnetCitizenMessageService (2016-4).GetMessage)

GetBesked (GET /v1/BorgerBesked)

Metoden bruges til at hente alle de beskeder, der er oprettet for en borger. Af performancemæssige hensyn giver servicemetoden mulighed for kun at returnere hovedbeskeden uden de underliggende svar.

Erstatter CitizenMessageService.GetMessagesog JobnetCitizenMessageService (2016-4).GetMessagesCV)

GetBesked (GET /v1/BorgerBesked/Virksomhed/{cvrEnhedsid})

Metoden bruges til at hente alle de beskeder, der er oprettet af en virksomhed rettet mod JobAG. Af performancemæssige hensyn giver servicemetoden mulighed for kun at returnere hovedbeskeden uden de underliggende svar.

Erstatter JobnetCitizenMessageService (2016-4).GetMessagesCompany)

UpdateBesked (PUT /v1/BorgerBesked/{borgerbeskedIdentifier}/action/setstatus)

Metoden bruges til at angive om en besked er afsluttet eller fejlagtigt oprettet. Denne servicemetode kan kun anvendes, hvis afsendelseskanal er Id 4 "Myndighed til Myndighed"

Erstatter CitizenMessageService.SetMessageStatus

UpdateBeskedsvar (PUT /v1/BorgerBesked/Svar/{borgerbeskedIdentifier}/action/setstatus)

Denne metode anvendes til at markere, at et svar er blevet fejlagtigt oprettet.

Erstatter CitizenMessageService.SetMessageReplyStatus og JobnetCitizenMessageService (2016-4).SetMessageReplyStatus

UpdateBesked (PUT /v1/BorgerBesked/{borgerbeskedIdentifier}/action/setmarkering)

Metoden bruges til at angive at borgeren, i regi af Jobnet, har fået vist eller har læst beskeden. Metoden anvendes også til at angive at borgeren, i regi af Jobnet, har læst et svar.

Erstatter CitizenMessageService.MarkMessage og JobnetCitizenMessageService (2016-4).MarkMessage)

Getbeskeddokument (GET /v1/BorgerBested/Dokument/{DocumentIdentifier})

Henter et dokument.

Erstatter CitizenMessageService.GetCitizenMessageDocument

Scopes

Dekorering af metoder med scopes.

TBD:

1005.17.10.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP services uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade

Løsningsmodel

• Eksisterende SOAP-services CitizenMessageService og JobnetCitizenMessageService bevares som kalder mod ny Dialogbeskedservice (REST) 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-1.

/wiki/spaces/GI/pages/3690397697

Dialogmodulbeskeder har ikke indgået i PSS - /wiki/spaces/GI/pages/3690397697, derfor ingen ændringer i PSS.

CitizenMessageService -CitizenMessageService

Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-1, da der ikke forventes ændringer i den periode. 

CreateMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).CreateBorgerbesked (POST /v1/Borgerbesked)

CreateMessageReply

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).CreateBorgerbeskedsvar (POST /v1/Borgerbesked/Svar/{borgerbeskedIdentifier})

GetMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).Getbesked (GET /v1/BorgerBesked/{borgerbeskedIdentifier})

GetMessages

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).GetBesked (GET /v1/BorgerBesked)

SetMessageStatus

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).UpdateBesked (PUT /v1/BorgerBesked/{borgerbeskedIdentifier}/action/setstatus)

SetMessageReplyStatus

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).UpdateBeskedsvar (PUT /v1/BorgerBesked/Svar/{borgerbeskedIdentifier}/action/setstatus)

MarkMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).UpdateBesked (PUT /v1/BorgerBesked/{borgerbeskedIdentifier}/action/setmarkering)

GetCitizenMessageDocument

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).Getbeskeddokument (GET /v1/BorgerBested/Dokument/{DocumentIdentifier})

JobnetCitizenMessageService - JobnetCitizenMessageService (2016-4)

Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-2, da der ikke forventes ændringer i den periode. 

CreateMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).CreateBorgerbesked (POST /v1/Borgerbesked)

CreateMessageReply

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).CreateBorgerbeskedsvar (POST /v1/Borgerbeskedsvar/{borgerbeskedIdentifier})

GetMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).Getbesked (GET /v1/BorgerBesked/{borgerbeskedIdentifier})

GetMessagesCV

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).GetBesked (GET /v1/BorgerBesked)

GetMessagesCompany

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).GetBesked (GET /v1/BorgerBesked/Virksomhed/{cvrEnhedsid})

SetMessageReplyStatus

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).UpdateBeskedsvar (PUT /v1/BorgerBesked/Svar/{borgerbeskedIdentifier}/action/setstatus)

MarkMessage

Metoden udgår og erstattes af BorgerBeskedService (Version 1 [UDV], 2024-4).UpdateBesked (PUT /v1/BorgerBesked/{borgerbeskedIdentifier}/action/setmarkering)

CreateHistoricMessage

Metoden udgår og erstattes ikke.

CreateHistoricMessageReply

Metoden udgår og erstattes ikke.

ReminderService (2018-1) XXXXX Er denne en del af denne epic CO: tænker den høre til dialogmodulet??

EnqueueReminder

1005.17.10.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 til Borgerkommunikation domænet

• Mapningsdokument til BI

• Omlægning af dataleverancer til DOA

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

• BorgerBeskedService (2024-4)

• IT-understøttelse af SMS- og emailservice og dialogmodul (beskedbakke på Jobnet)

• Flytning af beskeder fra Kampagnemotoren til Beskedbakken på Jobnet (Side skal slettes i forbindelswe med epic 1005.17.10)

• Kommunikation om og med borger via Dialogmodulet

• Kommunikationskanaler til borgere

1005.17.10.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 for pseudonymisering og aftale hvornår data skal med i dataløft

• Systemforvalter tilretter pseudonymiseringsflow 

1005.17.10.7 Borgerkommunikation udstiller kodelisterne vedr. Dialogbeskedservice i Borgerkommunikation.CodelistService

Løsningsmodel 

• DFDG udstille kodelister for Dialogbeskedservice i Borgerkommunikation.CodelistService

BeskedIndholdsTypeCodelist - Borgerkummunikation.BeskedIndholdsTypeCodeList

Erstatter CitizenMessageContextTypeIdentifier 1 til 1.

BrugerTypeCodelist - Borgerkummunikation.BrugerTypeCodelist

Erstatter CitizenMessageUserTypeIdentifier 1 til 1.

BesvarelsesTypeCodelist - Borgerkommunikation.BesvarelsestypeCodeList

Erstatter CitizenMessageResponseTypeIdentifier 1 til 1.

VigtighedsniveauTypeCodelistBorgerkommunikation.VigtigthedsniveautypeCodeList

Erstatter MessageImportantIdentifierType 1 til 1.

STAR.Foundation FilTypeCodelist - "STARFoundation".FiltypeCodeList

Erstatter DocumentExtensionTypeIdentifier1 til 1.
Bemærk. Da dette er en tværgående kodeliste vil placering og navn kunne ændres, indhold ændres ikke.

DokumentSkemaTypeCodelist - Borgerkommunikation.DokumentSkemaTypeCodeList

Erstatter DocumentSchemaTypeIdentifier1 til 1.

Bemærk blive pt. kun brugt i forbindelse Udkast til Min plan der udfases i forbindelse med Nytænkning 1/1-2024.

CodeListService (version 5) - CodeListService

De nævnte kodelister udstilles så længe at CitizenMessageService og JobnetCitizenMessageService (2016-4) udstilles som SOAP service.

CitizenMessageContextTypeIdentifier - CitizenMessageContextTypeIdentifier

Udgår til fordel for Borgerkummunikation.BeskedIndholdsTypeCodeList

CitizenMessageUserTypeIdentifier - CitizenMessageUserTypeIdentifier

Udgår til fordel for Borgerkummunikation.BrugerTypeCodelist

CitizenMessageResponseTypeIdentifier - CitizenMessageResponseTypeIdentifier

Udgår til fordel for Borgerkommunikation.BesvarelsestypeCodeList

MessageImportantIdentifier - MessageImportantIdentifierType

Udgår til fordel for Borgerkommunikation.VigtigthedsniveautypeCodeList

DocumentExtentionTypeIdentifier - DocumentExtensionTypeIdentifier

Udgår til fordel for "STARFoundation".FiltypeCodeList

DocumentSchemaTypeIdentifier - DocumentSchemaTypeIdentifier

Udgår til fordel for Borgerkommunikation.DokumentSkemaTypeCodeList

OrganisatioTypeidentifier -OrganisationTypeIdentifier

Berøres ikke i forbindelse med denne epic.

1005.17.1.8 /wiki/spaces/GI/pages/3690397697

/wiki/spaces/GI/pages/3690397697

GetVariablePersonStatus

Dialogmodulbeskeder har ikke indgået i PSS - /wiki/spaces/GI/pages/3690397697, derfor ingen ændringer i PSS.

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 Dialogmodulet (CitizenMessageService), 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-service i Borgerkommunikation, i stedet for CitizenMessageService

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at bruge DialogbeskedService ved brug af nyt ClientApi fra Borgerkommunikation.

• Kode brugt i forbindelse med CitizenMessageService er fjernet fra LSS

Accordion

Accordion opdateres til at læse data fra den nye REST-service - DialogbeskedService:

Afsendelse af besked

Afsendelse af beskeder fra LSS opdateres til at bruge den nye REST-service - DialogbeskedService:

1005.17.10.13 Som serviceaftager og STAR vil jeg have webservicebeskeder

Løsningsmodel

/wiki/spaces/GI/pages/4041180511

GetCitizenMessageEventVersion2

GetCitizenMessageEventVersion3

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 / konvertering af gamle beskeder inkl. evt. svar til Borgerkommunikation forretningsdomænet.

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 Borgerkommunikation 

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

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

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