736.10 Samtykke og tilmelding til kommunikation fra STAR/jobcenter
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning

Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1 Baggrund
4.2 Overordnet løsning
4.3 Acc. 1 Borgers tilsagn til huskeservice
4.4 Acc. 2 Sagsbehandler tilmelding af borger til Huskeservice
4.4.1 CodelistService (v5) –> GetNotificationTypeIdentifierCodeList
4.5 Acc. 3 Udsendelse af huskeservicebeskeder
4.6 Acc. 4 Tilmelding til Kampagner
4.7 Acc. 5 Datakonvertering
4.8 Acc. 6 Som supporter kan jeg fortsat se de udsendte huskeservicebeskeder.
4.8.1 Webserviceændringer
4.8.2 LSS ændringer
4.9 Acc. 7 Konsekvensændringer i Jobkon
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
7.1 Vis ny huskeserviceside med borgers nuværende og mulige tilmeldinger (US 738)
7.2 Foretag opdatering af tilmeldinger og løft af service hertil (US 739)
7.3 Responsiv tilpasning af huskeserviceside (US 921)
1 Ændringslog2
2 Afgrænsning af epic2
3 Oversigt over berørte web services3
4 Beskrivelse af epic4
4.1 Baggrund4
4.2 Overordnet løsning4
4.3 Acc. 1 Borgers tilsagn til huskeservice5
4.4 Acc. 2 Sagsbehandler tilmelding af borger til Huskeservice7
4.4.1 CodelistService (v5) –> GetNotificationTypeIdentifierCodeList7
4.5 Acc. 3 Udsendelse af huskeservicebeskeder8
4.6 Acc. 4 Tilmelding til Kampagner9
4.7 Acc. 5 Datakonvertering10
4.8 Acc. 6 Som supporter kan jeg fortsat se de udsendte huskeservicebeskeder.11
4.8.1 Webserviceændringer11
4.8.2 LSS ændringer12
5 Særlige krav til test12
6 Kendte udeståender fra udviklingsfasen12
7 User stories13
7.1 Vis ny huskeserviceside med borgers nuværende og mulige tilmeldinger (US 738)13
7.2 Foretag opdatering af tilmeldinger og løft af service hertil (US 739)20
7.3 Responsiv tilpasning af huskeserviceside (US 921)21

Ændringslog

Afgrænsning af epic

Oversigt over berørte web services

Beskrivelse af epic

Denne epic er en del af ISB: 736 - Optimering af huskeservice

Baggrund

Den hidtidige mulighed for at tilmelde sig Jobnet er dels meget generel og dels ikke fuldstændigt dækkende for de typer beskeder som STAR gerne vil sende til borgerne. Blandt andet ønskes der mulighed for at borgeren kan tilmelde sig oplysninger om jobsøgningsmuligheder etc.
Der skal udvikles en ny tilmeldingsside, hvor Borgeren har mulighed for at se hvilke beskeder de har mulighed for at modtage. Borgeren skal mere konkret kunne tage stilling til hvilke former for beskeder, som er relevante for dem.
Opmærksomhedspunkter:

• På den eksisterende tilmeldingsside er det muligt at oplyse et telefonnummer uden at angive at man ønsker at modtage huskeservice pr. SMS. Dette er uhensigtsmæssigt, da det giver risiko for fejl.
• Der gives ikke konkret samtykke til kampagnebeskeder og til beskeder fra beskedmodulet. Det bør der.

Overordnet løsning

Der laves 4 nye kodelisteværdier NotificationTypeIdentifierCodeList som er grupper af borgeren kan tilmeldes. Det er fortsat mulig at tilmelde sig e-mail og/eller sms på dem alle.
Både Jobnet og sagsbehandler bruger disse nye kodelisteværdier. De gamle kodelisteværdier lukkes, men bruges fortsat internt i DFDG til at have en finere inddeling i hvilken besked borgeren har modtager på udsendelsestidspunkt, borgeren modtager ikke blot en påmindelse, men en påmindelse om at tjekke jobforslag.
En af disse nye værdier er Kampagner som borger hidtil ikke har givet tilsagn til, dette er nærmere beskrevet i Acc.
Der laves en konvertering fra de gamle værdier til de nye se.

