752.7 Min Plan- Integrationskontrakt - .pdf
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 14/02-2017)

Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1 752.7.1 Borgers dannelse af aktuel Min Plan PDF
4.2 752.7.2 KSS skal kunne hente borgers aktuelle Plan som PDF.
4.3 752.7.3 Underskriftslinje på Integrationskontrakten i PDF
4.3.1 MyplanService -> GetMyPlanPdf
4.4 752.7.4 A-kasse skal kunne hente aktuel PDF med Min Plan og CV
4.5 752.7.5 Borger selv og KSS skal af historisk PDF'er kunne se Integrationskontrakt.
4.6 752.7.6 Udvidelse af Jobnetservice MyPlanServiceForDFDG
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
Jobnet user stories
7.1.1 Løbende afklaringer
7.1.2 Struktur for forskellige udgaver af Min plan PDF'er
7.1.3 US 2226: Spike om valg af tool og forudsætninger for ny PDF løsning
7.1.4 US 2227: Print styling på Min plan
7.1.5 US 2229: Generering af TOC byggeklods
7.1.6 US 2230: Generering af Jobcenter oplysninger byggeklods
7.1.7 US 2231: End-2-end test af service med Data og Service
7.1.8 US 2232: Udstilling af PDF-rendering for MyPlanServiceforDFDG
7.1.9 Hvis en blok er tom skal denne ikke vises. Dette gælder f.eks. Visitation-blokken som kun indeholder Visitationskategori. Når denne ikke skal vises på PDF skal blokken heller ikke visesUS 2233: Generering af Danskmål og dansktilegnelse byggeklods
7.1.10 US 2234: Min plan fejlhåndtering i hele stakken
7.1.11 US 2236: Generering af CV byggeklods
7.1.12 US 2237: Generering af Vejledning byggeklods
7.1.13 US 2238: Generering af underskriftslinje byggeklods
7.1.14 US 2436: Tilretning af PDF med Oplysninger om 'Nationalitet', 'Civilstand' og 'Visitation'
7.1.15 US 2228: Tilret eksisterende version af MyPlanServiceForDFDG
7.1.16 US 2239: Brug GetLegalMyPlanwithDetails service til PDF
7.1.17 US 2240: Verifikation og mapning af integrationskontraktfelter
7.1.18 US 2241: Unit test af min plan / integrationskontrakt
7.1.19 US 2242: Samlet test af Min plan varianter
7.2 Appendix A: Print styling på Min plan-eksempel
7.3 Appendix B: Ønske-TOC for Min plan indholdsfortegnelsen
8 Indholdsfortegnelse

Ændringslog

Afgrænsning af epic

Oversigt over berørte web services

Beskrivelse af epic

Denne epic til denne ISB: <Navn> <link>
Jobnet leverer PDF til Dataservice med det indhold der medsendes af Data Service, når de kalder MyPlanServiceForDFDG. Herunder gennemgås indholdet der bør fremgå i de forskellige PDF'er.
PDF til A-kasser: PDF til a-kasser skal leveres som den er i dag. Dog med den udvidelse, at den indeholder borgers på tidspunktet aktuelle jobcenter. Endvidere får de CPR efterstillet borgers navn.
PDF'en til KSSere og borger:
For den aktuelle plan inkluderes Integrationskontrakten, integrationsrelevante fravær og fritagelser, "Dansk mål" og "Dansk tilegnelse" samt borgers CV i PDF'en.
For den historiske plan inkluderes Integrationskontrakten, "Dansk mål" og "Dansk tilegnelse" i PDF'en.
I historisk såvel som aktuel PDF medtages Aktuelt jobcenter og CPR. Og forespørger KSS'ere herpå, kommer tillige underskrift.
GUI
Visitationskategori, nationalitet og ægteskabelig status skal aldrig fremgå i PDF – uanfægtet modtager og historisk/aktuel. Disse oplysninger fremgår kun af GUI.
Dette opsummeres i følgende skema:

752.7.1 Borgers dannelse af aktuel Min Plan PDF

I Epic 752.9 udvides Min Plan på Jobnet med visning af borgers eventuelle Integrationskontrakt, på et særskilt faneblad. Min Plan kan i forvejen udskrives som PDF og for borgere der har en Integrationskontrakt, skal denne føjes til PDF'en. Endelig skal borgers integrationsrelevante fravær og fritagelser samt aktuelle CV være en del af PDF'en, men ikke fremgå af PDF'er på historikken.

752.7.2 KSS skal kunne hente borgers aktuelle Plan som PDF.

KSS'ere kan i forvejen via metoden GetMyPlanPDF på metoden MyPlanService hente borgers Min Plan PDF. Som led i udvidelsen af Min Plan med Integrationskontrakten skal de, når de henter den aktuelle plan, have inkluderet Integrationskontrakten integrationsrelevante fravær og fritagelser samt borgers CV i PDF'en.

