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)

https://starwiki.atlassian.net/browse/DS-10495

https://starwiki.atlassian.net/browse/DS-12445

https://starwiki.atlassian.net/browse/DS-13289

Indholdsfortegnelse

Afgrænsning af epic

Pakke PERSKOM-1 i Knuds liste - Beta roadmap DFDG (internt link)

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)

 Oversigt over udfasning af services som ikke er påkrævede til indeværende release, med tilhørende deadline for skift til REST service, findes på Varslingsoverblik serviceudfasningsdeadlines 

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 PersonCommentStatusService følgende:

• I DFDG et skift til REST snitflader - og i denne epic uden samtidige forretningsmæssige ændringer

• Opdeling af PersonCommentStatusService i 2 services, da servicen i dag understøtter registrering af kommentarer på en borger og behovet for at kunne trække en gæsteadgang for at kunne læse eller opdatere data på ikke-egne borgere / medlemmer

PersonStatusCommentService opdeles derfor i:

• PersonkommentarService

• GæsteadgangService (dog betegnet GaesteadgangService i koden)

Regler

Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.

Det er ingen indberetningsregler i tilknytning registreringsmetoderne i denne epic.

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 nye REST snitflader, men kan i en overgangsperiode (indtil 2024-3) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.

Serviceaftager skal dog være forberedt på, at svartiden ved kald af SOAP-udgaverne forventes at være forringet, jf. Info-boks i top af epic-dokumentet.

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.

AC 1005.17.20.1 - Som STAR vil jeg have flyttet forretningsområdet personkommentarer og gæsteadgange til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Etablering af database i Borgerkommunikation 

AC 1005.17.20.2 - Som serviceaftager og STAR vil jeg have udstillet gæsteadgang via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP baserede PersonStatus- og PersonStatusCommentService

Løsningsmodel

• Ny REST service - gæsteadgang med POST og GET-operationer i Borgerkommunikation

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

Borgerkommunikation.GaesteadgangService (2023-1)

Ny REST service til udstilling af gæsteadgang.

Borgerkommunikation.GaesteadgangService (Version 1 [UDV] 2023-1)#CreateGaesteadgang-(POST-/Gaesteadgang/)

Ny metode til at oprette gæsteadgang.

Borgerkommunikation.GaesteadgangService (Version 1 [UDV] 2023-1)#GetGaesteadgange-(GET-/Gaesteadgang/)

Ny metode til at hente alle gæsteadgange, for en given borger.

AC 1005.17.20.3 - Som serviceaftager og STAR vil jeg have udstillet personkommentarer via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP baserede PersonStatus- og PersonStatusCommentService

Løsningsmodel

• Ny REST service med POST-metode i Borgerkommunikation

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

Borgerkommunikation.PersonkommentarService (2023-1)

Ny REST service til oprettelse, henting, opdatering og sletning af personkommentarer.

Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#CreatePersonkommentar-(POST-/personkommentar/)

Ny metode til at oprette en kommentar på en person

Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#GetPersonkommentarer-(GET-/personkommentar/)

Ny metode til at hente alle kommentarer for en given borger.

Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#UpdatePersonkommentar-(PUT-/personkommentar/{kommentarId})

Ny metode til at opdatere en kommentar for en given borger.

Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#DeletePersonkommentar-(Delete-/personkommentar/{kommentarId})

Ny metode til at slette en kommentar på en person

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

Løsningsmodel

• Eksisterende SOAP bevares som kalder mod ny get-, put-, post-, og delete-metode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-3.

PersonStatusCommentService (Version 7, 2020-3)

Udgår til fordel for Borgerkommunikation.GaesteadgangService (Version 1 [UDV] 2023-1) og Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1).
Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2024-3, da der ikke forventes ændringer i den periode. 

AC 1005.17.20.5 - WSRM GetPersonStatusComment sendes ud ved oprettelse, opdatering og sletning af en personkommentar. GetPersonStatusComment sendes til såvel eget som gæsteadgangsanmodende jobcenter ved oprettelse af gæsteadgang. 

Løsningsmodel (internt STAR acc.kr.)

• Udsendelse af WSRM GetPersonStatusComment flyttes fra DFDG Classic til Borgerkommunikation.

• Udsendelse GetPersonStatusComment sker med samme foretninglogik som før.

AC 1005.17.20.6 - 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)

• Servicesnitfladen Borgerkommunikation.PersonkommentarService, Borgerkommunikation.GaesteadgangService, og Borgerkommunikation.BorgerkommunikationStatusService inkl. undersider

• Servicesnitflade PersonStatusCommentService

• Logisk datamodel 

• STAR applikationer og systemer på B. DFDG - Det fælles datagrundlag - Applikationsdesign

• Transition i forhold til registrerings- og statusservices

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

Løsningsmodel (internt STAR acc.kr.)

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

