828.2 Nudging i forhold til 225-timers regel
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 14/02-2017)

...

STAR Product Owner (PO)

...

Knud de Place, KPP@STAR.dk

...

Forretningsanalytikere (FA).
Evt. arkitekter, UX m. fl.

...

Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1.1 Opfyld 225 timers reglen
4.1.2 Overblik over timer ift. vedligeholdelse af 225 timers kravet
4.1.3 Få ret til fuld hjælp igen (til borgere, der er ramt af 225-timers regel)
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
7.1 Implementer CounterService på Jobnet (US: 2344)
7.2 Implementer nyt menupunkt (US 2434)
7.3 225 timers data rundt om speedometer (US: 2374)
7.4 Speedometer ved 225 timers reglen (US: 2375)
7.5 Førstegangsvisning af høj/lav ydelse
7.6 Kode på dokumentationsarkiv (US 2450)

...

Afgrænsning af epic

Oversigt over berørte web services

Beskrivelse af epic

Denne epic til denne ISB: <Navn> <link>
I 2017-4 kunne vi ikke komme i mål med visning af borgers timer i Jobnet, når de var ramt af 225 timers reglen. Konkret var der ikke datagrundlag i servicen til at skelne mellem om borger skal have vist speedometer for høj eller reduceret ydelse. Dette forhold er der nu rettet op på, da KMD Aktiv supplerer med de manglende data og Data Service i sidste sprint af 2017-4 (i E 828.1) leverede Counterservice, med de manglende felter.

Opfyld 225 timers reglen

For at understøtte, at borgere forstår deres situation og tilskyndes til at nå målet om 225 timers arbejde inden for et år, er der i nedenstående udarbejdet et forslag til koncept for visning af arbejdstimer i jobreformen for borger omfattet af 225 timers reglen, som er baseret på indsigter fra adfærdsøkonomi og nudging.

...

Grundforudsætningen for designet er, at visualiseringen viser data, som STAR modtager fra KMD Aktiv (og senere KY) i relation til 225 timers reglen.
Dermed foretages i DFDG/Jobnet som udgangspunkt ikke beregninger på data. Herved vil borger kunne se/få oplyst de samme data ved henvendelse i kommunen.
I visualiseringen vil borger, som står til at blive omfattet af 225 timers kravet (dvs. borgere, der er blevet varslet og har fået en bortfaldsdato), kunne få en visuel præsentation af, hvor mange arbejdstimer han/hun har arbejdet de seneste 12 måneder, og hvornår fristen er for at opfylde 225 timers reglen (bortfaldsdatoen), samt mange timer vedkommende mangler for at opfylde 225-timers kravet på tidspunktet for visningen.
Arbejdstimer vises i et speedometer, som kendes fra visning af arbejdstimer i dagpengereformen. Borgers timer fremgår dels af den grønne markering i speedometeret og dels i centrum af speedometeret (som fortsætter optælling).
Der anvendes variablen " Optalt timer", som angiver antal timer optalt i perioden jf. variablene "optælstartdato" til "optælslutdato".
Det vil fremgå øverst i visualiseringen over speedometeret, hvilken periode timetallet omhandler, så borger kan følge med i, om data er forsinkede / hvor gammel opgørelsen er.

I boksen under speedometeret oplyses borger om antal timer, som borger mangler.
Der anvendes variablen "Bortfaldsdato" i teksten under speedometeret til at angive frist for opfyldelse af 225 timers reglen.

Beregning i Jobnet

Det vurderes muligt i it-implementeringen af visualiseringen at skabe en simpel beregning af forskellen mellem 225 timer og antal optalte timer ift. at angive antal timer som borger mangler for at opnå mindst 225 timer på tidspunktet for visningen.
Formel: 225 timer minus [Optalt timer]

Info-tekst

Der skal integreres en tekst om, at data er vejledende og baseret på kommunens indberetninger, og at borger kan få vejledning om arbejdstimer og mulighed for småjobs hos sin sagsbehandler.
Her kan også gives gode råd til jobsøgning fx via brug af netværk.
Fokus-punkter:

...

Få ret til fuld hjælp igen (til borgere, der er ramt af 225-timers regel)

...

Kendte udeståender fra udviklingsfasen

...

• CounterService version 1 er implementeret på Jobnet.
• Følgende felter mappes igennem til entities-model:
  • CurrentAidLevelIsHigh (boolean, forekomst 1)
  • CalculationDate (date, forekomst 1)
  • NumberOfHoursInWorkPeriod (datatype int, forekomst 1)
  • QualifyingHoursTransitionDate (date, forekomst 0-1)
  • LastPossibleDate (date, forekomst 0-1)

• Følgende fejlscenarier, jf. fejlkode listen, er håndteret ved kald af service:
  • Ugyldigt CPR angivet som inputparameter.
  • UkendtCPR angivet som parameter.

...

Hints til udvikler: CounterService er en helt ny service. Metoden GetSocialAidWorkHours returnerer de felter, der skal bruges under det kommende menupunkt "Mine ydelser" på "Min side". Der returneres mange felter, men JF. US 2374 skal kun bruges de under acceptkriterierne angivne.
Requestet tager borgers CPR som inputparameter, med to mulige fejlkoder:
Jobnet har ved borgers login adgang til CPR, hvilket gemmes i security token. Hør nærmere hos John, der netop er ved at udfærdige denne løsning ved løft af PSS til version 20. Felterne der skal mappes jf. response er: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/77577227/CounterService+Version+1+2017-4

Implementer nyt menupunkt (US 2434)

...

"Ved klik på menupunkt '225 timers reglen' vil jeg som borger, på Jobnet, kunne se mine data i relation til '225 timers reglen'."
Hint: Borger kan være på høj eller lav ydelse, hvilket afspejles af CurrentAidLevelIsHigh (true hvis høj ydelse og false hvis lav ydelse). Hvis ydelse er høj skal der vises forskellige tekster og informationsbokse i samme GUI, i forhold til hvis ydelse er lav.

Herover GUI for "Høj ydelse"

Herover GUI for "Lav ydelse"
Acceptkriterier

• Ved klik på menupunkt "225-timersreglen" fremkommer GUI som specificeret.
• Data fra entitetsmodellen bindes mod viewmodellen/eller handles på som følger:
• Er borger på "Høj ydelse" (dvs. CurrentAidLevelIsHigh = true), resulterer klik på I-ikon til højre for overskriften "225-timersreglen" i visning af nedenfor viste boks:
  • Er borger dog på "Lav ydelse" (dvs. CurrentAidLevelIsHigh = false), vises i stedet følgende boks:

    Anchor
    _GoBack _GoBack

    
• Af øverste venstre hjørne fremgår efter teksten "Data er fra " datoen for seneste kalkulation, efter formatet "29. oktober 2017". Hint: Dato for kalkulation kan ses af CalculationDate (Date, forekomst 1)

...

• Er borger på "Høj ydelse", resulterer klik på I-ikon til højre for "Arbejdstimer" i visning af følgende boks, hvor datoen markeret med rød firkant er datoen CalculationDate:

• • Er borger på "Lav ydelse", resulterer klik på I-ikon til højre for "Arbejdstimer" i visning af boksen herunder.

• Er borger på "høj ydelse", skal ordlyden på linjen under "Følg med i dine arbejdstimer" lyde således: "225 timer undgår fald i ydelse. "
  • Er borger derimod på lav ydelse, skal ordlyden være: "225 timer for at gå op i ydelse. "

• Ved klik på menupunkt "225-timersreglen" vises antallet af timer, som borger har arbejdet, som et heltal i midten af speedometer. Tallet afspejles tillige på den grønne skala. Hint: Timer leveres som integer i NumberOfHoursInWorkPeriod, der har forekomst 1