752.7.3 Underskriftslinje på Integrationskontrakten i PDF

Den første Integrationskontrakt skal underskrives fysisk af borger. Via KSS system kan sagsbehandler initiere, at den aktuelle PDF skal indeholde en linje på sidste side i den samlede Min plan. til borgers underskrift – dette er udelukkende en mulighed i de PDF'er, som KSS'erne efterspørger.

MyplanService -> GetMyPlanPdf

MyPlanService version 3 udvides metoden GetMyPlanPdf med et felt til at angive om der ønskes underskriftslinje på pdf. Hvis KSS/a-kasse kalder version 2 af servicen antages det at der ikke ønskes underskriftlinje.
Både version 2 og 3 af MyPlanService kalder den eksisterende version af servicen MyPlanServiceForDFDG i Jobnet, som blot udvides med nye inputparametre, jf. acceptkriterie 752.7.6
Input

752.7.4 A-kasse skal kunne hente aktuel PDF med Min Plan og CV

A-kassen kan i forvejen via metoden GetMyPlanPDF på metoden MyPlanService hente borgers Min Plan PDF. Der er ikke ændringer til indholdet i PDF'en til A-kassen. Jobnet ved ikke hvorvidt kald foretaget til MyPlanServiceForDFDG sker på foranledning af KSS eller A-kasse. PDF'en som returneres genereres udelukkende på baggrund af de data, som DFDG sender som inputparametre jf. 752.7.6. Det er således Data Services ansvar, udelukkende at komme med relevante data, alt afhængig af hvem der kalder Dataservice på MyPlanService.

752.7.5 Borger selv og KSS skal af historisk PDF'er kunne se Integrationskontrakt.

Borger selv og sagsbehandlere hos KSS kan i dag hente historiske PDF'er for Min Plan. For Planer hvor der er tilknyttet en Integrationskontrakt, skal denne tillige fremgå af PDF'en.
Integrationsrelevante fravær og fritagelser, aktuel visitationskategori, nationalitet, civilstand samt CV forefindes ikke historisk og vil derfor ikke fremgå. For A-kassen er der derfor intet nyt, da A-kassen fortsat blot henter den rene Min Plan PDF (dvs. uden CV og uden Integrationskontrakt mv.).
Jobnet ved ikke hvorvidt kald foretaget til MyPlanServiceForDFDG sker på foranledning af KSS eller A-kasse. PDF'en som returneres genereres udelukkende på baggrund af de data, som DFDG sender som inputparametre jf. 752.7.6. Det er således Data Services ansvar, udelukkende at komme med relevante data, alt afhængig af hvem der kalder Dataservice på MyPlanService.

752.7.6 Udvidelse af Jobnetservice MyPlanServiceForDFDG

På jobnet skal servicen MyPlanServiceForDFDG version 1, udvides med en række nye inputparametre, således at Data Service ved kald af denne, kan definere ønsket indhold på returneret PDF.
Konkret skal følgende medsendes i tillæg til eksisterende:

• • Integrationskontrakt objekt, inkluderes i MyPlan objekt.
  • Objekt for Absence inkluderes jf. jobnets entitymodel (dvs. id, fra, til og kommentar) i det omfang fravær vedrører fraværid 68 og/eller 69.
  • Boolean for, om underskriftslinje er ønsket, med default value false.
  • Boolean for, om Plan der efterspørges er historisk, med default value false.
  • MyPlan objektet udvides med borgers, på kaldetidspunktet aktuelle jobcenter, jobcenteradresse, postnummer og by,

I reltation til boolean for angivelse af hvorvidt Plan er historisk: Angives Plan for historisk, vil Jobnet ikke inkludere borgers CV.
Bemærk i øvrigt i relation til borgers jobcenter: Det er borgers aktuelle jobcenter og følgelig vil det, selv ppå historisk Min Plan PDF'er, være borgers nuværende jobcenter der fremgår. Dette er et eksplicit ønske fra PO.

Særlige krav til test

Kendte udeståender fra udviklingsfasen

Link til søgeresultat fra FogBugz på epic-nummer:

User stories

User stories er kun til interne brug for STAR's leverandører.
Eksempel på PDF af 'Min plan – Integrationskontrakt' kan ses i US 2227 Print styling på Min plan.
Jobnet user stories

Løbende afklaringer

Dette afsnit dokumenterer de løbende afklaringer, som foretages under udviklingen

Struktur for forskellige udgaver af Min plan PDF'er