Acc. 1 Borgers tilsagn til huskeservice

Designet for Huskeservice på Jobnet tilpasses følgende Wireframe.
Særligt kan, i forhold til det nuværende design, fremhæves:
Det vil ikke længere vil være muligt på selve huskeservicesiden at redigere sine kontaktinformationer. Dette af hensyn til styring i forhold til den kommende validering af email og kontaktoplysninger (epic 736.6). Kontaktinformationerne vil dog fremgå i toppen af siden, så borger i kontekst af huskeservice kan se, hvortil e-mails/SMS'er sendes. Endvidere linkes der til siden "Personlige oplysninger", hvor borger kan redigere data.
Ved klik fra menuen på punktet "Huskeservice" vil siden initialiseres med borgers eksisterende kontaktinformation og borgers allerede foretagne valg for huskeservice.
Har borger hverken e-mailadresse eller mobilnummer registreret vil det ikke være muligt at tilmelde sig huskeservice. Af siden for huskeservice vil så, i stedet for eksempelvis mobiltelefonnummer, fremgå teksten: SMS til: Mobilnummer ikke oplyst.

Der vil fremgå en boks for hvert af de 4 emner, som borger kan blive (eller allerede bliver) notificeret om, dvs.:

• Påmindelser, der overfor borger i huskeservice vil fremgå som "Møder og pligter"
• Informationer og beskeder, der overfor borger i huskeservice vil fremgå som "Beskeder fra arbejdsgivere og sagsbehandler"
• Gode råd og forslag, der overfor borger i huskeservice vil fremgå som "Gode råd til jobsøgning og uddannelse"
• Undersøgelser, der overfor borger i huskeservice vil fremgå som "Undersøgelser og feedback"

Hvert emne vil have et foldeud element under sig, hvor man ved klik kan "læse mere", dvs. læse uddybende om, hvad emnet vedrører. Alle elementer er standard foldet ind og de kan uafhængigt af hinanden foldes ud.

Borger kan for hvert element angive om han vil kommunikeres til pr. SMS eller E-mail. Dette sker ved markering af den respektive tjekboks (SMS og/eller E-mail) efterfulgt af klik på knappen "Gem ændringer", som i øvrigt først enables og skifter farve fra grå til grøn, når borger har foretaget en ændring i forhold til det oprindeligt registrerede.
Markering af checkboks SMS/E-mail kræver naturligvis, at borger har et mobilnummer respektiv en e-mailadresse registreret. Er det ikke tilfældet vil checkboksen for den respektive kommunikationskanal være disablet som illustreret med eksemplet "E-mail ikke oplyst" herunder:

Ved borgers klik på "Gem ændringer" fremkommer en modal (lightbox) med bekræftelse af hændelse. Af denne boks fremgår tillige teksten om, at det fortsat er borges pligt at møde op til møder, uanfægtet huskeservicebeskeder til borger ikke måtte nå frem. Dette er en ændring i forhold til det nuværende, da denne tekst indtil nu har været en del af selve huskeservice-siden.

Med det nye design tilstræbes altså:

• Bedre overblik over siden, gennem reducering af tekst og via elementer der initialt er foldet ind. Dette vil tillige give en bedre brugeroplevelse i breakpoints mindre end desktop.
• Mulighed for at borger kan vælge hvilken kanal vedkommende vil kommunikeres til, pr. påmindelse.
• Udvidelse med påmindelserne "Gode råd til jobsøgning og uddannelser" samt "Undersøgelser og feedback".

Acc. 2 Sagsbehandler tilmelding af borger til Huskeservice

Alle nuværende kodelisteværdier i NotificationTypeIdentifierCodeList sættes til at lukke med releasen og der laves i stedet 4 nye. De udgåede værdier bruges dog stadig internt til at kategorisere de udsendte huskeservicebeskeder, men ikke til selve til/afmelding.

