736.6 Validering af e-mails og telefonnumre
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 Acc. 1 Borger opdaterer kontaktoplysninger på Jobnet
4.2.1 Forretningsflow
4.2.2 DFDG Webserviceændringer
4.3 Acc. 2 Borger ønsker ny verifikationskode
4.3.1 Forretningsflow
4.3.2 DFDG Webserviceændringer
4.4 Acc. 3 Verificering af eksisterende kontaktoplysninger
4.5 Acc. 4 Lukning af NotificationService
4.6 Acc. 5 Oprydning i JobnetPersonNotificationReminderService
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
7.1 Jobnet
7.1.1 Noter til jobnets løsning
7.1.2 US 1415: Ændringer til profiloplysninger og huskeservice
7.1.3 US 1421: Verifikationsflow for bekræftelse af ændrede kontaktoplysninger
7.1.4 US 1422: Notifikationer om uverificerede kontaktoplysninger på Min side ved nyligt ændrede kontaktoplysninger
7.1.5 US 1423: Verificering af "gamle" kontaktoplysninger

Ændringslog

Afgrænsning af epic

Oversigt over berørte web services

Beskrivelse af epic

Denne epic til denne ISB: 736 – Optimering af huskeservice.
Løser FB 79108, som skal holdes opdateret.

Baggrund

Der er en del mails og sms'er som ikke når frem til rette vedkommende pga. fejlindtastninger eller forældede kontaktoplysninger. Samtidigt modtager STAR's support jævnligt henvendelser fra borgere, som fejlagtigt modtager beskeder rettet mod en anden borger. For at løse dette laves en validering at nye/ændrede kontaktoplysninger når de indtastes af borger på Jobnet.
I 2017-1 epic 736.8 er der allerede implementeret tilstande på kontaktoplysnigner således at der ikke sende huskeservicebeskeder til kontaktoplysninger der er ugyldige eller ikke verificeret. Ligeledes er der implementeret logik således at sagsbehandler oplyste kontaktoplysninger ikke behøver at blive verificeret før der udsendes huskeservicebeskeder.

Acc. 1 Borger opdaterer kontaktoplysninger på Jobnet

Når en borger opdaterer sit mobilnummer eller e-mail på Jobnet skal disse oplysninger verificeres før der sendes huskeservicebeskeder på hhv. sms eller mails til dem.

Forretningsflow

Der følges nedenstående flow, efterfølgende er regler for enkelte trin beskrevet.

Figur 1: Borger opdaterer kontaktoplysninger
Flowet starter ved at borgeren logger ind på Jobnet, og opdaterer enten mail eller mobilnummer på siden "Personlige oplysninger". Kontaktoplysningerne opdateres i DFDG, og hvis de er forskellig fra tidligere sættes status til 'ikke verificeret', sendes der en verifikationsbesked til borger.
Borgeren modtager en kode på mail/sms afhængig af, hvilken oplysning er ændret. På Jobnet præsenteres borgeren for nedenstående dialog (afhængig af hvilken kontaktoplysning, der ønskes ændret) i et modalvindue, fremover benævnt 'bekræftelsesdialogen':

• Bekræftelse af mobilnummer:
• Bekræftelse af e-mailadresse:
• Hvis både mobilnummer og e-mail skal bekræftes, vises en samlet bekræftelsesdialog for mobil og e-mail. Når brugeren har bekræftet en kontaktoplysning sættes et flueben ud for den. Når brugeren har bekræftet den anden kontaktoplysning, så lukkes vinduet og der vises en call-out boks, der kvitterer for at bekræftelsen er gennemført. Det er muligt at undlade at bekræfte en eller begge.

Borgeren indtaster verifikationskoden på Jobnet og denne valideres i DFDG. Hvis det går godt, opdateres status, ellers vises en fejl.
Der er umiddelbart ingen kontrol af for mange indtastningsforsøg eller lign., da det drejer sig om identificerede brugere og misbrug er usandsynlig.
Kontaktoplysningen skal kun verificeres, hvis:

• Det er et mobilnummer eller e-mailadresse (fastnetnumre valideres ikke)
• Oplysningen er ændret i forhold til allerede registrerede i DFDG

Hvis koden indtastes forkert, og dermed ikke kan bekræftes, vises det således:

Borgeren kan vælge at bekræfte e-mail/mobilnr senere, hvis denne ønsker dette. I så fald lukkes vinduet uden at indtaste koden.
Hvis en kontaktoplysning ikke er bekræftet, så vises en rød tekst under den pågældende kontaktoplysning, indtil den er bekræftet. Se eksempel:

Hvis borgeren har ubekræftede kontaktoplysninger vises følgende notifikationer på borgerens 'Min side' (afhængig af hvad der mangler at blive bekræftet):

• Ubekræftet e-mailadresse:

• Ubekræftet mobilnummer:

• Både ubekræftet email og mobilnummer:

Klikker man på "Bekræft…" bliver man igen bedt om at indtaste den kode, man tidligere har modtaget (der sendes ikke en ny kode i denne forbindelse).
Klikker man på "Ret…" dirigeres man til 'Min profil', hvorfra man kan opdatere e-mail/mobilnummer afhængig af hvad der skal rettes. Herfra får man tilsendt en ny kode.
Jævnfør forretningsreglerne for visning af de grønne notifikationsbokse på Min side, så skal validering af kontaktoplysninger for nye brugere placeres efter Annonceringer fra Jobnet (fra CV admin):

• Frister for booking af møde
• Næste møde (møder)
• Jobplan notifikationer
• Indsendelse af Dagpengekort og ledighedserklæring
• Krævet anvendelse af joblogs
• Besked om Anden Aktør
• Dialogmodul beskeder (Min Beskedbakke)
• Annonceringer fra Jobnet (fra CV Admin)
• Validering af kontaktoplysning (nye brugere)
• 6 ugers selvvalgt uddannelse
• Joblog notifikationer
• Screening (profilafklaring)

DFDG Webserviceændringer

For at understøtte ovenstående flow ændres JobnetPersonNotificationReminderService -> SavePersonNotificationData og der laves en ny metode i servicen kaldet VerifyPersonContactData. Disse er beskrevet herunder.
UnemploymentEnrolmentService -> CV metoderne er ikke påvirket, da de ikke opdaterer borgerens kontaktoplysninger.

JobnetPersonNotificationReminderService (Version 1) –> SavePersonContactData

Når Jobnet gemmer kontaktinfo leveres alle kontaktinfo med uanset om de er ændret. Dette er for at kunne håndtere sletning af information. Derfor skal DFDG detektere ændringer, hvad der skal ske afhænger at kontaktdatatypen (PersonContactDataTypeIdentifier). Disse er beskrevet herunder

Verifikationsbesked

Der ønskes umiddelbart en billig løsning, hvor der ikke genereres unikke koder, da disse ville skulle gemmes. I stedet tænkes en algoritme, som danner en aktiveringskode ud fra CPR, Dato og mobil/e-mail. Dette sikrer levetid på aktiveringskode, unik per borger og unik per kontaktoplysninger og samtidig at man ikke behøver at bruge den nyeste aktiveringskode.
Der benyttes de Sidste 5 tegn af en MD5 hash af CPR + Dato + e-mail/telefonnummer.
Verifikationsbeskeden skal sendes straks (inden for sekunder), uanset om borger er tilmeldt huskeservice og uanset tidspunktet på døgnet. I dag sendes der ikke beskeder mellem klokken 22 og 8. Dette skal fortsat gælde for de øvrige huskeservicebeskeder, blot ikke for verifikationsbeskeder.
Der benyttes kode 16 i CitizenNotificationMessageTypeIdentifierCodeList til de udsende huskeservicebeskeder.

E-mail verifikationsbesked

