Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
...
| Page Properties | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Indgik i tilsagn:
|
...
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 |
01.11.2022 | 0.3 | Joel Järlesäter | Første udgave |
10.11.2022 | 0.3 | Jesper Brunholm | På grund af ressourceknaphed er ibrugtagning af nye services og udfasning af PersonStatusService og PersonHistoryService collections udskudt til 2023-2 |
16.11.2022 | 0.3 | Knud | Foranlediget af spørgsmål fra FOA d.d. er det præciseret i kriterier for eksterne aftagere at også a-kasser skal overgå til REST-service ved registrering af personkommentar og anmodning om gæstedgang |
16.11.2022 | 0.3 | Knud | Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader: Foranlediget af forslag fra FOA er a-kassers brug af registrering af Personkommentar og Oprettelse af gæsteadgang delt i 2 kriterier (da a-kasserne ikke i praksis opretter personkommentarer). Afsnit om berørte services konsekvensopdateret. |
19.11.2022 | 0.3 | Knud | På baggrund af tilsagnstilbagemeldinger i runde 2: Opdateret mhp. af indgå i fornyet tilsagnsrunde 2½ eller 3. Nyt kriterium for aftagere ift. håndtering af cpr-skiftere (svarende til praksis for bl.a. JobSeacrh/CV'er og Borgerkommunikation/kontaktpersoner) Skubbet fra 2023-1 til forventet 2023-2: Mulighed for ekstern ibrugtagning i prod + udfasning af PSS og PHS kollektioner. |
04.12.2022 | 0.5 | Knud | På baggrund af drøftelser med aftagerne og tilsagnsbemærkninger: Vi holder PSS og PHS kollektionerne i live til 2024-3 sammen med registreringsmetoderne på PersonStatusCommentService mht. personkommentater. Afsnit over berørte services + AC 9 og AC 10 konsekvens opdateret. |
21.02.2023 | 0.5 | Knud | Personkommentar og Gæsteadgang forventes aktuelt at kunne bruges i prod. fra 2023-3 |
Interne links (indhold i links ikke relevant for eksterne)
...
20.04.2023 | 0.5 | Knud | Ønsket ekstern deltagelse i test indskrevet → indgå på ny i tilsagnsrunde (bølge 3 / 2022-3) |
28.04.2023 | 1.0 | Knud | v1.0 Kodet færdig. |
16.05.2023 | 1.0 | Knud | Ændret “STAR Release start ibrugtagning“ fra 2023-3 til 2023-2, da de nye REST servicen var med i prod.lægningen af 2023-2. |
Interne links (indhold i links ikke relevant for eksterne)
| Jira Legacy | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
| Jira Legacy | ||||||
|---|---|---|---|---|---|---|
|
...
| Jira Legacy |
|---|
...
|
Indholdsfortegnelse
| Table of Contents | ||
|---|---|---|
|
...
| Info |
|---|
OBS svartiderOBS ift. svartider Svartiderne forventes at være væsentlig dårligere ved brug af SOAP-versionerne af de gamle services end ved brug af de nye REST services - og svartiderne forventes at være væsentlig højere på SOAP-services end før omlægningen til REST. Det skyldes, at SOAP-versionerne internt kalder videre til de nye REST versioner. STAR vil derfor gerne undgå, at holde SOAP-versionerne i live, med mindre det konkret efterspørges af de enkelte aftagere ifm. tilsagn til en given epic. For en service med svartider i dag på fx 4-8 millisekunder (med 7-9 mio. kald pr. måned) forventes, at svartiden på SOAP-version vil være ca x 100. |
...
Afgrænsning | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for personkommentarer og gæsteadgang til REST som en del af STARs 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 (interne links nedenfor) | ||||||||||||||||
1005.17.20.1 | Som STAR vil jeg have flyttet forretningsområdet personkommentarer og gæsteadgang til forretningsdomænet Borgerkommunikation inkl. at det lever op til de principper, der er fastsat | DFDG, BI |
| ||||||||||||||||
1005.17.20.2 | Som serviceaftager og STAR vil jeg have udstillet gæsteadgang via ny REST snitflade med samme forretningslogik og operationer som på den eksisterende SOAP-baserede PersonStatusCommentService | DFDG |
| ||||||||||||||||
1005.17.20.3 | Som serviceaftager og STAR vil jeg have udstillet personkommentarer via ny REST snitflade med samme forretningslogik og operationer som på den eksisterende SOAP-baserede PersonStatusCommentService | DFDG |
| ||||||||||||||||
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 | DFDG |
| ||||||||||||||||
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. | DFDG |
| ||||||||||||||||
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 | DFDG | |||||||||||||||||
1005.17.20.7 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | DFDG, SF | |||||||||||||||||
1005.17.20.8 | Borgerkommunikation.BorgerkommunikationStatusService udstiller Personkommentarer og gæsteadgang | DFDG, KSS, Jobnet, Vitas |
| ||||||||||||||||
1005.17.20.9 | /wiki/spaces/GI/pages/3690397697 udstiller fra 2024-3 ikke længere PersonCommentCollection. I stedet returneres en tom liste Løses i 2024-3 | DFDG |
| ||||||||||||||||
1005.17.20.10 | /wiki/spaces/GI/pages/3827957809 udstiller fra 2024-3 ikke længere CommentHistoryCollection. I stedet returneres en tom liste Løses i 2024-3 | DFDG |
| ||||||||||||||||
1005.17.20.11 | Landssupport/LSS er skiftet til at bruge den nye REST-service i Borgerkommunikation, i stedet for /wiki/spaces/GI/pages/3690397697, og /wiki/spaces/GI/pages/3827957809 fra DFDG classic | DFDG |
| ||||||||||||||||
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 | DFDG |
| ||||||||||||||||
1005.17.20.13 | Registerudskrift og borgeres status-side, i LSS, medtager både Personkommentar og Gæsteadgang | DFDG |
| ||||||||||||||||
1005.17.20.14 | Konvertering af personkommentarer (ink. historik), og gæsteadgang inden idriftsættelse | DFDG, BI | |||||||||||||||||
1005.17.20.15 | Det er håndteret, at begrundelser ved kald af UnemploymentFundMembershipService.GetCurrentMembership i dag gemmes som PersonStatusComment og udstilles i PersonStatusCommentService | DFDG |
| ||||||||||||||||
1005.17.20.16 | Død kode i DFDG, i forbindelse med personkommentar og gæsteadgang, fjernes | DFDG |
| ||||||||||||||||
...
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.BorgerkommunikationStatusService (version 1).GetPersonKommunikationsStatus | Ny | Ny REST-service med nye kollektioner med stamdata, Personkommentar og Gæsteadgange1 | A-kasse, KSS | N/A | D+S |
Borgerkommunikation.GaesteadgangService (version 1).GetGaesteAdgang | Ny | Ny REST-service. Metoden erstatter PersonStatusService (version 20).GetVariablePersonStatus - kollektionen PersonCommentCollection | A-kasse, KSS | BI | D+S |
Borgerkommunikation.GaesteadgangService (version 1).CreateGaesteAdgang | Ny | Ny REST-service. Metoden erstatteter PersonStatusCommentService.CreatePersonGuestAccess | A-kasse, KSS | BI | D+S |
Borgerkommunikation.PersonkommentarService (version 1).GetHistoriskePersonkommentarer | Ny | Ny REST-service. Metoden erstatter PersonHistoryService (version 3).GetPersonHistory - kollektionen CommentHistoryCollection | A-kasse, KSS | N/A | D+S |
Borgerkommunikation.PersonkommentarService (version 1).GetPersonkommentarer | Ny | Ny REST-service. Metoden erstatteter PersonStatusService (version 20).GetVariablePersonStatus - kollektionen PersonCommentCollection | A-kasse, KSS | N/A | D+S |
Borgerkommunikation.PersonkommentarService (version 1).CreatePersonkommentar | Ny | Ny REST-service. Metoden erstatteter PersonStatusCommentService.CreatePersonStatusComment | A-kasse(f), KSS | BI | D+S |
Borgerkommunikation.PersonkommentarService (version 1).DeletePersonkommentar | Ny | Ny REST-service. Metoden erstatteter PersonStatusCommentService.DeletePersonStatusComment | A-kasse(f), KSS | N/A | D+S |
Borgerkommunikation.PersonkommentarService (version 1).UpdatePersonkommentar | Ny | Ny REST-service. Metoden erstatteter PersonStatusCommentService.UpdatePersonStatusComment | A-kasse(f), KSS | N/A | D+S |
PersonStatusCommentService (version 7).CreatePersonStatusComment | Andet | Metoden udgår senest i 2023-4. Ny REST-service Borgerkommunikation.PersonkommentarService (version 1).CreatePersonkommentar kan anvendes fra 2023-1. | A-kasse, KSS | N/A | D+S |
PersonStatusCommentService (version 7).CreatePersonGuestAccess | Andet | Metoden udgår senest i 2023-4. Ny REST-service Borgerkommunikation.GaestadgangService (version 1).CreateGaesteadgang kan anvendes fra 2023-1. | A-kasse, KSS | N/A | D+S |
PersonStatusCommentService (version 7).DeletePersonStatusComment | Andet | Metoden udgår senest i 2023-4. Ny REST-service Borgerkommunikation.PersonkommentarService (version 1).DeletePersonkommentar kan anvendes fra 2023-1. | A-kasse, KSS | N/A | D+S |
PersonStatusCommentService (version 7).UpdatePersonStatusComment | Andet | Metoden udgår senest i 2023-4. Ny REST-service Borgerkommunikation.PersonkommentarService (version 1).UpdatePersonkommentar kan anvendes fra 2023-1. | A-kasse, KSS | ||
...
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:
...
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.
...
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)/wiki/spaces/GI/pages/3879567414
Ny REST service til udstilling af gæsteadgang.
...
Ny REST service med POST-metode i Borgerkommunikation
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder
Borgerkommunikation.PersonkommentarService (2023-1)/wiki/spaces/GI/pages/3879567375
Ny REST service til oprettelse, henting, opdatering og sletning af personkommentarer.
Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#CreatePersonkommentar-(POST-/personkommentar/)/wiki/spaces/GI/pages/3879567389
Ny metode til at oprette en kommentar på en person
Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#GetPersonkommentarer-(GET-/personkommentar/)/wiki/spaces/GI/pages/3879567389
Ny metode til at hente alle kommentarer for en given borger.
...
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). /wiki/spaces/GI/pages/3879567389.
Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2024-3, da der ikke forventes ændringer i den periode.
...
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
...
Ny version, dvs V2, af Borgerkommunikation.BorgerkommunikationStatusService introduceres.
Version 2: BorgerkommunikationStatusService (2023-1)/wiki/spaces/GI/pages/3887988772 udstiller alle Personkommentarer og gæsteadgange for en given borger.
Version 1: /wiki/spaces/GI/pages/3085730110 er vedligeholdt.
...
Landssupport/LSS er skiftet til at brug Borgerkommunikation.GaesteadgangService (2023-1) og Borgerkommunikation.PersonkommentarService (2023-1)/wiki/spaces/GI/pages/3879567414 og /wiki/spaces/GI/pages/3879567375 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)/wiki/spaces/GI/pages/3879567389 for at oprette, opdatere og slette personkommentarer.
...
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
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
Test scenarie | Ønsket testdeltagelse | Berørte systemområder (herunder nye batchjobs*) | Identificeret af | |
|---|---|---|---|---|
Personkommentarer (REST) | Det | er muligt at oprette, opdatere, ønskes, at KSS og A-kasse deltager i test uanset, om REST snitflade tages i brug i 2023-3:
| Det er muligt at oprette, opdatere, slette, og hente personkommentarer for en given borger ved kald til Borgerkommunikation.PersonkommentarService. | Joel Järlesäter |
Personkommentarer (SOAP) | Det er muligt at oprette, opdatere, og slette personkommentarer for en given borger ved kald til PersonStatusCommentService (Version 7, 2020-3). | Joel Järlesäter | ||
Gæsteadgang (REST) | Det er muligt at oprette og hente gæsteadgang for en given borger ved kald til Borgerkommunikation.GaesteadgangService. | Joel Järlesäter | ||
Gæsteadgang (SOAP) | Det er muligt at oprette gæsteadgang for en given borger ved kald til PersonStatusCommentService (Version 7, 2020-3)#CreatePersonGuestAccess. | Joel Järlesäter | ||
Personkommentarer i LSS | - | Personkommentarer fra Borgerkommunikation er udstillet i LSS | Joel Järlesäter | |
Gæsteadgang i LSS | - | Gæsteadgang fra Borgerkommunikation er udstillet i LSS | Joel Järlesäter | |
Landssupport Sagsbehandleradgang til Jobnet i LSS | - | Det er muligt at indlægge en kommentar på borger i LSS og få sagsbehandleradgang til borgers Jobnet | Jesper Brunholm | |
A-k gæsteadgang til CPR skifter | Det ønskes, at A-kasse deltager i test | Som a-kasse kan man oprette gæsteadgang til en personnummerskifters gamle personnummer og dermed tilgå det gamle personnummer i PersonStatusService | Jesper Brunholm | |
Ved oprettelse eller opdatering af personkommentar fremgår i GetPersonStatusComment WSRM'er uanset, om registrering/opdatering sker via PersonStatsusCommentService eller via Borgerkommunikation.PersonkommentarService hvilken myndighed (jobcenter, a-kasse eller STAR), der har foretaget registreringen | Det ønskes, at KSS og a-kasse deltager i test uanset, om REST snitflade tages i brug i 2023-3:
|
| Knud |
* 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
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
...