CodelistService (v5) –> GetNotificationTypeIdentifierCodeList

Herunder den opdaterede kodeliste.

Acc. 3 Udsendelse af huskeservicebeskeder

Når der skal udsende huskeservicebeskeder skal der tjekkes om borgeren er tilmeldt den gruppe som besked ligger i, Fx ved udsendelser at en påmindelse om tjek jobforslag skal borgeren være tilmeldt gruppen påmindelser (id 31)
Ved udsendelse benyttes dog de gamle udgåede kodelisteværdier således at man i LSS via NotificationStatusService kan se at det er en påmindelse om tjek Jobforslag der er udsendt og ikke blot en påmindelse.
Herunder er beskrevet en mapning mellem den gamle og den nye kodeliste således at det er entydigt hvilke tilmeldinger der giver hvilke notifikationer. Denne mapning skal beskrives et passende sted på Wikien fx i dokumentationen til NotificationStatusService.
Til orientering skal der i forbindelse med Epic 736.6 bruges en ny type til afsendelse af verifikationsbeskeder, dette skal derfor oprettes som en ny kodelisteværdi som er udgået.
Tabel 1: mapningstabel

Acc. 4 Tilmelding til Kampagner

I dag bliver borgeren automatisk tilmeldt 'Gode råd ...' samt 'Undersøgelser...' (kampagner), hvis der blot er en tilmelding til huskeservice. Når en Undersøgelse/kampagne er igangsat, kan borgeren så afmelde sig beskeder på den specifikke kampagne.
Dette er ikke i overensstemmelse med det tilsagn, borgeren har givet, og derfor skal der være muligt for borger at kunne til og afmelde sig kampagner generelt.
Der laves 2 nye tilsagn på jobnet til hhv. "Gode råd ..." og "Undersøgelser..." (id 33 og 34 i NotificationTypeIdentifierCodeList).
Dette kommer i jobnet wireframe til udtryk jf. følgende to elementer, der indarbejdes på Huskeservice siden:

Ved Udsendelse af "kampagnebeskeder" skal der fremover kontrolleres om borgeren har givet tilsagn til den af de 2 ID'er, der nu giver mening.
Muligheden for undervejs i kampagnen at melde sig ud af den specifikke kampagne bibeholdes. Denne afmelding påvirker ikke den generelle tilmelding til kampagner.
Hvis den ledige på Jobnet ikke har accepteret tilsagnsid 33 og/eller 34 vil de automatisk ikke deltage i kampagner. Hvis de har accepteret inkluderes de i den potentielle population for en kampagne.
Når den ledige inkluderes i en kampagnepopulation vil vedkommende som udgangspunkt få alle de planlagte mails/sms'er. Der er dog indført obligatorisk mulighed for, at den ledige kan framelde sig yderligere mails/sms'er
Selve afmeldingen foregår ved, at modtager af enten en SMS eller mail, aktivt klikker på link for framelding (mail) eller svarer en talkode fra SMS. Afmeldingen registreres i SAS kampagneplatformen og sikrer dermed, at den ledige ikke modtager flere mails/sms fra den konkrete kampagne. Afmeldingen sker per kampagne. Den ledige vil derfor skulle afmelde sig alle fremtidige kampagner, én af gangen.

Acc. 5 Datakonvertering

Borger der allerede er tilmeldt huskeservice skal konverteres til det nye system. Dette skal ske efter samme mapning som er angivet i acc.3. Konverteringen skal laves for både mail og for mobil. Konverteringsreglen er præciseret i tabellen nedenfor
Tabel 2: konverteringsregler

Der udsendes ikke WSRM ved denne konvertering

Acc. 6 Som supporter kan jeg fortsat se de udsendte huskeservicebeskeder.