• • Er borgers leverede timer større end 225, vises tallet i midten af speedometer, men speedometer selv stopper ved 225.
• For borgere på "Høj ydelse": I det blå område nederst, skal fremgå hvor mange timer, borger mangler at arbejde, jf følgende visning: "Du mangler [225 fratrukket NumberOfHoursInWorkPeriod] arbejdstimer før den [LastPossibleDate]".

...

• • For borgere på "Lav ydelse" skal ordlyden være: "Du mangler [225 fratrukket NumberOfHoursInWorkPeriod] for at gå op i ydelse".

• Ved klik på I-ikon udfor teksten "Du mangler…", skal for borgere på "Høj ydelse" fremkomme en boks med følgende tekst, hvor datoen med rød firkant er CalculationDate og datoen med blå firkant er LastPossibleDate. Datoer angives formateret som vist.

• • Har LastPossibleDate forekomst 0, angives i stedet for dato teksten: "(Dato ikke oplyst*) og nederst i den grønne boks, med en blank linje til teksten ovenover, skrives: "*) Du skal bede din kommune om at oplyse denne dato".

• Er borger derimod på "lav ydelse" skal klik på I-ikon føre til nedenfor viste boks, hvor datoen fremhævet med rød firkant er CalculationDate.

• Knappen "Find Job" linker til forsiden af Find Job, som borger, ved klik, dirigeres til i samme vindue.

Førstegangsvisning af høj/lav ydelse (US 2451)

...

"Som PO ønsker jeg Google Analytics på 225 timers reglen"
Acceptkriterier:

• Der udfærdiges eventtracking på I-ikoner ud fra følgende skema:

   

  	Hændelsesetiket	Hændelseskategori	Handling ved hændelse
  Ved klik på ikon 1	225 timers reglen	Hjælp	I-ikon Høj ydelse: Forklaring 225 timers regel
  Ved klik på ikon 2	225 timers reglen	Hjælp	I-ikon Høj ydelse: Dine reg. arbejdstimer
  Ved klik på ikon 3	225 timers reglen	Hjælp	I-ikon Høj ydelse: Manglende arbejdstimer
  Ved klik på ikon 4	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: forklaring 225 timers regel
  Ved klik på ikon 5	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: Dine reg. arbejdstimer
  Ved klik på ikon 6	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: Manglende arbejdstimer
  Ved første klik på menupunkt "225 timers regel" på høj ydelse og load af modal	225 timers reglen	Hjælp	Modal. Høj ydelse. Forklaring 225 timers regel
  Ved første klik på menupunkt "225 timers regel" på lav ydelse og load af modal	225 timers reglen	Hjælp	Modal. Nedsat ydelse. Forklaring 225 timers regel

  
  828.2 Nudging i forhold til 225-timers regel
  Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
  (Skabelon af dato 14/02-2017)

  STAR Product Owner (PO)	Knud de Place, KPP@STAR.dk
  Forretningsanalytikere (FA). Evt. arkitekter, UX m. fl.	KEIL (Kenneth Ingemann Larsen), KEIL@NNIT.com

  
  Indholdsfortegnelse
  1 Ændringslog
  2 Afgrænsning af epic
  3 Oversigt over berørte web services
  4 Beskrivelse af epic
  4.1.1 Opfyld 225 timers reglen
  4.1.2 Overblik over timer ift. vedligeholdelse af 225 timers kravet
  4.1.3 Få ret til fuld hjælp igen (til borgere, der er ramt af 225-timers regel)
  5 Særlige krav til test
  6 Kendte udeståender fra udviklingsfasen
  7 User stories
  7.1 Implementer CounterService på Jobnet (US: 2344)
  7.2 Implementer nyt menupunkt (US 2434)
  7.3 225 timers data rundt om speedometer (US: 2374)
  7.4 Speedometer ved 225 timers reglen (US: 2375)
  7.5 Førstegangsvisning af høj/lav ydelse
  7.6 Kode på dokumentationsarkiv (US 2450)

