1005.17.20 Personkommentar og gæsteadgang (1.2)
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
|---|---|---|---|---|---|---|
@Knud de Place (STAR) @Jens Andersen | @Joel Järlesäter (Unlicensed) @Carsten Olsen | 2023-2 | 2023-2 | 2024-3 | 1.0 | KSS, A-kasse |
Indgik i tilsagn:
til release 2023-1, bølge 2 og 2½
til release 2023-3, bølge 1 og 3
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 |
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)
https://starwiki.atlassian.net/browse/DS-10495
https://starwiki.atlassian.net/browse/DS-12445
https://starwiki.atlassian.net/browse/DS-13289
https://starwiki.atlassian.net/browse/DS-12497
https://starwiki.atlassian.net/browse/BI-2467
https://starwiki.atlassian.net/browse/BI-2634
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 3 Afgrænsning af epic
- 4 Oversigt over berørte webservices
- 5 Beskrivelse af epic
- 5.1 Baggrund
- 5.2 Regler
- 5.3 Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
- 5.4 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
- 5.5 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
- 5.6 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
- 5.6.1.1 Løsningsmodel
- 5.6.2 Borgerkommunikation.PersonkommentarService (2023-1)
- 5.6.2.1 Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#CreatePersonkommentar-(POST-/personkommentar/)
- 5.6.2.2 Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#GetPersonkommentarer-(GET-/personkommentar/)
- 5.6.2.3 Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#UpdatePersonkommentar-(PUT-/personkommentar/{kommentarId})
- 5.6.2.4 Borgerkommunikation.PersonkommentarService (Version 1 [UDV] 2023-1)#DeletePersonkommentar-(Delete-/personkommentar/{kommentarId})
- 5.7 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
- 5.8 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.
- 5.9 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
- 5.10 AC 1005.20.7 - Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.11 AC 1005.20.8 - Borgerkommunikation.BorgerkommunikationStatusService udstiller Personkommentarer og gæsteadgang
- 5.12 AC 1005.17.20.9 - PersonStatusService (version 20) udstiller fra 2024-3 ikke længere PersonCommentCollection. I stedet returneres en tom liste
- 5.12.1 PersonStatusService (Version 20)
- 5.12.1.1 GetVariablePersonStatus
- 5.12.1 PersonStatusService (Version 20)
- 5.13 AC 1005.17.20.10 - PersonHistoryService (Version 4, 2022-4) udstiller 2024-3 ikke længere CommentHistoryCollection. I stedet returneres en tom liste
- 5.14 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
- 5.15 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
- 5.16 AC 1005.17.20.13 - Registerudskrift og borgeres status-side, i LSS, medtager både Personkommentar og Gæsteadgang
- 5.16.1 Løsningsmodel
- 5.17 AC 1005.17.20.14 - Konvertering af personkommentarer (ink. historik), og gæsteadgang inden idriftsættelse
- 5.18 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
- 5.19 AC 1005.17.20.16 - Død kode i DFDG, i forbindelse med personkommentar og gæsteadgang, fjernes
- 5.20 Tjekliste modernisering DFDG:
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
OBS svartider
OBS 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.
Seneste overgang til REST services
NB! om overgangen til nye REST services: Vi vedligeholder et overblik over deadline for overgang til REST services på Varslingsoverblik serviceudfasningsdeadlines. I det omfang tidligere ibrugtagning og tilhørende udfasning aftales, opdateres overblikket.
Afgrænsning af epic
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 | https://starwiki.atlassian.net/browse/DS-10499 |
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 | https://starwiki.atlassian.net/browse/DS-10691 https://starwiki.atlassian.net/browse/DS-10695 |
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 | PersonStatusService (version 20) udstiller fra 2024-3 ikke længere PersonCommentCollection. I stedet returneres en tom liste Løses i 2024-3 | DFDG | |
1005.17.20.10 | PersonHistoryService (Version 4, 2022-4) 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 PersonStatusService (version 20), og PersonHistoryService (Version 4, 2022-4) 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 | |
Pakke PERSKOM-1 i Knuds liste - Beta roadmap DFDG (internt link)
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.20.2 og 3 | 1005.17.20.4 | 1005.17.20.9 | 1005.17.20.10 | ||
Som KSS og a-kasse skal jeg senest i 2024-3 overgå til nye REST snitflader for at registrere personkommentar og anmode om gæsteadgang, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | Frivilligt for a-kasser at registrere personkommentarer | ||
Som KSS og a-kasse skal jeg senest i 2024-3 overgå til nye REST snitflader for at anmode om gæsteadgang, men kan i en overgangsperiode fortsat anvende SOAP-versionen | X | X | |||
Som bruger af PersonStatusService skal jeg senest i 2024-3 skifte til REST snitflade og kald til Borgerkommunikation.PersonkommentarService, eller Borgerkommunikation.BorgerkommunikationStatusService for at hente Personkommentarer og Gæsteadgange. | X | X | Acceptkriteriet er udskudt til senere epic-version | ||
Som bruger af PersonHistory skal jeg i 2024-3 skifte til REST snitflade og kald til Borgerkommunikation.GaesteadgangService, eller Borgerkommunikation.BorgerkommunikationStatusService for at hente Personkommentarer og Gæsteadgange. | X | X | Acceptkriteriet er udskudt til senere epic-version | ||
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. | ||
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)
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 |