• Systemforvalter til retter anonymiseringsflow 

AC 1005.20.8 - Borgerkommunikation.BorgerkommunikationStatusService udstiller Personkommentarer og gæsteadgang

Løsningsmodel (internt STAR acc.kr.)

• Ny version, dvs V2, af Borgerkommunikation.BorgerkommunikationStatusService introduceres.

• Version 2: BorgerkommunikationStatusService (2023-1) udstiller alle Personkommentarer og gæsteadgange for en given borger. 

• Version 1: BorgerkommunikationStatusService (2020-4) er vedligeholdt.

AC 1005.17.20.9 - PersonStatusService (version 20) udstiller fra 2024-3 ikke længere PersonCommentCollection. I stedet returneres en tom liste

Acceptkritieriets indfrielse udskydes til senere release pga. ressourceknaphed

PersonStatusService (Version 20)

GetVariablePersonStatus

Udstiller fra 2024-3 ikke mere PersonCommentCollection. I stedet returneres en tom liste

AC 1005.17.20.10 - PersonHistoryService (Version 4, 2022-4) udstiller 2024-3 ikke længere CommentHistoryCollection. I stedet returneres en tom liste

Acceptkritieriets indfrielse udskydes til senere release pga. ressourceknaphed

PersonHistoryService (2022-4)

GetPersonHistory

Udstiller fra 2024-3 ikke mere CommentHistoryCollection. I stedet returneres en tom liste

AC 1005.17.20.11 - Landssupport/LSS er skiftet til at bruge den nye REST-service i Borgerkommunikation, i stedet for PersonStatusService (version 20), og PersonHistoryService (Version 4, 2022-4) fra DFDG classic

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug Borgerkommunikation.GaesteadgangService (2023-1) og Borgerkommunikation.PersonkommentarService (2023-1) for at hente gæsteadgang og personkommentarer.

AC 1005.17.20.12 - Landssupport/LSS er skiftet til at bruge den nye REST-service i Borgerkommunikation, i stedet for PersonStatusCommentService (Version 7, 2020-3), fra DFDG classic

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1) for at oprette, opdatere og slette personkommentarer.

AC 1005.17.20.13 - Registerudskrift og borgeres status-side, i LSS, medtager både Personkommentar og Gæsteadgang

Løsningsmodel

• LSS udstiller gæsteadgang under borgeres status-side som et nyt felt.

• LSS udstiller gæsteadgang i borgeres registerudtræk, som et nyt felt.

AC 1005.17.20.14 - Konvertering af personkommentarer (ink. historik), og gæsteadgang inden idriftsættelse

Løsningsmodel (internt STAR acc.kr.)

• BI har lavet konvertering af personkommentarer (ink. historik), og gæsteadgang inden idriftsættelse.

• Data i tblPersonStatusAccessReason og tblCaseWorkerGuestAccess konverteres til gæsteadgange i Borgerkommunikation

• Data i tblPersonStatusComment og tblPersonStatusCommentHistory konverteres til personkommentarer og personkommentarshistorik i Borgerkommunikation, uanset PeriodicCurcumstanceTypeId (Se FB305376).

AC 1005.17.20.15 - Det er håndteret, at begrundelser ved kald af UnemploymentFundMembershipService.GetCurrentMembership i dag gemmes som PersonStatusComment og udstilles i PersonStatusCommentService

Løsningsmodel (internt STAR acc.kr.)

• UnemploymentFundMembershipService (Version 4, 2021-3)#GetCurrentMembership BI har lavet konvertering af personkommentarer (ink. historik), og gæsteadgang inden idriftsættelse.

AC 1005.17.20.16 - Død kode i DFDG, i forbindelse med personkommentar og gæsteadgang, fjernes

Løsningsmodel (internt STAR acc.kr.)

• DFDG Classic kalder over til 

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; Ja, i en overgangsperiode i 2023.

    • 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: Ja

  • WSRM'er
    
    

    • Skal eksisterende WSRM udsendes og hvor længe: Eksisterende WSRM opretholdes. 

    • 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): Ja. Kommentar-kollektion udfases.

    • Udvidelser til domænespecifikke statusservices; Ja. 

    • Udfasning i PersonHistoryService (PHS): Ja. Kommentar-kollektion udfases.

    • Udvidelse til domænespecifikke historik services: Nej

  • LSS (Landssupportsystem) og/eller Datakanon og herunder Registerudtræk (hvis STAR har dataejerskab); Ja

  • 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 af forsørgelseshistorik i ydelsesudstilling silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle forsørgelseshistorik på DFDG classic.

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 Ydelsesudstilling 

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

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

• Angiv hvem der har foretaget dette tjek: Joel Järlesäter

• Angiv dato for tjek: 31-10-2022

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

Adgang til alle data.

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