Anchor
_Toc430086832 _Toc430086832

Anchor
_Toc430087177 _Toc430087177

Anchor
_Toc495317318 _Toc495317318

Anchor
_Toc495326365 _Toc495326365

Ændringslog

...

Anchor
_Toc430086833 _Toc430086833

Anchor
_Toc430087178 _Toc430087178

Anchor
_Toc495317319 _Toc495317319

Anchor
_Toc495326366 _Toc495326366

Afgrænsning af epic

Anchor
_Toc430086834 _Toc430086834

Anchor
_Toc430087179 _Toc430087179

Anchor
_Toc495317320 _Toc495317320

Anchor
_Toc495326367 _Toc495326367

Oversigt over berørte web services

Anchor
_Toc430086835 _Toc430086835

Anchor
_Toc430087180 _Toc430087180

Anchor
_Toc495317321 _Toc495317321

Anchor
_Toc495326368 _Toc495326368

Beskrivelse af epic

Denne epic til denne ISB: <Navn> <link>
I 2017-4 kunne vi ikke komme i mål med visning af borgers timer i Jobnet, når de var ramt af 225 timers reglen. Konkret var der ikke datagrundlag i servicen til at skelne mellem om borger skal have vist speedometer for høj eller reduceret ydelse. Dette forhold er der nu rettet op på, da KMD Aktiv supplerer med de manglende data og Data Service i sidste sprint af 2017-4 (i E 828.1) leverede Counterservice, med de manglenede felter.

Anchor
_Toc486835560 _Toc486835560

Anchor
_Toc495317322 _Toc495317322

Anchor
_Toc495326369 _Toc495326369

Opfyld 225 timers reglen

...

Grundforudsætningen for designet er, at visualiseringen viser data, som STAR modtager fra KMD Aktiv (og senere KY) i relation til 225 timers reglen.
Dermed foretages i DFDG/Jobnet som udgangspunkt ikke beregninger på data. Herved vil borger kunne se/få oplyst de samme data ved henvendelse i kommunen.
I visualiseringen vil borger, som står til at blive omfattet af 225 timers kravet (dvs. borgere, der er blevet varslet og har fået en bortfaldsdato), kunne få en visuel præsentation af, hvor mange arbejdstimer han/hun har arbejdet de seneste 12 måneder, og hvornår fristen er for at opfylde 225 timers reglen (bortfaldsdatoen), samt mange timer vedkommende mangler for at opfylde 225-timers kravet på tidspunktet for visningen.
Arbejdstimer vises i et speedometer, som kendes fra visning af arbejdstimer i dagpengereformen. Borgers timer fremgår dels af den grønne markering i speedometeret og dels i centrum af speedometeret (som fortsætter optælling).
Der anvendes variablen " Optalt timer", som angiver antal timer optalt i perioden jf. variablene "optælstartdato" til "optælslutdato".
Det vil fremgå øverst i visualiseringen over speedometeret, hvilken periode timetallet omhandler, så borger kan følge med i, om data er forsinkede / hvor gammel opgørelsen er.

I boksen under speedometeret oplyses borger om antal timer, som borger mangler.
Der anvendes variablen "Bortfaldsdato" i teksten under speedometeret til at angive frist for opfyldelse af 225 timers reglen.

Beregning i Jobnet

Det vurderes muligt i it-implementeringen af visualiseringen at skabe en simpel beregning af forskellen mellem 225 timer og antal optalte timer ift. at angive antal timer som borger mangler for at opnå mindst 225 timer på tidspunktet for visningen.
Formel: 225 timer minus [Optalt timer]

Info-tekst

Der skal integreres en tekst om, at data er vejledende og baseret på kommunens indberetninger, og at borger kan få vejledning om arbejdstimer og mulighed for småjobs hos sin sagsbehandler.
Her kan også gives gode råd til jobsøgning fx via brug af netværk.
Fokus-punkter:

...

Anchor
_Toc486835562 _Toc486835562