Når en borger opretter eller ændrer i sin e-mailadresse på Jobnet sendes en verifikationsmail til den nye e-mailadresse med teksten:
"Kære [FirstName] [SurName] Vi vil gerne være sikre på, at det er den rigtige e-mailadresse, der er registreret under dine 'Personlige oplysninger' på Jobnet.dk. Du skal derfor logge ind på Jobnet.dk og bekræfte e-mailadressen ved at indtaste denne kode:   Kode: [VerificationCode]  Med venlig hilsen Jobnet Det er ikke muligt at svare på denne e-mail, da den er automatisk genereret""Rettet i FB 104229Bekræft din e-mailadresse på Jobnet.dk Kære [FirstName] [SurName]
Vi vil gerne være sikre på, at det er den rigtige e-mailadresse, der er registreret under dine 'Personlige oplysninger' på Jobnet.dk. Du skal derfor logge ind på Jobnet.dk og bekræfte e-mailadressen ved at indtaste denne kode:
 
Kode: [VerificationCode]
Med venlig hilsen
Jobnet"

SMS verifikationsbesked

Når borger opretter eller ændrer i et mobilnummer sendes en SMS til det nye nummer med en teksten:
"Før du kan modtage sms'er fra Jobnet, skal dit mobilnummer bekræftes. Log ind på Jobnet.dk og bekræft med koden: [VerificationCode]. Mvh. Jobnet. Denne sms kan ikke besvares."Rettet i FB 104232Kode: [VerificationCode]
Indtast denne kode på Jobnet.dk for at bekræfte dit mobilnummer."

JobnetPersonNotificationReminderService (Version 1) -> VerifyPersonContactData

Metoden sætter kontaktinfo status til "Verificeret af Borger" (PersonContactDataStatusTypeIdentifier = 3) hvis verifikationskoden er korrekt (Se regler for verifikationskoden i afsnit 4.2.2.1)

• Der kan kun valideres kontaktoplysninger af typen Mobiltelefon (PersonContactDataTypeIdentifier = 1) og MailAdresse (PersonContactDataTypeIdentifier = 3) øvrige fejler.
• Der sendes ikke WSRM når der ændres i status på kontaktinformationer
• Koder der er mere end 2 dage gamle er udløbet, dvs. koder for dagsdato og de foregående 2 dage er valide. Antallet af dage er konfigurerbart.

Input

Output
Normal service kvittering.
Fejlkoder

CodelistService (version 5) -> GetCitizenNotificationMessageTypeIdentifierCodeList

For at kunne skille verifikationsbeskeder fra andre huskeservicebeskeder skal der laves en ny værdi i NotificationMessageTypeIdentifierCodeList. Denne er beskrevet nedenfor.

Acc. 2 Borger ønsker ny verifikationskode

Af forskellige årsager kan det være nødvendigt at få gensendt en verifikationskode, fx fordi den er udløbet eller blevet væk. Metoden bruges også når man vil verificere en E-mailadresse der er oplyst af sagsbehandler, oprindeligt verificeret eller sat til ugyldig.
Borger kan få tilsendt en ny verifikationskode via linket (Tilsendt en ny kode) i verifikationsvinduet i Jobnet, se løsningsforslag:

Når en borger klikker på linket genereres en ny kode, der sendes til borgerens mobil/e-mail (afhængig af valg).
Der gives feedback til borgeren om, at der er tilsendt en ny kode (via container-attention element).

Koden kan herefter indtastes og verificeres ved at klikke på "Bekræft".

Forretningsflow

Når en borger på Jobnet vælger at få tilsendt en ny verifikationskode kaldes DFDG som tjekker om Status på kontaktoplysningerne, og hvis ikke oplysningen allerede er verificeret dannes og sendes en ny verifikationskode som sendes til borger på mail/sms.
Flowet kan startes fra flowet i acc1 eller direkte fra min side på Jobnet.

Figur 2: Gensend verifikationskode

DFDG Webserviceændringer