Supportere i Star skal via LSS fortsat kunne se hvilke huskeservicebeskeder der er udsendt, til dette benyttes i dag NotificationStatusService version 6. For ikke at skulle bruge lukkede kodelisteværdier til at udsende huskeservicebeskeder laves en nye kodeliste, hvor man så kan se hvilke typer der rent faktisk er i brug. Dette giver ligeledes mulighed for at få opdateret beskrivelserne så de passer med brugen
Denne kodeliste vil fra start have de samme værdier som den gamle kodeliste (NotificationTypeIdentifierCodeList) for at håndtere gamle beskeder. De værdier som ikke længere benyttes vil dog lukkes med releasen.
Der leves konvertering fra den gamle til den nye liste, dette er dog meget simpelt da værdierne genbruges.

Webserviceændringer

NotificationStatusService

Der laves en ny version af NotificationStatusService (version 7). Den eneste ændring er udskiftning af kodelisten til NotificationMessageTypeIdentifierCodeList i stedet for NotificationTypeIdentifierCodeList
Version 5 og 6 af NotificationStatusService lukkes.

CodelistService (version 5) -> GetCitizenNotificationMessageTypeIdentifierCodeList

Til udsendelse af huskeservicebeskeder benyttes fremover denne nye kodeliste.

LSS ændringer

LSS skal til rettes til at benytte version 7 af NotificationStatusService, med den nye kodeliste. Derudover skal det testes at man fra LSS kan til- og afmelde borger til Huskeservice efter de 4 nye kategorier, samt at historik på til- og afmeldinger ser fornuftig ud i LSS.
Acc. 7 Konsekvensændringer i Jobkon
I Jobkon skal det fortsat være muligt at sende beskeder til borgere via besked modulet (se skærmbillede nedenfor). For at give den bedste brugeroplevelse for sagsbehandler, skal der kontrolleres om borger har givet tilsagn til disse beskeder, så brugerfladen kan vise hvilke muligheder der er.
Der kan sendes forskellige beskedtyper fra Jobkon (generel besked, Jobformidling, Invitation til arrangement) alle disse ligger i den nye kategori 32 – information og beskeder.
Jobkon skal derfor tjekke om borger har givet tilsagn til kategori 32 (kan ses i PSS)
Kan der sendes udkast til plan? I så fald hører den til kategori 31 - påmindelserUdkast til plan sendes (hvor relevant) automatisk. Alle beskeder gennem Jobnet er pr definition "beskeder", så det er kun kategori 32 der skal bruges.

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.
Se oversigt over user stories i jira: https://starwiki.atlassian.net/browse/PF-1244

Vis ny huskeserviceside med borgers nuværende og mulige tilmeldinger (US 738)

"Som borger ønsker jeg, på Jobnet, at kunne se mine eksisterende og mulige tilmeldinger, herunder hvilke kanaler dette kan ske/sker via."
Se hints under acceptkriterier.
Acceptkriterier

• GUI implementeres jf. Wireframe, med flydende elementer.
  • For teksten i toppen, der figurerer under overskriften "Huskeservice" og er gengivet herunder gælder:

• • • "Ændret af [dig/dit jobcenter]"…. Implementeres ind med datoformatering som det allerede er i dag (figurerer længere nede af den gamle side jf. følgende): BEMÆRK: Der er siden sket en udvikling på dette område. Jf korrespondance fra Simon af 8. marts 2017 09:19, er det med kundesupport aftalt, at "Ændret af dig/dit Jobcenter samt dato for ændring" skal slettes, da det ikke giver mening og kan medføre miskommunikation som services er skåret. /Keil
    • I feltet [e-mail-adresse] skrives borgers evt. registrerede e-mailadresse. Har borger ikke oplyst e-mailadresse skrives "E-mail ikke oplyst".
    • I feltet [mobilnummer] skrives borgers evt. registrerede mobilnummer. Har borger ikke oplyst mobilnummer skrives "Mobilnummer ikke oplyst".
    • Personlige oplysninger linker til siden "Min side -> Min profil -> Personlige oplysninger"

