1005.17.48 Samling af Min plan og komposit Min plan service og webservicebeskeder
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 | 2023-4 2024-1(05.03.2024) | 2024-2 | 2024-2 | 1.0 | KSS, a-kasse, Converter |
Indgik i tilsagn:
til release 2023-4, bølge 1
til release 2024-1, bølge 2
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? |
|---|---|---|---|
31.03.2023 | 0.1 | Carsten Olsen | Oprettelse |
12.06.2023 | 0.3 | Carsten Olsen | Opdateret med indhold. |
13.09.2023 | 0.3 | Knud | Nyt internt ac-8 |
19.02.2024 | 0.3 | Carsten Olsen | Afsnit med varslinger flytte til sidst i dokument pga. læsevenlighed. |
05.03.2024 | 0.5 | Carsten Olsen | Løftet til version 0.5 med følgende præciseringer og ændringer
|
07.08.2024 | 0.5 | Knud | Opdateret links til wiki sider for MyPlanService og Komposit.MinPlanService |
10.04.2024 | 0.5 | Knud | Foranlediget af spg. d.d. fra a-kasse leverandør: Borgerindsats.MinPlanservice (version 1) udgår til fordel for Borgerindsats.MinPlanservice (version 2). Opdateret afsnit med berørte services og afhængigheder til eksterne. Rettelse 19.04.2024: Det er Borgerindsats.Planservice (version 1), der udgår til fordel for Borgerindsats.Planservice (version 2). |
28.08.2024 | 1.0 | Carsten Olsen | Løft til v1.0 |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-13679
https://starwiki.atlassian.net/browse/PLAN-1607
https://starwiki.atlassian.net/browse/BI-4381
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 1005.17.48.1 Som STAR vil jeg have konsolideret Min plan og tilhørende områder så de som sammenhæng er fuldt integreret forretningsmæssigt
- 5.5 1005.17.48.2 - Som serviceaftager og STAR vil jeg have udstillet komposit Min plan service via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
- 5.6 1005.17.48.3 - Som serviceaftager vil jeg have udfaset de eksisterende SOAP
- 5.6.1.1 Løsningsmodel
- 5.6.2 MyPlanService -
- 5.6.2.1 GetMyPlan
- 5.6.2.2 GetMyPlanPdf
- 5.6.3 JobnetMyPlanService - JobnetMyPlanService (2021-3)
- 5.6.3.1 GetLegalMyPlanWithDetails
- 5.7 1005.17.48.4 - Som STAR vil jeg have, at den samlede dokumentation for servicelag og frontend lever op til STAR's principper på releasetidspunktet og er konsekvensrettet
- 5.7.1.1 Løsningsmodel
- 5.7.2 Oversigt over dokumentationsændringer
- 5.8 1005.17.48.5 Komposit service anvende eksisterende kodelisterne fra den service der bliver kald i den enkelte forretningsdomæner
- 5.8.1 Løsningsmodel
- 5.9 1005.17.48.6 Som serviceaftager og STAR vil jeg have udsendelse af webservicebeskeder i forhold til Min plan universet samt udfasning ikke mere anvendte af WSRM-beskeder
- 5.9.1.1 Løsningsmodel
- 5.9.2 Min plan WSB
- 5.9.3 Plan WSB
- 5.9.4 Aktivitet WSB
- 5.9.5 Ny version af Samtale webservicebesked
- 5.9.6 Kontrakt efter integrationsloven WSB
- 5.9.7 Uddannelsesplan WSB
- 5.9.8 Rehabilitering WSB
- 5.9.9 Krav til jobsøgning WSB
- 5.10 1005.17.48.7 Løsning af FB 137816 “Behov for underskiftsfelt til kommunens/jobcenterets på integrationskontrakten“
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10 Totaloversigt over berørte webservices i forbindelse med Min Plan
- 10.1 1005.17.5 Krav til Jobsøgning
- 10.2 1005.17.9 Rehabiliteringsforløb
- 10.3 1005.17.45 ActivityService omlægning
- 10.4 1005.17.46 Omlægning af Plan- og MyplanService
- 10.5 1005.17.47 Omlægning af integrationskontrakt
- 10.6 Automatisk oversigt
- 10.6.1 1005.17.5 Krav til Jobsøgning
- 10.6.2 1005.17.9 Rehabiliteringsforløb
- 10.6.3 1005.17.45 ActivityService omlægning
- 10.6.4 1005.17.46 Omlægning af Plan- og MyplanService
- 10.6.5 1005.17.47 Omlægning af integrationskontrakt
- 10.6.6 1005.17.48 Samling af Min plan service og WSB - inkl. Komposit - Snitflader der etableres med denne epic
- 10.6.7 1005.17.49 Omlægning af EducationPlanservice
- 11
Afgrænsning af epic
Afgrænsning | |||
|---|---|---|---|
Som serviceaftager og STAR vil jeg have samlet alle elementerne i Min plan og sikret,. at den forretningsmæssige sammenhæng i den moderniserede løsning er tilstede og følger de samme regler som den eksisterende DFDG classic løsning samt der er etablerer eventuelle komposit REST snitflader for at sikre dels at Min plan samlet er understøttet og dels 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.48.1 | Som STAR vil jeg have konsolideret Min plan og tilhørende områder så de som sammenhæng er fuldt integreret forretningsmæssigt | DFDG, BI | https://starwiki.atlassian.net/browse/PLAN-1680 https://starwiki.atlassian.net/browse/PLAN-167 https://starwiki.atlassian.net/browse/PLAN-412 https://starwiki.atlassian.net/browse/PLAN-2467 https://starwiki.atlassian.net/browse/PLAN-2981 https://starwiki.atlassian.net/browse/PLAN-2257 https://starwiki.atlassian.net/browse/PLAN-830 https://starwiki.atlassian.net/browse/PLAN-831 https://starwiki.atlassian.net/browse/PLAN-1674 https://starwiki.atlassian.net/browse/PLAN-3020 https://starwiki.atlassian.net/browse/PLAN-1678 https://starwiki.atlassian.net/browse/PLAN-2605 https://starwiki.atlassian.net/browse/PLAN-1820 https://starwiki.atlassian.net/browse/PLAN-271 https://starwiki.atlassian.net/browse/PLAN-2043 https://starwiki.atlassian.net/browse/PLAN-1626 https://starwiki.atlassian.net/browse/PLAN-2396 https://starwiki.atlassian.net/browse/PLAN-413 |
1005.17.48.1A | At nulstillende samtaler/krav til jobsøgning udløser ny Min plan version og at samtaler a-kassen ikke må se filtreres fra |
| https://starwiki.atlassian.net/browse/PLAN-1401 https://starwiki.atlassian.net/browse/PLAN-1402 https://starwiki.atlassian.net/browse/PLAN-1569 |
1005.17.48.2 | Som serviceaftager og STAR vil jeg have udstillet komposit Min plan service via ny REST snitflade med samme forretningslogik og operationer som den oprindelige SOAP service | DFDG, Jobnet | |
1005.17.48.3 | Som serviceaftager vil jeg have udfaset de eksisterende SOAP services (Samlet acc. kriterie fra de øvrige epics, der tages i brug i prod. med 2024-2) | DFDG, JobnetPLAN | https://starwiki.atlassian.net/browse/PLAN-162 |
1005.17.48.4 | Som STAR vil jeg have at den samlede dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet og er konsekvensrettet | DFDG, Jobnet | N/A |
1005.17.48.5 | Komposit service(s) anvender eksisterende kodelister fra den service, der bliver kaldt i de enkelte forretningsdomæner | DFDG | N/A |
1005.17.48.6 | Som serviceaftager og STAR vil jeg have udsendelse af webservicebeskeder (WSB) i forhold til Min plan universet samt udfasning ikke mere anvendte af WSRM-beskeder | DFDG | https://starwiki.atlassian.net/browse/PLAN-2602 |
1005.17.48.7 | Løsning af FB 137816 “Behov for underskiftsfelt til kommunens/jobcenterets på integrationskontrakten“ | DFDG |
|
1005.17.48.8 | Som STAR og ekstern aftager ønsker jeg services og metoder dekoreret med scopes | DFDG | |
1005.17.48.9 | Som STAR vil jeg have at LSS er overgået til REST service for Min plan universset (2024-2 kodepor) | DFDG | https://starwiki.atlassian.net/browse/PLAN-2941 https://starwiki.atlassian.net/browse/PLAN-163 https://starwiki.atlassian.net/browse/PLAN-1630 https://starwiki.atlassian.net/browse/PLAN-260 |
1005.17.48.10 | Som STAR og ekstern aftager ønsker jeg SOAP-REST converter (Samlet acc. kriterie fra de øvrige epic, der etableres i 2024-2)
Øvrige snitflader er der ikke SOAP-REST converter på | DFDG | https://starwiki.atlassian.net/browse/PLAN-1393 |
1005.17.48.11 | Som STAR vil jeg have etableret tværgående test på Min plan i forhold til de domæner, der er i spil | DFDG | |
Pakke MINPLAN-1 i DFDG moderniseringsroadmap Version 0.6 - KUN INTERN
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.48.2 | 1005.17.48.3 / 1005.17.48.10 | 1005.17.48.6 | |||
(05.03.2024) Som KSS og a-kasse skal jeg overgå til ny REST snitflade, og kan således (bortset fra Rehabilitering og Krav til jobsøgning) ikke i en overgangsperiode fortsat anvende SOAP-versionen | X | X | |||
(05.03.2024) Som KSS og a-kasse skal jeg overgå til WSB beskeder, dog bevares WSRM for aktiviteter, krav til jobsøgning og rehabilisering i en overgangsperiode |
|
| X | ||
Oversigt over berørte webservices
Bemærk at denne Oversigt over berørte webservices er den samlede varsling for alle epic relateret til Min plan (1005.17.5, 1005.17.9, 1005.17.45,1005.17.46, 1005.17.47, 1005.17.48 og 1005.17.49) . Det eneste nye er varslingen i forbindelse med denne epic af komposit metoder i servicen og WSB https://starwiki.atlassian.net/wiki/spaces/GI/pages/4014931979. Dette skulle derfor gerne give service aftager det samlede overblik hele pakken. For de oprindelige varslinger: Se de enkelte epics.
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)
1005.17.48 Samling af Min plan service og WSB - inkl. Komposit - Snitflader der etableres med denne epic
Indgik i tilsagn: til release 2023-4, bølge
|
|
|
|
|
|
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
Komposit.MinPlanService.GetMinPlan (GET /v1/MinPlan/action/Pdf) | Ny | Ny metode der erstatter GetMyPlanPdf hvor man kan hente en Min plan med alt indhold som PDF | KSS | Jobnet | Plan |
Komposit.MinPlanService.GetMinPlanMedFuldtIndhold (GET /v1/MinPlan/FuldtIndhold) | Ny | Ny metode der erstatter GetLegalMyPlanWithDetails hvor man kan hente en Min plan med alt indhold | KSS | Jobnet | Plan |
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 Min Plan (My Plan) følgende:
I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer, der er dog en forenkling i forhold til kladdefunktionaliteten i plan og uddannelsesplan (men det er håndteret i de dertil hørende epics) og ændringer til registreringen af aktiviteter.
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.
Det er ingen indberetningsregler i denne epic, da der alene er tale om GET metoder.
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 og der er ikke mulighed for at tilgå de gamle SOAP snitflader.
1005.17.48.1 Som STAR vil jeg have konsolideret Min plan og tilhørende områder så de som sammenhæng er fuldt integreret forretningsmæssigt
Løsningsmodel (internt STAR acc.kr.)
Etablering af komposit model for Min plan i Komposit domæne
Sikring af hele Min plan universet hænger samme og opfører sig som Min plan univers inkl. tilpasninger.
1005.17.48.2 - Som serviceaftager og STAR vil jeg have udstillet komposit Min plan service via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
Løsningsmodel
Ny REST service og getmetode i komposit domæne, der samler alle data i forbindelse med Min plan
Der laves et sæt af kald mod de forskellige forretningsdomæner i DFDG og data udstilles samlet i en snitflade.Kladde i Plan og Uddannelsesplan er fjernet
Ændring til registrering af aktiviteter
Fejlkoder bevares i forhold til de bagvedliggende snitflader
Der ændres ikke i adgangsforhold til service/metoder
Komposit.MinPlanService - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4014931979
Se også https://starwiki.atlassian.net/wiki/spaces/GI/pages/4032167937
(Erstatter Gl. GetLegalMyPlanWithDetails)
Metoden henter en version af borgerens minplan ud fra en teknisk nøgle.
(Erstatter Gl. GetMyPlanPdf)
Returnerer en pdf indeholdende den version af borgerens MinPlan, som indikeret i request
Udgår
1005.17.48.3 - Som serviceaftager vil jeg have udfaset de eksisterende SOAP
Løsningsmodel
DFDG fjerner/lukker de eksisterende SOAP service(s) for plan og Min plan, da det pga. ændringer ikke er praktisk muligt at lave SOAP-REST converter på Plan og Min plan service.
Serviceaftager skal derfor være opmærksom på, at der er en hård binding for alle til hvilken release service skal ibrugtages. DFDG vil udviklingsmæssigt, som aftalt, give mindst en releaseperiode, hvor den nye REST service vil være tilgængelig på DFDG udviklingsmiljøer inden de skal bruges i prod.
MyPlanService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/75819544
Service og alle metoderudgår.
Udgår. Erstattes af GetMinPlan (GET /v1/MinPlan)
Udgår. Erstattes af GetMinPlan (GET /v1/MinPlan/action/Pdf)
JobnetMyPlanService - JobnetMyPlanService (2021-3)
Service og alle metode udgår. (Intern STAR service)
Udgår. Erstattes af GetMinPlanMedFuldtIndhold (GET /v1/MinPlan/FuldtIndhold)
1005.17.48.4 - Som STAR vil jeg have, at den samlede dokumentation for servicelag og frontend lever op til STAR's principper på releasetidspunktet og er konsekvensrettet
Løsningsmodel
QA af regler fra kode mod dokumenteret regler og fejlkode
Ajourfører dokumentation
Oversigt over dokumentationsændringer der også kan hjælpe serviceaftager
Oversigt over dokumentationsændringer
I forbindelse med den større omlægning af Min plan universet til REST service, har STAR i den forbindelse valgt at samlet et overblik over de dokumentationsændringer, der er på STAR wiki således, at serviceaftager bedre kan danne sig et samlet overblik over ændringerne.
Wiki side logiske forretningssider | Ændring | Note |
|---|---|---|
https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039507969 | Mindre tekstuelle præciseringer | Sammenlign nuværende version med version 31 i historik |
- https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508105 | Fjerne beskrivelse om automatisk dannet uddannelsesplan, da det ikke mere er relevant, da borger ikke mere kan indsende udd. ønsker, steder m.v. Tilpasning omkring borger nu skal kommunikerer udd. ønsker, steder m.v. direkte med sagsbehandler | Sammenlign nuværende version med version 4 i historik. |
- - https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508125 | Ingen ændringer |
|
- - https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508198 | Tilpasning omkring borger nu skal kommunikerer udd. ønsker, steder m.v. direkte med sagsbehandler. Det gælder Trin 1, Trin 2 og Trin 3 samt flow for disse | Sammenlign nuværende version med version 1 i historik. |
- - https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508263 | Tegning af abonnementer er sket fra release 2023-4 |
|
- - - https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508298 | Ingen ændringer |
|
- - - https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508450 | Ingen ændringer |
|
- https://starwiki.atlassian.net/wiki/spaces/LOG/pages/4039508507 | Ingen ændringer |