JobnetPersonNotificationReminderService (Version 1) –> RequestNewVerificationCode

Formålet med denne metode er at sende en ny verifikationskode ud til borger. Hvis denne skulle være blevet væk eller ikke kommet frem, eller til at starte et verifikationsflow på ikke verificerede eller ugyldige kontaktoplysninger.
Når DFDG modtager en anmodningen om en ny verifikationskode ud fra status på kontaktoplysningen sker der følgende (se nedenstående skema)

Der sendes ikke ny verifikationskode, hvis der mangler kontaktoplysninger eller hvis kontaktoplysningen allerede er verificeret.
Input

Output
Intet output, blot en servicekvittering.
Fejlkoder

Acc. 3 Verificering af eksisterende kontaktoplysninger

Som udgangspunkt skal borger ikke verificere de oplysninger, der på idriftsættelsestidspunktet er registreret i systemet, e-mails og SMS beskeder sendes fortsat til disse konti. Det er dog ønskeligt at få disse verificeret. På Jobnet laves en boks der beder borger om at verificere kontaktoplysning, der har status "Oprindeligt verificeret" eller "Oprettet af sagsbehandler". Bemærk, at selvom eksisterende brugere ikke verificerer deres e-mail-adresse/mobilnummer, så skal de fortsat modtage beskeder fra Huskeservice.
Flowet for disse borgere initieres ved PersonContactDataStatusTypeIdentifierType på PSS som, når den returnerer status 1 eller 4 skal invokere nedenstående flow for at nudge borgeren til at bekræfte sine "gamle" oplysninger. Hvis borgeren vælger dette kalder Jobnet RequestNewVerificationCode, som beskrevet under Acceptkriterie 2. Dette kræver ingen tilpasninger i DFDG.
Boksene skal se således ud:



Ved klik på "Ja, …" tilsendes en verifikationskode til borgeren, og bekræftelsesvindue åbner, hvorfra man kan bekræfte sine kontaktoplysninger.
Ved klik på "Nej, …", dirigeres man til 'Min profil  Personlige oplysninger', hvorfra man kan opdatere e-mail/mobilnummer afhængig af, hvad der skal rettes. Når rettelserne gemmes, får man tilsendt en ny kode (på den information der er blevet rettet). Bekræftelsesdialogen åbner, hvorfra man kan bekræfte sine kontaktoplysninger.
Jævnfør forretningsreglerne for visning af notifikationsbokse på Min side, så skal validering af kontaktoplysninger for eksisterende brugere placeres nederst i prioriteringslisten:

• Frister for booking af møde
• Næste møde (møder)
• Jobplan notifikationer
• Indsendelse af Dagpengekort og ledighedserklæring
• Krævet anvendelse af joblogs
• Besked om Anden Aktør
• Dialogmodul beskeder (Min Beskedbakke)
• Annonceringer fra Jobnet (fra CV Admin)
• Validering af kontaktoplysning (nye brugere)
• 6 ugers selvvalgt uddannelse
• Joblog notifikationer
• Screening (profilafklaring)
• Validering af kontaktoplysning (eksisterende brugere)

Acc. 4 Lukning af NotificationService

Servicen NotifikationsService version 2 og 3 omgår valideringerne i huskeservice, og derfor skal den enten opgraderes eller lukkes. Det er en intern service som så vidt vides kun er Work in Denmark der har benyttet.

• Jobnet anvender den ikke
• Det er på wiki defineret som en rent interne service som eksterne ikke må anvende 
• Sikkerhedsmodellen på den siger det kun er jobcentre der må kalde den??
• Version 3 er ikke blevet kaldt de sidst 6 mdr.
• Version 2 er sidst blevet kaldt i feb. 16
• DFDG kalder den ikke internt  

Konklusion, Servicen nedlægges med 2017-3 og koden slettes.

Acc. 5 Oprydning i JobnetPersonNotificationReminderService