Borgers valgte huskeservice elementer, (fordelt på abonnementtype og kommunikationskanal jf. PSS), hentes ved kald af service og mappes ind, så de kan vises på siden i 4 særskilte folde ind/folde ud elementer (folding container i frontendguide). For hvert element gælder:

• • At det indledningsvis er foldet ind, dvs. pilen i nederste del af elementet peger nedad.
  • Ved klik på pilen eller teksten "Læs mere" folder elementet ud, og den for det valgte element relevante tekst vises (Kopier fra wireframe). Samtidig vendes pilen, så den nu peger opad.
    • Ved klik på den opadvendte pil eller på teksten "læs mere" foldes elementet sammen igen.

• • Flere elementer kan godt være foldet ud på en gang.

• • Teksten "Læs mere" oprettes som et accessibility link, således at automatiske oplæsere, kan guide svagtseende mv. Den supplerende tekst der læses op skal være selve titlen på boksen, eksempelvis: Læs mere (om beskeder fra arbejdsgivere og sagsbehandler).
  • For checkboksene SMS og E-mail i hvert element (abonnementstype), herunder eksemplificeret med "Beskeder fra arbejdsgivere og sagsbehandler" gælder:

• • • Har borger oplyst E-mailadresse, er checkboksen "E-mail" enabled og derved valgbar.
      • Har borger ikke oplyst mobilnummer, er checkboksen E-mail grå og ikke valgbar, samtidig efterstilles teksten " – ikke oplyst".

• • • Har borger oplyst mobilnummer, er checkboksen "SMS" enabled og derved valgbar.
      • Har borger ikke oplyst mobilnummer, er checkboksen SMS grå og ikke valgbar, samtidig efterstilles teksten " – ikke oplyst".

• • • Har borger/jobcenter i forvejen valgt, at borger skal kommunikeres til på den specifikke kanal (E-mail/SMS) for den specifikke abonnementstype, skal den respektive checkboks være "tjekmarkeret".

• • State bevares ikke, dvs. forlader borger siden, så vil den ved genbesøg starte med boksene "foldet ind" og med visning af de senest gemte værdier.

• • Har borger ingen ændringer foretaget i sine valg, er knappen "Gem ændringer" deaktiveret og grå. Bemærk: Der gemmes først i senere US 739.
    • Ved markering/afmarkering af tjekboks, der ændrer borgers i GUI foretagne valg fra de for profilen gemte, enables knappen "Gem ændringer", som samtidig fremstår grøn.

Til udviklere: Dump af gammel "Huskeservice side" og perspektivering af ændringer:


Services: Hvor vi før brugte: JobnetPersonNotificationReminderService.GetPersonContactAndNotificationDatatil at hente borgers kontaktdata og borgers valg for huskeservice, skal vi nu bruge PSSVariableCV i stedet og collectionen PersonNotificationInfo og PersonContactDataInfo.
I den nuværende løsning returneres en lang række kodelisteværdier, som vi mapper op under de to muligheder der er i GUI:

For alle borgere med registreret mobilnummer og/eller emailadresse, foretager DFDG i den nye løsning en konvertering af disse underliggende kodeværdier til de to nye overordnede værdier, med henholdsvis ID 31 og 32. I tillæg oprettes 2 nye kodelisteværdier, 33 og 34, der dækker hhv. "Gode råd og forslag" og "Undersøgelser". Alle andre kodelisteværdier end disse nye nedlægges!!!:


Af PSS v 18 metode (Som Jobnet nu kører med metode GetVariablePersonstatusCV) kan elementerne PersonNotification og PersonContactInfoData requestes :
<RequestVariableCvType xmlns="http://service.bm.dk/pjaktass/18/PersonStatusService/2016/04/20/">
<PersonContactInfoData xmlns="">true</PersonContactInfoData>
<PersonNotification xmlns="">true</PersonNotification>
</RequestVariableCvType>

Eksempel på Response:

Foretag opdatering af tilmeldinger og løft af service hertil (US 739)