Anchor
_Toc495317324 _Toc495317324

Anchor
_Toc495326371 _Toc495326371

Få ret til fuld hjælp igen (til borgere, der er ramt af 225-timers regel)

...

Anchor
_Toc430086837 _Toc430086837

Anchor
_Toc430087182 _Toc430087182

Anchor
_Toc495317326 _Toc495317326

Anchor
_Toc495326373 _Toc495326373

Kendte udeståender fra udviklingsfasen

...

• CounterService version 1 er implementeret på Jobnet.
• Følgende felter mappes igennem til entities-model:
  • CurrentAidLevelIsHigh (boolean, forekomst 1)
  • CalculationDate (date, forekomst 1)
  • NumberOfHoursInWorkPeriod (datatype int, forekomst 1)
  • QualifyingHoursTransitionDate (date, forekomst 0-1)
  • LastPossibleDate (date, forekomst 0-1)

• Følgende fejlscenarier, jf. fejlkode listen, er håndteret ved kald af service:
  • Ugyldigt CPR angivet som inputparameter.
  • UkendtCPR angivet som parameter.

...

Hints til udvikler: CounterService er en helt ny service. Metoden GetSocialAidWorkHours returnerer de felter, der skal bruges under det kommende menupunkt "Mine ydelser" på "Min side". Der returneres mange felter, men JF. US 2374 skal kun bruges de under acceptkriterierne angivne.
Requestet tager borgers CPR som inputparameter, med to mulige fejlkoder:
Jobnet har ved borgers login adgang til CPR, hvilket gemmes i security token. Hør nærmere hos John, der netop er ved at udfærdige denne løsning ved løft af PSS til version 20. Felterne der skal mappes jf. response er: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/77577227/CounterService+Version+1+2017-4

Anchor
_Toc495317329 _Toc495317329

Anchor
_Toc495326376 _Toc495326376

Implementer nyt menupunkt (US 2434)

...

"Ved klik på menupunkt '225 timers reglen' vil jeg som borger, på Jobnet, kunne se mine data i relation til '225 timers reglen'."
Hint: Borger kan være på høj eller lav ydelse, hvilket afspejles af CurrentAidLevelIsHigh (true hvis høj ydelse og false hvis lav ydelse). Hvis ydelse er høj skal der vises forskellige tekster og informationsbokse i samme GUI, i forhold til hvis ydelse er lav.

Herover GUI for "Høj ydelse" Herover GUI for "Lave ydelse"
Acceptkriterier

• Ved klik på menupunkt "225 timers reglen" fremkommer GUI jf. wireframe.
• Data fra entitetsmodellen bindes mod viewmodellen/eller handles på som følger:
• Er borger på "Høj ydelse" (dvs. CurrentAidLevelIsHigh = true), resulterer klik på I-ikon til højre for overskriften "225 timers reglen" i visning af nedenfor viste boks: (Grafik kan genbruges fra DP-tællere)
  • Er borger dog på "Lav ydelse" (dvs. CurrentAidLevelIsHigh = false), vises i stedet følgende boks: (Grafik kan genbruges fra DP tællere)
• Af øverste venstre hjørne fremgår efter teksten "Data er fra " datoen for seneste kalkulation, efter formatet "30. maj 2017". Hint: Dato for kalkulation kan ses af CalculationDate (Date, forekomst 1)

...

• Er borger på "Høj ydelse", resulterer klik på I-ikon til højre for "Arbejdstimer" i visning af følgende boks, hvor datoen markeret med rød firkant er datoen CalculationDate:

• • Er borger på "Lav ydelse", resulterer klik på I-ikon til højre for "Arbejdstimer" i visning af boksen herunder, hvor datoen markeret med rød firkant er datoen QualifyingHoursTransitionDate
    • Har QualifyingHoursTransitionDate forekomst 0, skrives i rød firkant: "(dato ikke oplyst*)" og nederst i boksen vises i dette tilfælde, med en linjes afstand til øvrig tekst, følgende tekst:"*) Du skal bede din kommune om at oplyse denne dato" .