Metoden SavePersonContactAndNotificationData i JobnetPersonNotificationReminderService ver 1 udfases, Jobnet skal I stedet kaldes de 2 specifikke save metoder SavePersonContactData og SavePersonNotificationData i JobnetPersonNotificationReminderService.
Metoden GetPersonContactAndNotificationData udfases, da Jobnet i stedet benytter PSS.
Metoderne slettes helt efter at Jobnet har sagt go og eventuel død kode fjernes.

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 user stories her https://starwiki.atlassian.net/browse/PF-1252

Jobnet

Noter til jobnets løsning

Wireframe: http://aakem0.axshare.com/#g=1&p=personlige_oplysninger_responsiv
Profilsiden skal I samme forbindelse gøres responsive

US 1415: Ændringer til profiloplysninger og huskeservice

"Som DFDG ønsker jeg at Jobnet opdaterer metoderne under JobnetPersonNotificationReminderService, så de er forberedte til de nye features i Epic 736.6."
I 17-2, har huskeservice og profiloplysninger ligget i samme metode, men i 17-3 splittes det ud i to separate metoder, hhv. SavePersonContactData og SavePersonNotificationData.
Acceptkriterier

• Den nuværende servicereference (JobnetPersonNotificationReminderService) er opdateret til de to nye metoder SavePersonContactData og SavePersonNotificationData, så brugeren kan opdatere både sine profiloplysninger og sin huskeservice
• Den gamle metode er skrevet ud af koden

Noter til test

• Det skal verificeres, at profiloplysninger og huskeservice fungerer uændret (altså som i 17-2) efter serviceopdateringen til de nye metoder

US 1421: Verifikationsflow for bekræftelse af ændrede kontaktoplysninger

"Som STAR ønsker jeg at få verficeret, at den enkelte borgers nyligt oplyste mobilnummer og email adresse er korrekt indtastet og i brug, så emails og SMS'er ikke bouncer og rammer den rigtige modtager."
Acceptkriterier

• Scenarierne som er indikeret i flowdiagrammet i afsnit 4.2.1 er implementeret i løsningen
• Hvis der er sket ændringer i borgerens profil i form af en ændret emailadresse og/eller mobilnummer, vises en modal (jf. wireframe) til indtastning af den/de fremsendte verifikationskode(r)
• Ved indtastning af de korrekte verifikationskode i modalen, vises en kvittering for at oplysningerne nu er verifcerede i form af en call out jf. wireframe
• Hvis man indtaster en forkert kode, vises en fejlmeddelse
• Det er muligt at få tilsendt en ny verifikationskode, hvis man har brug for det

US 1422: Notifikationer om uverificerede kontaktoplysninger på Min side ved nyligt ændrede kontaktoplysninger

"Som STAR ønsker jeg at nudge borgere med nyligt ændrede, men fortsat uverificerede kontaktoplysninger til at verificere disse, så det sikres, at oplysningerne er korrekte."
Acceptkriterier

• Via et flag på PSS (TBD) vises notifikationer til de rigtige borgere med uverificerede oplysninger, hhv. mobilnummer, email, eller begge dele jf. wireframens oplæg.

Noter til test

Med udgangspunkt i flowdiagrammet, opbygges testcases mhp at opbygge alle de scenarier, som flowdigrammet indeholder

US 1423: Verificering af "gamle" kontaktoplysninger

"Som STAR ønsker jeg at verificere, at den enkelte borgers tidligere oplyste mobilnummer og email adresse, er korrekt indtastet og i brug, så der ikke er så mange SMS'er og mails, der bouncer på "gamle" profiler uden dog at kræve en verificering for fortsat at sende mails og SMS'er."
Acceptkriterier

• Som beskrevet i ovenstående afsnit 4.4 får Jobnet besked om at borgerens "gamle" kontaktoplysninger ikke er verificerede, og de forsøges overtalt til at verificere dem

Noter til test

Med udgangspunkt i flowet opbygges testcases mhp at belýse og gennemføre alle de scenarier, som flowdigrammet indeholder