"Som borger ønsker jeg, på Jobnet, at kunne opdatere mine tilmeldinger for huskeservice, herunder kanalen dette skal ske via."
Acceptkriterier:

• Ved klik på grøn enabled knap "Gem ændringer", gemmes borgeres tilmeldinger.
  • Ved fejl skrives generel borgervendt fejlbesked, skrevet med rød, i kontekst af knappen hvor der handles.
  • Ved succes vises følgende modal og knappen "Gem ændringer", som der netop er klikket på på siden "Huskeservice" deaktiveres og fremstår grå.
  • Modal skal kun kunne lukkes ved aktivering af knappen OK.

Til udviklere: Hvor vi før brugte: JobnetPersonNotificationReminderService.SavePersonContactAndNotificationData til at gemme borgers kontaktdata (først i 736.6) og borgers ønsker om notifikation skal vi nu bruge metoderne SavePersonContactData (igen først i 736.6) og SavePersonNotificationData (som skal bruges i denne US).
Metoden SavePersonNotificationData tager følgende request. Metoden er ny for Jobnet men er udfærdiget af DFDG i tidligere release på servicen JobnetPersonNotificationReminderService

Bemærk: en række fejl kan opstå, men de eneste borgervendte er, at borgers mobilnummer eller mailadresse er slettet af anden session undervejs, mens borger er ved at ændre sine abonnementer (eller at JN har sluppet borger gennem til "Gem ændringer" i US 735, uden at have Mobil/E-mail.

Det forekommer at være en ekstremsituation og det er derfor unødvendigt at give borgervendt feedback. I øvrigt informeres borger af GUI, hvor det i næste session eller når data opfriskes, ikke vil være muligt at ændre abonnemente, når E-mail/mobilnummer ikke forefindes. Derfor generel fejlbesked.

Responsiv tilpasning af huskeserviceside (US 921)

Acceptkriterier:
"Som borger ønsker jeg, at huskeservice gøres responsiv, så jeg kan bruge siden fra mindre enheder."
Hints til udviklere: Hints: Der er hjælp at hente til Jobnet responsive design i wiki: Siden skal laves på ny med brug af allerede flydende elementer fra frontendguide. Wireframe i diverse størrelser er her: http://aakem0.axshare.com/#g=1&p=huskeservice__-_mindre_tekst-checkboxe&view=c
Der er stor inspiration at hente fra Min side, der også er bygget op over elementerne "Venstre menu", "Main" og "A-side". Prøv at skalere "Min side" til medium og videre til small, så fås det ønskede "look and feel".
Elementerne i content area/main side bliver mindre, men er ellers de samme og er i øvrigt ens, når vi går fra medium til small breakpoint, derfor er US blot beskrevet som overgang fra desktop til mindre skala.
Acceptkriterier:
 
Ved overgang fra desktop size til medium eller small size tilpasses huskeservice siden således at:
 
         Venstre og topmenu erstattes af en burgermenu i øverste højre hjørne.
o   Menuen inkluderer "log af" og efterlader blot borgers navn i toppen, som indikation på, at borgere er logget ind.
o   Jobnet logo vises i mindre skala i venstre hjørne
o   "Læs højt" element fjernes (kun small size). Hint: Det hele kan inkluderes fra "Min side", som er gengivet herunder.

 
        På huskeservice-siden skal A-side (den højre menu) slet ikke fremgå i small og medium breakpoints.
        Elementerne på "content area/main siden" forbliver de samme, men reduceres bare i størrelse, løbende som side mindskes.
o   Det tilstræbes at de to checkbokse forbliver på samme linje, men om nødvendigt i small breakpoint, når hverken SMS eller E-mail er oplyst, må de fremgå på hver sin linje.
 

         Labels 'E-mail til' og 'SMS til' og tilhørende tekst 'folder' i mindste breakpoint, så lablen står ovenpå den tilhørende tekst (se herunder).

         Knappen 'Gem ændringer' er i mindste breakpoint 80 % og centreret (nederst på siden)
         Footer genbruges som den er på min side.