"Som STAR ønsker jeg at kunne tilbyde borgere og andre aftagere af Min plan / Integrationskontrakt en specifik, samlet PDF, der gør det let at printe og læse netop denne borgers plan."
Det følgende giver et overblik over de forskellige Min plan/Integrationskontrakt PDF-udgaver inkl de forskellige byggeklodser, der bruges til at generere dem.
Ift. udseendet på Jobnet, er det vigtigt at pointere, at PDF-udgaverne på en række måder vil/kan se anderledes ud, især vil det være tydeligt i den nye PDF-only sektion "Danskmål og dansktilegnelse", der er en kombination af Danskmål-feltet der optræder i Jobmål sektionen og Dansktilegnelses-sektionen.
Dette er ikke helt korrekt. I udgangspunktet bliver der ikke pillet men i praksis har PO ønsket en række justeringer, som er blevet implementeret undervejs.Tabel 7.1: Min plan PDF - bruttoliste over "byggeklodser"

  
  Containeren 'Fravær/særlige fritagelser' skal ikke vises på PDF trukket fra Historik.
  TOC (indholdsfortegnelsen) må gerne, men behøver ikke at inkludere sidetal
  Fanebladet 'Integrationsoverblik' skal omdøbes til 'Integration'

• Overskriften på både Jobnets UI og PDF'erne skal være "Min plan – plantype", dvs.
  • "Min plan – Integrationskontrakt" (for min plan, kombiplan og plan uden plantype)
  • "Min uddannelsesplan – Integrationskontrakt"
  • "Min rehabiliteringsplan – integrationskontrakt"
  • "Min aftale om opfølgning – integrationskontrakt" (sygedp-modtagere i visitationskategori 2)

US 2226: Spike om valg af tool og forudsætninger for ny PDF løsning

Acceptkriterier:
Valg af HTML->PDF tool på Jobnet
Acceptkriterier:

• Undersøgt forskellige tool alternativer og vurderet dem ift. Jobnet
• Undersøgt om toolet vedligeholdes aktivt (gerne af mere en én udvikler)
• Undersøgt om toolet er gratis og må anvendes i projektet
• Undersøgt om toolet understøtter minimum HTML5 og CSS3 inkl. media queries

Razor views af PDF-input
Acceptkriterier:

• Undersøg om vi kan rendere razorviews direkte i Jobnets backend uden at skulle igennem http-protokollen
• Undersøg om det kan opnås uden cirkulære referencer
  • Hvis dette ikke kan opnås, skal sikkerhedsmodellen overvejes

US 2227: Print styling på Min plan

Acceptkriterier:

• Der er udarbejdet print styling til brug for HTML-elementerne i Min plan/int.kontrakt PDF'en
• Løsningen er inspireret af Appendix A: Print styling på Min plan-eksempel
• Overskriften på både Jobnets UI og PDF'erne skal være "Min plan – plantype", dvs.
  • "Min plan – Integrationskontrakt" (for jobplan, kombiplan og plan uden plantype)
  • "Min uddannelsesplan – Integrationskontrakt"
  • "Min rehabiliteringsplan – integrationskontrakt"
• Hvis planen indeholder møder og/eller aktiviteter, vises disses detalje-oplysninger i PDF'en.
• Pdf fra 'Vis PDF og udskriv' og 'Gem som PDF' i GUI og service skal ligne hinanden
• Kasser (containers) vises ikke på pdf
• CPR og navn skal stå i toppen
• "Ret og pligt"-link vises ikke på pdf

US 2229: Generering af TOC byggeklods

Acceptkriterier:

• Der er genereret en indholdsfortegnelse for den aktuelle plan med/uden sidetal jf. tabel 7.1
• Løsningen er inspireret af Appendix B: Ønske-TOC for Min Plan-PDF

US 2230: Generering af Jobcenter oplysninger byggeklods

Acceptkriterier:

• Der er genereret et razor view, der indeholder Jobcenter-navn og adresse for den aktuelle borger
• Løsningen er inspireres af Appendix A: Print styling på Min plan-eksempel
• Efter borgers navn (over Min Plan), fremgår borgers CPR nummer

US 2231: End-2-end test af service med Data og Service

Acceptkriterier:

• Sammen med Data & Service, er serviceintgrationerne testet end-2-end på toæfredsstillende vis

US 2232: Udstilling af PDF-rendering for MyPlanServiceforDFDG

Acceptkriterier:

• Der er udarbejdet en PDF-rendering og denne er udstillet på MyPlanServiceforDFDG
• Der anvendes de samme razor-views både i PL-webclient og servicen
• Der er genereret et razor view, der indeholder indholdet fra Min plan-fanen uden vejledning for den aktuelle plan
• GetPdf generer en pdf ud fra det MyPlan-objekt som DFDG sender

