1005.17.28 Kontaktgruppe og personkategori
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 | @Carsten Olsen@Jesper Brunholm @Jørgen Fischer @Jan Nyman | 2024-3 | 2024-4 | 2025-1 | 1.0 | KSS, a-kasse, Converter |
Indgik i tilsagn:
til release 2023-1, bølge 2 og 2½
til release 2023-3, bølge 3
til release 2024-3, bølge 1
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 |
04.11.2022 | 0.3 | Joel Järlesäter | Epic gennemskrevet og klar til tilsagn (2023-1) |
16.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 |
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 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-1 sammen med registreringsmetoderne på PRS mht. kontaktgruppe og personkategori. Afsnit over berørte services + AC 8 og AC 9 konsekvens opdateret. |
21.02.2023 | 0.5 | Knud | Nye REST services vedr. registrering af KG og PC forventes aktuelt at kunne anvendes i prod. fra 2023-3 |
21.04.2023 | 0.5 | Knud | Skal I fornyet tilsagn til 2023-3 (bølge 3) efter at have været i tilsagn til tidligere releases. Testafsnit udbygget med angivelse af ønske om ekstern deltagelse. |
10.05.2023 | 0.5 | Knud | Udsat frist for seneste ibrugtagning fra 2024-1 til 2024-3, så det for aftager kan følges med frist for ibrugtagning moderniseret Tilmelding (flyttet if. opdatering af roadmap). |
23.05.2023 | 0.5 | Knud | Ac-16 opdateret: Nyt: Hvis PC skiftes væk fra aktivitetsparat, så afslutter DFDG aktivitetstillægget |
01.06.2023 | 0.5 | Jesper Brunholm | På grund af afhængigheder til fravær og tilmelding som ikke kan løses, bliver den produktionssatte løsning i 2023-3, at services i DFDG classic kører uændret videre i 2023-3. Der vil ikke være REST-services som eksterne kan kalde i 2023-3. Overgang til dataejerskab i VisiteringOgStatus vil ske i en senere release efter dialog med eksterne. Seneste ibrugtagning er pt. ukendt. Alle behov for ekstern deltagelse i test af SOAP services og WSRM’er (i regi af denne epic) bortfalder for release 2023-3. |
13.09.2023 | 0.5 | Knud | Nyt internt AC-19 |
11.10.2023 | 0.5 | Knud | Under fortsat intern forberedelse / udvikling mhp. ibrugtagning i 2. halvår 2024 efter nærmere afklaring af tidspunkt med aftagerne |
14.03.2024 | 0.5 | Knud | Start ibrugtagning i prod. mulig fra 2024-4. Seneste ibrugtagning af REST i 2025-1. |
19.04.2024 | 0.3 | Knud | Retur i version 0.3 mhp. nyt tilsagn ifm. release 2024-3 mhp ibrugtagning i prod. i 2024-4. |
30.04.2024 | 0.3 | Knud | AC-2 og berørte services opdateret med 2 nye metoder CreateKontaktgruppeMedIdentifier og CreatePersonkategoriMedIdentifier så aftagerne selv kan vælge om de vil tildele id/GUID eller om DFDG skal gøre dette:
|
13.06.2024 | 0.3 | Jesper | Kontaktgrupper og personkategorier beskrevet i ny statusservice og håndteret i snitflader (ny+udfasning) |
28.06.2024 | 0.5 | Jesper | Løft til 0.5, Ac 7: Bemærk at kodelisterne i test i 2024-3 vil bære de gamle engelske navne |
13.08.2024 | 0.5 | Knud | Tilføjet under “Regler”: “A-kassen skal, jf. databkg. § 129, som hidtil ved medlemstilgang og ved tilmelding som arbejdssøgende hente/læse en række oplysninger i DFDG. Det gælder bl.a. oplysninger om kontaktgrupper.” |
21.08.2024 | 0.5 | Jesper | CreateKontaktgruppeMedIdentifier og CreatePersonkategoriMedIdentifier bortfalder, der er i stedet mulighed for at udfylde et optionelt forretningsfelt med id i henholdsvis CreateKontaktgruppe og CreatePersonkategori. |
13.09.2024 | 0.5 | Jesper | Kodelister som VisiteringOgStatus overtager ansvaret for skifter til dansk navn i 2024-4 for REST services. SOAP services er uberørte. “Oversigt over berørte webservices“: Opdateret med de nye kodelister vedr. kontaktgrupper og personkategori. Og de tilsvarende SOAP kodelister der senere udgår. |
03.10.2024 | 0.5 | Knud | v0.5 - udvikling i gang. Ikke andre ændringer |
05.12.2024 | 1.0 | Jesper | Løftet til 1.0 da al udvikling ift. eksterne aftagere er gennemført. Bemærk dog at der er udestående batchjobomlægninger i efterfølgende releases |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-10507
https://starwiki.atlassian.net/browse/DS-11750
https://starwiki.atlassian.net/browse/DS-12443
https://starwiki.atlassian.net/browse/BI-2487
https://starwiki.atlassian.net/browse/BI-2716
https://starwiki.atlassian.net/browse/BI-6144
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 2.1 OBS svartider
- 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.28.1 - Som STAR vil jeg have flyttet forretningsområdet kontaktgrupper og personkategorisering til forretningsdomænet Visitering og Status inkl. at det lever op til de principper, der er fastsat
- 5.5 AC 1005.17.28.2 - Som serviceaftager og STAR vil jeg have udstillet metoderne i PersonRegistrationService vedr. kontaktgrupper (ContactGroup) og personkategori (visitering) via ny REST snitflade med samme forretningslogik (med nødvendige ændringer) og operationer som den eksisterende SOAP service
- 5.5.1 Løsningsmodel
- 5.5.2 Forretningsside for ny service til registrering og læsning oplysninger om kontaktgrupper og personkategorisering / visitering
- 5.5.2.1 Kontaktgrupper
- 5.5.2.1.1 CreateKontaktgruppe og CreateKontaktgruppeMedIdentifier - ny metode til registrering af kontaktgrupper (30.04.2024 og 21.08.2024)
- 5.5.2.1.1.1 Ny forretning
- 5.5.2.1.2 UpdateKontaktgruppe - ny metode til opdatering af registrerede kontaktgrupper
- 5.5.2.1.2.1 Ny forretning
- 5.5.2.1.3 GetKontaktgrupper - ny metode til læsning af oplysninger om borgers kontaktgrupper
- 5.5.2.1.4 GetKontaktgruppe - ny metode til læsning af oplysninger om borgers aktuelle KG ved kald med CPR-nr og id på KG
- 5.5.2.1.5 GetKontaktgruppeHistorik - ny metode til læsning af historik oplysninger om borgers kontaktgrupper
- 5.5.2.1.1 CreateKontaktgruppe og CreateKontaktgruppeMedIdentifier - ny metode til registrering af kontaktgrupper (30.04.2024 og 21.08.2024)
- 5.5.2.2 Personkategorier
- 5.5.2.2.1 CreatePersonkategori og CreatePersonkategoriMedIdentifier- ny metode til registrering af personkategori / visitation (30.04.2024 og 21.08.2024)
- 5.5.2.2.2 Metoden erstatter PersonRegistrationService (version 9).UpdatePersonCategory
- 5.5.2.2.3 GetPersonkategorier - ny metode til læsning af oplysninger om borgers personkategorier
- 5.5.2.2.4 GetPersonkategori - ny metode til læsning af oplysninger om borgers aktuelle PC ved kald med CPR-nr og id på PC
- 5.5.2.2.5 GetPersonkategorHistorik - ny metode til læsning af historik oplysninger om borgers personkategorier
- 5.5.2.3 Metoden PersonRegistrationService (version 9).CreatePersonCategoryAndInterview udgår
- 5.5.2.1 Kontaktgrupper
- 5.6 AC 1005.17.28.3 - 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.7 AC 1005.17.28.4 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til det nye forretningsdomæne
- 5.8 AC 1005.17.28.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.9 AC 1005.17.28.6 - Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.10 AC 1005.17.28.7 - VisiteringOgStatus udstiller kodelisterne for kontaktgrupper og personkategorier
- 5.11 AC 1005.17.28.8 - PersonStatusService (version 20) udstiller fra 2025-1 ikke længere kollektioner med oplysninger om kontaktgrupper og personkategorier. I stedet returneres en tom liste for hver af disse kollektioner
- 5.11.1 A-kasse filtrering
- 5.11.1.1 Kontaktgrupper
- 5.11.1.2 Personkategori
- 5.11.1 A-kasse filtrering
- 5.12 AC 1005.17.28.9 - PersonHistoryService (version 4) udstiller 2025-1 ikke mere kollektion med oplysninger om kontaktgrupper og personkategorier. I stedet returneres en tom liste for hver af disse kollektioner
- 5.12.1 A-kasse filtrering
- 5.12.1.1 Kontaktgrupper
- 5.12.1.2 Personkategori
- 5.12.1 A-kasse filtrering
- 5.13 AC 1005.17.28.10 - Hidtidige WSRM'er om kontaktgrupper og personkategorier dannes i en overgangsperiode fortsat til jobcentre og a-kasser
- 5.13.1 Jobcentre
- 5.13.2 A-kasser
- 5.13.2.1 Personkategori
- 5.13.2.2 Kontaktgruppe
- 5.14 AC 1005.17.28.11 - Konsekvensændringer for rejsning og læsning af events (eventbroker) foretages
- 5.15 AC 1005.17.28.12 - Død kode i DFDG, i forbindelse med kontaktgrupper og personkategorier, fjernes
- 5.16 AC 1005.17.28.13 - Landssupporten/LSS er skiftet over til at brug den nye REST-servicen vedr. kontaktgrupper og personkategorier i stedet for at udstille oplysningerne fra PSS / PHS og i stedet for at anvende PRS-metoderne til registrering
- 5.17 AC 1005.17.13.14 - VisiteringOgStatus.VisiteringOgStatusStatusService udstiller kontaktgrupper og personkategorisering
- 5.17.1 Løsningsmodel
- 5.17.2 GetPersonVisiteringOgStatusStatus
- 5.18 AC 1005.17.28.15 - Som STAR vil jeg gennem øget monitorering være tryg ved at kontaktgrupper er korrekt synkroniserede rundt i applikationslandskabet
- 5.19 AC 1005.17.28.16 - Som VisiteringOgStatus vil jeg håndtere ændringer til aktivitetstillæg, efterhånden som kontaktgruppe og personkategorier oprettes eller opdateres
- 5.20 1005.17.28.19 - Som aftager vil jeg kunne abonnere på WSB om kontaktgrupper og personkategorier
- 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.
Afgrænsning af epic
Afgrænsning | |||
|---|---|---|---|
Som serviceaftager og STAR vil jeg
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 |
1005.17.28.1 | Som STAR vil jeg have flyttet forretningsområdet kontaktgrupper, personkategorisering til forretningsdomænet Visitering og Status inkl. at det lever op til de principper, der er fastsat | DFDG, BI | https://starwiki.atlassian.net/browse/DS-11256 https://starwiki.atlassian.net/browse/DS-11258 |
1005.17.28.2 | Som serviceaftager og STAR vil jeg have udstillet metoderne i PersonRegistrationService vedr. kontaktgrupper (ContactGroup) og personkategori (visitering) via ny REST snitflade med samme forretningslogik (med nødvendige ændringer) og operationer som den eksisterende SOAP service | DFDG, Jobnet, Vitas | https://starwiki.atlassian.net/browse/DS-11256 https://starwiki.atlassian.net/browse/DS-11258 https://starwiki.atlassian.net/browse/DS-11549 https://starwiki.atlassian.net/browse/KON-3557 https://starwiki.atlassian.net/browse/KON-3425 https://starwiki.atlassian.net/browse/KON-3554 https://starwiki.atlassian.net/browse/KON-3725 https://starwiki.atlassian.net/browse/KON-3554 https://starwiki.atlassian.net/browse/KON-2514 https://starwiki.atlassian.net/browse/KON-2901 https://starwiki.atlassian.net/browse/KON-2903 https://starwiki.atlassian.net/browse/KON-2515 https://starwiki.atlassian.net/browse/KON-2516 https://starwiki.atlassian.net/browse/KON-2517 https://starwiki.atlassian.net/browse/KON-3529 https://starwiki.atlassian.net/browse/KON-2518 https://starwiki.atlassian.net/browse/KON-3557 https://starwiki.atlassian.net/browse/KON-2519 https://starwiki.atlassian.net/browse/KON-2520 |
1005.17.28.3 | 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, Jobnet, Vitas | |
1005.17.28.4 | Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til det nye forretningsdomæne | BI | |
1005.17.28.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | DFDG, Jobnet | |
1005.17.28.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | DFDG, SF | |
1005.17.28.7 | VisiteringOgStatus udstiller kodelisterne for kontaktgrupper og personkategorier | DFDG | |
1005.17.28.8 | PersonStatusService (version 20) udstiller fra 2025-1 ikke mere kollektioner med oplysninger om kontaktgrupper og personkategorier. I stedet returneres en tom liste for hver af disse kollektioner | DFDG |
|
1005.17.28.9 | PersonHistoryService (version 4) udstiller fra 2025-1 ikke mere kollektion med oplysninger om kontaktgrupper og personkategorier. I stedet returneres en tom liste for hver af disse kollektioner | DFDG |
|
1005.17.28.10 | Hidtidige WSRM'er om kontaktgrupper og personkategorier dannes i en overgangsperiode fortsat til jobcentre og a-kasser (a-kasser modtager som hidtil kun for enkelte kontaktgrupper og for visse fravær) | DFDG | |
1005.17.28.11 | Død kode i DFDG, i forbindelse med kontaktgrupper og personkategorier, fjernes | DFDG | |
1005.17.28.12 | Landssupporten/LSS er skiftet over til at brug den nye REST-servicen vedr. kontaktgrupper og personkategorier i stedet for at udstille oplysningerne fra PSS / PHS og i stedet for at anvende PRS-metoderne til registrering. | DFDG | |
1005.17.28.13 | VisiteringOgStatus.VisiteringOgStatusStatusService udstiller kontaktgrupper og personkategorier | DFDG |
|
1005.17.28.14 | Som STAR vil jeg gennem øget monitorering være tryg ved at kontaktgrupper er korrekt synkroniserede rundt i applikationslandskabet | BI |
|
1005.17.28.15 | Som VisiteringOgStatus vil jeg håndtere ændringer til aktivitetstillæg, efterhånden som kontaktgruppe og personkategorier oprettes eller opdateres | DFDG |
|
1005.17.28.16 | Som STAR vil jeg have de batchjobs, der håndterer kontaktgrupper, tilpasset eller flyttet til VisiteringOgStatus | DFDG | https://starwiki.atlassian.net/browse/DS-11508 |
1005.17.28.18 | Konsekvensændringer for rejsning og læsning af events (eventbroker) foretages | DFDG | https://starwiki.atlassian.net/browse/DS-11457 https://starwiki.atlassian.net/browse/DS-14397 https://starwiki.atlassian.net/browse/DS-11459 https://starwiki.atlassian.net/browse/DS-14398 https://starwiki.atlassian.net/browse/KON-1378 https://starwiki.atlassian.net/browse/KON-1378 |
1005.17.28.19 | Som aftager vil jeg kunne abonnere på WSB om kontaktgrupper og personkategorier | DFDG | |
Pakke KG-1 i Knuds liste - Beta roadmap DFDG
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.28.2 | 1005.17.28.3 | 1005.17.28.7 og 8 | 1005.17.28.9 | ||
Som KSS skal jeg overgå til ny REST snitflade for at registrere og opdatere oplysninger om kontaktgrupper og personkategorier, men kan i en overgangsperiode indtil 2025-1 fortsat anvende SOAP-versionen PersonRegistrationService til disse registreringer | X | X | |||
Som KSS og a-kasse bruger af PersonStatusService og PersonHistoryService skal jeg senest fra 2025-1 skifte til REST snitfladen for at læse registreringer om kontaktgrupper og personkategorier | X | ||||
KSS kan som hidtil abonnere på WSRM'er om kontaktgrupper og personkategorier | X | ||||
A-kasser kan som hidtil abonnere på WSRM'er om (visse) kontaktgrupper | |||||