1005.17.49 Omlægning af EducationPlanservice m.v. fra SOAP til REST - Ny simpel model uden borgerønsker
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
Denne epic er løsningsmæssigt ændret grundlæggende i forhold til den tidligere udsendte. Baggrunde for dette kan ses i afsnittet 6.2 Regler.
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
|---|---|---|---|---|---|---|
@Jens Andersen @Knud de Place (STAR) | @Carsten Olsen | 2024-1 - DFDG udvikling 2024-1 - Tilgængelig i test | 2024-2 | 2024-2 | 1.0 | KSS, A-kasse |
Indgik i tilsagn:
til release 2023-4, bølge 1
til release 2024-1, bølge 3 med denne mere simple løsningsmodel, hvor borgeres indberetning fra Jobnet af uddannelsesønsker og uddannelsessteder udgår
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? |
|---|---|---|---|
15.06.2023 | 0.3 | Carsten Olsen | Oprettet i version 0.3 med indhold |
06.11.2023 | 0.3 | Carsten Olsen | Omlagt til udgave uden indberetning af borgers udd. ønsker og steder |
27.02.2024 | 0.5 | Knud de Place | (2702.2024) Opdateret “Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer“ med at at borger ikke mere kan indskrive udd.ønsker m.v. på Jobnet. |
04.03.2024 | 0.5 | Carsten Olsen | Præcisering om at
|
04.03.2024 | 0.5 | Knud de Place | Skitse til hvordan udd.pålæg på Jobnet påvirkes (AC-12) - link indsat til underside til epic |
07.03.2024 | 0.5 | Knud | Internt: Opdateret beskrivelse under AC-3 (fjernet link til JobnetEducationPlanService) |
21.05.2024 | 1.0 | Knus | v1.0 (eksternt) |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/JOB-7768
https://starwiki.atlassian.net/browse/DS-10091
https://starwiki.atlassian.net/browse/PLAN-1750
https://starwiki.atlassian.net/browse/BI-2292
https://starwiki.atlassian.net/browse/JOBS-4639
https://starwiki.atlassian.net/browse/JOBS-3000
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.49.1 - Som STAR vil jeg have flyttet forretningsområdet uddannelsesplan til forretningsdomænet (silo) borgerindsats
- 5.4.1 Løsningsmodel
- 5.5 1005.17.49.2 - Som serviceaftager og STAR vil jeg have udstillet EducationPlanService og JobnetEducationPlanService via ny REST snitflade med tilpasset og forsimplet forretningsflow bl.a. med afskaffelse af kladdebegreb på boregens ønsker
- 5.6 1005.17.49.3 - Som serviceaftager kan jeg ikke beholde de eksisterende SOAP services uændret
- 5.6.1 EducationPlanService -
- 5.6.2 JobnetEducationPlanService -
- 5.6.3 PlanService -
- 5.6.3.1 GetPlan - GetPlan
- 5.6.3.2 GetPlanVersions - GetPlanVersions
- 5.6.3.3 PublishPlan - PublishPlan
- 5.7 1005.17.49.4 - Som STAR vil jeg have datakonvertering og dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) inkl. kontaktperson i DOA
- 5.7.1 Løsningsmodel
- 5.8 1005.17.49.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.8.1 Løsningsmodel
- 5.9 1005.17.49.6 - Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.9.1 Løsningsmodel
- 5.10 1005.17.49.7 - Som serviceaftager og STAR vil jeg have udstillet kodelisterne for Uddannelsesplan
- 5.10.1.1 Løsningsmodel
- 5.10.2 Borgerindsats.CodeLists -
- 5.10.3 DFDG CodeListService (version 5) -
- 5.11 1005.17.49.8 - Død kode i DFDG, i forbindelse med Min plan fjernes. Samles i en userstorie under epic 1005.17.48 Samling af Min plan og komposit Min plan service og webservicebeskeder
- 5.11.1 Løsningsmodel
- 5.12 1005.17.46.9 - Landssupport/LSS er skiftet over til at brug den nye REST-servicen for Plan og MinPlanService, i stedet for EducationPlanService, PlanService og MyPlanService fra DFDG classic
- 5.12.1 Løsningsmodel
- 5.13 1005.17.49.10 - Udsendelse af webservicebeskeder og udfasning af WSRM (se epic 1005.17.48)
- 5.13.1 Løsningsmodel
- 5.14 1005.17.49.11 Som borger vil jeg have at jeg ikke mere kan indberette ønsker til uddannelses, steder m.v. på Jobnet
- 5.14.1 Løsningsmodel
- 5.15 1005.17.49.12 Som STAR vil jeg have at Jobnet classic benytter de nye REST service for Min Plan Komposit
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
Afgrænsning af epic
Afgrænsning | |||
|---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for EducationPlanService og JobnetEducationPlanService til REST inkl. at uddannelsesplan kobles sammen med plan såledesat
som en del af STAR's 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 | User stories (interne links) |
1005.17.49.1 | Som STAR vil jeg have flyttet forretningsområdet uddannelsesplaner/-pålæg til forretningsdomænet (silo) borgerindsats inkl. at det lever op til de principper, der er fastsat og specifikt med den forretningsændring, at
| DFDG |
|
1005.17.49.2 | Som serviceaftager og STAR vil jeg have udstillet EducationPlanService og JobnetEducationPlanService via ny REST https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809 snitflade med tilpasset og forsimplet forretningsflow bl.a. med afskaffelse af kladdebegreb og borgers indberetning af ønsker til uddannelse, uddannelsessted m.v | DFDG, Jobnet |
|
1005.17.49.3 | Som serviceaftager kan jeg ikke beholde de eksisterende SOAP service uændret. | DFDG, Jobnet |
|
1005.17.49.4 | Som STAR vil jeg have datakonvertering og dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) inkl. kontaktperson i DOA | BI |
|
1005.17.49.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.49.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | DFDG, SF |
|
1005.17.49.7 | Som serviceaftager og STAR vil jeg have udstillet kodelisterne for Uddannelsesplan | DFDG |
|
1005.17.49.8 | Død kode i DFDG, i forbindelse med Min plan fjernes. Samles i en userstorie under epic 1005.17.48 Samling af Min plan og komposit Min plan service og webservicebeskeder |
| |
1005.17.46.9 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen for Plan og MinPlanService, i stedet for EducationPlanService, PlanService og MyPlanService fra DFDG classic | DFDG |
|
1005.17.49.10 | Udsendelse af webservicebeskeder og udfasning af WSRM (se epic 1005.17.48) | DFDG |
|
1005.17.49.11 | Som borger vil jeg have at jeg ikke mere kan indberette ønsker til uddannelse, uddannelsessteder, optagelse m.v. | Jobnet |
|
1005.17.49.12 | Som STAR vil jeg have at Jobnet classic benytter de nye REST service for Min Plan Komposit | Jobnet |
|
Pakke MINPLAN-1 (Del 3) i DFDG moderniserings og forretnings roadmap for serviceaftagere
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.49.2 | 1005.17.49.3 |
|
| ||
Som KSS skal jeg overgå til ny REST snitflade i https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809 som fremadrettet anvendes til at indberette uddannesespålæg | X |
|
|
|
|
Som KSS kan jeg ikke i en overgangsperiode fortsat anvende SOAP-versionen, jeg skal tage de nye REST service i brug i den aftalte release |
| X |
|
| Da bl.a kladdebegrebet forsvinder og der sker andre tekniske forenklinger, kan SOAP services ikke bevares i en overgangsperiode |
Som KSS kan jeg ikke mere hente borgeres ønsker til uddannelse og steder |
| X |
|
| Se beskrivelse af evt. overgangsordning. |
(04.03.2024): Som a-kasse skal jeg overgå til version 2 af REST snitflade i https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809 |
| X |
|
|
|
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.
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader |
|---|---|---|---|---|
Ny | Erstatter EducationRetentionTypeIdentifierType | A-kasse, KSS | Jobnet | |
Ny | Erstatter EducationPlanStepTypeIdentifierType | A-kasse, KSS | Jobnet | |
Ny | Erstatter EducationStatusTypeIdentifierType | A-kasse, KSS | Jobnet | |
Borgerindsats.PlanService (Version 2, 2024-2).CreatePlan (POST /v1/Plan/{planversionId?}) | Ny | Udvidelse af CreatePlan så det bliver muligt at registrerer uddannelsespålæg | A-kasse, KSS | Jobnet |
Borgerindsats.PlanService (Version 2, 2024-2).GetPlan (Get /v1/Plan/{planversionId}) | Ny | Udvidelse af GetPlan så det bliver muligt at hente uddannelsespålæg | A-kasse, KSS | Jobnet |
CodeListService (Version 5, 2023-2).EducationPlanStepTypeIdentifierType | Udgået | Erstattes af Borgerindsats.UddannelsesplanTrinTypeCodeList | A-kasse, KSS | Jobnet |
CodeListService (Version 5, 2023-2).EducationRetentionTypeIdentifierType | Udgået | Erstattes af Borgerindsats.CodeLists.StoettebehovTypeCodeList | A-kasse, KSS | Jobnet |
CodeListService (Version 5, 2023-2).EducationStatusTypeIdentifierType | Udgået | Erstattes af Borgerindsats.CodeLists.Borgerindsats.UddannelsesstatusTypeCodeList | A-kasse, KSS | Jobnet |
Udgået | Erstattes af CreateUdannelsesPlan (POST /v1/Uddannelsesplan) og UpdateUdannelsesPlan (PUT /v1/Uddannelsesplan/{uddannelsesplanId}) | KSS | N/A | |
Udgået | Udgår da den ikke anvendes mere til uddannelsesinstitutioner | N/A | Jobnet | |
Udgået | Udgår og erstattes af IndberetUdannelsesoensker (PUT /v1/Uddannelsesoensker/action/indberet) | N/A | Jobnet | |
Udgået | Udgår og erstattes af CreateUdannelsesoensker (POST /v1/Uddannelsesulan/{uddannelsesplanId}) og UpdateUdannelsesoensker (PUT /v1/Uddannelsesoensker/{uddannelsesplanId}) | N/A | Jobnet | |
Udgået | Udgår. Uddannelsesplan skal ikke mere publicerets | A-kasse, KSS | N/A |
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 uddannelsesplan, som en del af helt Min plan området, følgende:
I DFDG et skift til REST snitflade - og i denne epic samtidige med en forretningsmæssig udfasning af den unges mulighed for fra Jobnet at indberette uddannelsesønsker, uddannelsessteder m.v. samt en forenkling i forhold til kladdefunktionaliteten i plan og uddannelsesplan.
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.
Forretningsmæssigt ændres der ikke i reglerne for jobcentrets indberetning, men:
Da kladdebegrebet forsvinder, ændres der i det tekniske flow - dette flow forenkles. Dette er i forlængelse af de forenklinger, der er sket med hensyn kladde i Plan, se i epic https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4007493633.
Da borgeres mulighed at indberette uddannelsesønsker og steder til sagsbehandleren i jobcentret via Jobnet og DFDG forsvinder/udfases, kan disse ikke mere hentes i DFDG og sagsbehandleren skal gennem de afholdte samtaler med den unge afdække disse ønsker
Baggrunden for afskaffelse af den unges mulighed for at indberette disse uddannelsesønsker og steder skal ses i
Det begrænsede antal indberetninger der p.t. sker fra Jobnet
Den relative komplekse it-understøttelse af dette på Jobnet
Den usikkerhed der er, jf. Reformkommisionens anbefalinger, om uddannelsespålæg og dets fremtid. I denne sammenhæng er der dog intet konkret, kun det der er givet udtryk for i Kommissionens anbefalinger.
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 for registrering og opdatering af uddannelsesplan fra sagsbehandler - og der er ikke mulighed for at tilgå de gamle SOAP snitflader for disse operationer
(04.03.2024): Selve uddannelsespålægget ændres ikke, men indberettes via https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809 og ikke mere på en selvstændig service. Det betyder:
For a-kasser at der skal opgraderes til version 2 af https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809
For KSS skal der indberettes via https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3807215809, dog kan det kaldemæssigt ske i to trin svarede til det flow ,der var brugt i DFDG classic.
Mht. den unges ønsker til uddannelse og uddnanelsessteder skal KSS på den eksisterende SOAP service og metoder (GetPlanVersions og GetPlan), hvis nødvendigt, afstubbe disse kald af på KSS siden. DFDG fjerner metoderne.
Uddannelsesplan kobles til Plan, og kladdebegrebet samt publicering via plan udfases. Dvs. Uddannelsespålægget kobles tættere med plan og vil være en specialisering af plan
Sagsbehandler i jobcenter (27.02.2024/04.03.2024):
Sagsbehandler skal for alle unge i den almindelige dialog afdække ønsker til uddannelse, uddannelsessteder m.v. på de enkelte trin. Dette er ikke en ændring til hvad der i dag sker mellem sagsbehandler og den unge for det store flertal af unge, der ikke har anvendt de hidtidige registreringsmuligheder på Jobnet til at kommunikere til sagsbehandleren om uddannelsesønsker, ansøgning om optagelse og om eventuel optagelse på uddannelse. Sagsbehandleren kan stadig sætte en frist på trinet og denne kan ses af den unge på Jobnet.
Den unge vil skulle indgive / kommunikere ønsker til uddannelse, uddannelsessteder m.v. på de enkelte trin til sagsbehandler, der fremover alene vil kunne forestå registreringen
1005.17.49.1 - Som STAR vil jeg have flyttet forretningsområdet uddannelsesplan til forretningsdomænet (silo) borgerindsats
Løsningsmodel
DFDG etablerer/flytter uddannelsesplan og dennes kobling til Min plan i sammenhæng med de andre Min plan elementer til de nye DFDG forretningsdomæner. Uddannelsesplan flyttes sammen med Plan og Min plan til Borgerindsats.
Borgeres mulighed for at indberette uddannelsesønsker og uddannelsessteder fjernes fra Jobnet se Acc. Kri. 1005.17.49.11
1005.17.49.2 - Som serviceaftager og STAR vil jeg have udstillet EducationPlanService og JobnetEducationPlanService via ny REST snitflade med tilpasset og forsimplet forretningsflow bl.a. med afskaffelse af kladdebegreb på boregens ønsker
Løsningsmodel
DFDG udvider eksisterende REST planservice med data vedr. uddannelsespålæg. Det betyder at core delen af plan kan/skal indberettes ( af KSS) samtidig med uddannelsesplan for de borgere, der har en uddannelsespålæg. Det er derfor kun muligt gemme en uddannelsesplan ved også udfylde uddannelsesplandelen i UddannelsesplanDto
Borgerindsats.PlanService - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4194861057
CreatePlan - CreatePlan (POST /v1/Plan/{planversionId?})
Erstatter SaveEducationPlan.
Opretter uddannelsesønsker/uddannelsessteder samt kommentar til borgers uddannelsesplan sammen med de øvrige plandata.
GetPlan - GetPlan (Get /v1/Plan/{planversionId})
Henter plan og uddannelsesplan.
Erstatter https://starwiki.atlassian.net/wiki/spaces/FYS/pages/75820256.GetPlan.
Borgerindsats.BorgerindsatsStatusService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4066246662
(04.03.2024): Det er ikke planlagt atforetage ændringer i BorgerindsatsStatusService i regi af denne epic i 2024-2
GetBorgerindsatsPersonStaus - GetBorgerindsatsPersonStatus
Ny personstatusservice for Borgerindsats domænet.
Afløser https://starwiki.atlassian.net/wiki/spaces/FYS/pages/403111998. Bemærk der i PSS ikke har være uddannelsesplan data.
1005.17.49.3 - Som serviceaftager kan jeg ikke beholde de eksisterende SOAP services uændret
DFDG fjerner/lukker de eksisterende SOAP service for plan, uddannelsesplan 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 test- og udviklingsmiljøer.
EducationPlanService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/75816369
EducationPlanService udgår.
Se https://starwiki.atlassian.net/wiki/spaces/GI/pages/4194861057.
SaveEducationPlan - SaveEducationPlan
Udgår og erstattes af CreateUdannelsesPlan (POST /v1/Uddannelsesplan) og UpdateUdannelsesPlan (PUT /v1/Uddannelsesplan/{uddannelsesplanId})
GetEducationPlanPdf - GetEducationPlanPdf
Udgår da den ikke anvendes mere til uddannelsesinstitutioner (oversendelse af at den unge havde et udd.pålæg - brev til institutionens eBoks).
JobnetEducationPlanService - https://starwiki.atlassian.net/wiki/spaces/FYS/pages/75854667
JobnetEducationPlanService udgår.
SaveEducations - SaveEducations
Udgår og erstattes af CreateUdannelsesoensker (POST /v1/Uddannelsesulan/{uddannelsesplanId}) og UpdateUdannelsesoensker (PUT /v1/Uddannelsesoensker/{uddannelsesplanId}).
ReportToCaseWorker - ReportToCaseWorker
Udgår og erstattes af IndberetUdannelsesoensker (PUT /v1/Uddannelsesoensker/action/indberet).
GetEducationPlanPdf - GetEducationPlanPdf
Udgår da den ikke anvendes mere til uddannelsesinstitutioner (oversendelse af at den unge havde et udd.pålæg - brev til institutionens eBoks).