Hvis en blok er tom skal denne ikke vises. Dette gælder f.eks. Visitation-blokken som kun indeholder Visitationskategori. Når denne ikke skal vises på PDF skal blokken heller ikke visesUS 2233: Generering af Danskmål og dansktilegnelse byggeklods

Acceptkriterier:

• Der er genereret et razor view, der indeholder Danskmål og Dansktilegnelsesboksen
• Løsningen er inspireres af Appendix A: Print styling på Min plan-eksempel

US 2234: Min plan fejlhåndtering i hele stakken

Test: Dette er en teknisk userstory. Test foretages af udvikler.
Acceptkriterier:

• Der er implementeret tilfredsstillende fejlhåndtering i hele stakken på Min plan – integrationskontrakt løsningen

US 2236: Generering af CV byggeklods

Acceptkriterier:

• Via Asposes HTML-eksport funktionalitet, er der genereret en HTMl udgave af CV'et med den styling som kommer via Aspose
• Kontaktoplysninger skal fremgå som på den eksisterende PDF (og ikke som 'Kontaktoplysninger' container)
• CV'et skal kun vises for borgere som også har en integrationskontrakt

US 2237: Generering af Vejledning byggeklods

Acceptkriterier:

• Der er genereret et razor view, der indeholder Vejledningen for den aktuelle plan
• Løsningen er inspireres af Appendix A: Print styling på Min plan-eksempel

US 2238: Generering af underskriftslinje byggeklods

Acceptkriterier:

• Der er genereret et razor view, der indeholder underskriftlinjen
• Løsningen er inspireres af Appendix A: Print styling på Min plan-eksempel

US 2436: Tilretning af PDF med Oplysninger om 'Nationalitet', 'Civilstand' og 'Visitation'

Acceptkriterier:

• Oplysninger om 'Nationalitet', 'Civilstand' og 'Visitation' skal fremgå af PDF'en

US 2228: Tilret eksisterende version af MyPlanServiceForDFDG

"Som DS ønsker jeg MyPlanServiceForDFDG udvidet, så jeg kan supplere med relevante IK input og få returneret PDF med relevant Plan, eventuel IK og CV"
Hints til tester: Ved kald af historisk PDF er det jf. PO ok, at det er borgers aktuelle - og ikke det historiske - jobcenter der vises. Denne beslutning er blevet omgjort og disse oplysninger skal derfor fremgå af PDF'en. Dette ligger i US 2436
Acceptkriterier:

• MyPlanServiceForDFDG tilrettes så den tager følgende inputparametre:
  • Integrationskontrakt objekt inkluderes i MyPlan objekt.
  • Objekt for Absence jf. jobnets entitymodel (dvs. id, fra, til og kommentar) i det omfang det vedrører fravær id 68 og/eller 69.
  • Boolean for, om underskriftslinje er ønsket, med default value false.
  • Boolean for, om Plan der efterspørges er historisk, med default value false.
  • MyPlan objektet udvides med borgers, på kaldetidspunktet aktuelle jobcenter, jobcenteradresse, postnummer og by.
  • Borgers CPR nummer
  • Borgers CVnummer
  • AsylTransitionDate

Hints til udvikler:
Ved kald af service ved Jobnet ikke om det er borgers aktuelle eller en historisk plan. Den historiske PDF skal dog ikke indeholde CV. Derfor er Jobnet nødt til at få at vide af DS om CV skal inkluderes eller ej.
I relation til DS's anvendelse af denne service: Ved historisk kald skal ikke medsende data om absence, da absence ikke skal fremgå af historik og ansvar herfor ligger hos DS.

US 2239: Brug GetLegalMyPlanwithDetails service til PDF

Acceptkriterier:

• Min plan PDF kan dannes, ved brug af GetLegalMyPlanwithDetails servicen

US 2240: Verifikation og mapning af integrationskontraktfelter

Acceptkriterier:

• Alle relevante felter til brug for Min plan / integrationskontrakt er mappet igennem fra servicen og verificeret

US 2241: Unit test af min plan / integrationskontrakt

Acceptkriterier:

• Der er implementeret unit test af min plan / integrationskonkrakt elementerne

US 2242: Samlet test af Min plan varianter

Acceptkriterier:

• Samtlige kombinationer af kontaktgrupper og plantyper er testet ok

Appendix A: Print styling på Min plan-eksempel

Hvis det er en kombiplan vises her en divider (AS IS) efterfulgt af Udd.plan

Her følger de øvrige containere fra Integration-fanebladet.
Dernæst kommer CV'et (AS IS)
Til sidst kommer Vejledning og evt. Underskriftslinje:

Appendix B: Ønske-TOC for Min plan indholdsfortegnelsen

Indholdsfortegnelse