• Er borger på "høj ydelse", skal ordlyden på linjen under "Følg med i dine arbejdstimer" lyde således: "225 timer undgår fald i ydelse. "
  • Er borger derimod på lav ydelse, skal ordlyden være: "225 timer for at gå op i ydelse. "

• Ved klik på menupunkt "225 timers reglen" vises antallet af timer, som borger har arbejdet, som et heltal i midten af speedometer. Tallet afspejles tillige på den grønne skala. Hint: Timer leveres som integer i NumberOfHoursInWorkPeriod, der har forekomst 1

• • Er borgers leverede timer større end 225, vises tallet i midten af speedometer, men speedometer selv stopper ved 225.
• For borgere på "Høj ydelse": Mellem teksten "Arbejdstimer du mangler før" og ":" vises, med fed, datoen fra værdien for LastPossibleDate, efter følgende format 22. januar 2018.

...

• • Hvis NumberOfHoursInWorkPeriod er mindre end eller lig med 225, så vises antallet af timer som 225 fratrukket NumberOfHoursInWorkPeriod.
  • Er NumberOfHoursInWorkPeriod større end 225 vises tallet 0.

• Ved klik på I-ikon udfor teksten "Arbejdstimer du mangler…", skal for borgere på "Høj ydelse" fremkomme en boks med følgende tekst, hvor datoen med rød firkant er CalculationDate og datoen med blå firkant er LastPossibleDate. Datoer angives formateret som vist.

• • Har LastPossibleDate forekomst 0, angives i stedet for dato teksten: "(Dato ikke oplyst*) og nederst i den grønne boks, med en blank linje til teksten ovenover, skrives: "*) Du skal bede din kommune om at oplyse denne dato".

• Er borger derimod på "lav ydelse" skal klik på I-ikon føre til nedenfor viste boks, hvor datoen fremhævet med rød firkant er CalculationDate.

• Knappen "Find Job" linker til forsiden af Find Job, som borger, ved klik, dirigeres til i samme vindue.

Anchor
_Toc495317332 _Toc495317332

Anchor
_Toc495326379 _Toc495326379

Førstegangsvisning af høj/lav ydelse (US 2451)

...

"Som ekstern interessent, ønsker jeg jobnets kode vedr. 225 timers regel, lagt online på dokumentationsarkivet til inspiration. "

• Kode vedrørende 225 timers reglen er lagt online på dokumentationsarkivet til inspiration, på samme vis, som koden vedrørende dagpengetællerne blev lagt tilgængelig.

...

"Som PO ønsker jeg Google Analytics på 225 timers reglen"
Acceptkriterier:

• Der udfærdiges eventtracking på I-ikoner ud fra følgende skema:

   

  	Hændelsesetiket	Hændelseskategori	Handling ved hændelse
  Ved klik på ikon 1	225 timers reglen	Hjælp	I-ikon Høj ydelse: Forklaring 225 timers regel
  Ved klik på ikon 2	225 timers reglen	Hjælp	I-ikon Høj ydelse: Dine reg. arbejdstimer
  Ved klik på ikon 3	225 timers reglen	Hjælp	I-ikon Høj ydelse: Manglende arbejdstimer
  Ved klik på ikon 4	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: forklaring 225 timers regel
  Ved klik på ikon 5	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: Dine reg. arbejdstimer
  Ved klik på ikon 6	225 timers reglen	Hjælp	I-ikon Nedsat ydelse: Manglende arbejdstimer
  Ved første klik på menupunkt "225 timers regel" på høj ydelse og load af modal	225 timers reglen	Hjælp	Modal. Høj ydelse. Forklaring 225 timers regel
  Ved første klik på menupunkt "225 timers regel" på lav ydelse og load af modal	225 timers reglen	Hjælp	Modal. Nedsat ydelse. Forklaring 225 timers regel