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
Page Properties | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
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
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Dato | Version | Forfatter | Berørte afsnit |
18/4 2016 | 0.1 | Simon Engell Kamber | 2 (Epic oprettet) |
25/4 2016 | 0.1 | Carsten Olsen | Diverse husketing lagt ind |
17.11.2016 | 0.10 | Lars Kanstrup | Forretningsflows lagt ind |
30.11.2016 | 0.15 | Lars Kanstrup | Slettet gammelt indhold |
06.12.2016 | 0.16 | Lars Kanstrup | Fjernet acceptkriterier der allerede er implementeret i 736.8 |
07.12.2016 | 0.17 | Lars Kanstrup | 4.3 Rettet handling ved verificering af sagsbehandler oplyste kontaktoplysninger og oprindelige kontaktoplysninger |
14.12.2016 | 0.18 | Lars Kanstrup | Ændret indledningen i afsnit 4.4 |
16.12.2016 | 0.19 | Lars Kanstrup | Ændret lidt i afsnit 4.6 vedr. oprydning |
14.03.2017 | 0.24 | Lars Kanstrup | Tilføjet kodelisteværdi 16 i NotificationMessageTypeIdentifierCodeList |
16.03.2017 | 0.1 | Ole Sørensen | Tilretning af fejlkodetekster til VerifyPersonContactData på JobnetPersonNotificationReminderService (version 1). |
23.03.2017 | 0.1 | Jakob Bruhns | Oprettelse af Jobnet user stories |
27.04.2017 | 0.1 | Louise Baunsgaard Koch | Tilføjet beskrivelse af brugerflow og skærmbilleder for løsningen på Jobnet |
01.05.2017 | 0.1 | Louise Baunsgaard Koch | Uddybet beskrivelse af flow på Jobnet |
01.05.2017 | 0.1 | Jakob Bruhns | Uddybet logik (afsnit 4) og user story (afsnit 8.1) omkring verificering af "gamle" email-adresser og telefonnumre |
15.05.2017 | 0.1 | Jakob Bruhns | Justeret beskrivelse af Jobnet-flow for "gamle" brugere i afsnit |
18.05.2017 | 0.5 | Louise Baunsgaard Koch | Tilføjet beskrivelse vedr. placering af notifikationsbokse. |
23.05.2017 | 0.5 | Louise Baunsgaard Koch | Uddybet beskrivelse for eksisterende brugere |
26.06.2017 | 1 | Lars Kanstrup | Status sat til klar til wiki. Tracked changes og kommentarer slettet. |
10.07.2017 | 1 | Louise Baunsgaard Koch | Tilføjet beskrivelse af mindre godkendte ændringer. |
17.07.2017 | 1 | Louise Baunsgaard Koch | Tilføjet user story til håndtering af mindre ændringer. |
08.08.2017 | 1 | Simon Engell Kamber | Opdateret tekster i forlængelse af FB 104229 og 104232. |
10.08.2017 | 1 | Lars Kanstrup | Tilføjet beskrivelse af udløbne koder. |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Afgrænsning |
Som STAR vil jeg sikre mig at jeg sender beskeder til rigtige og gyldige e-mailadresser og telefonnumre, så jeg undgår fejl i udsendelser. |
Acceptkriterier |
Nr. | Beskrivelse | Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie |
736.6.1 | Som borger på Jobnet skal jeg verificere kontaktoplysninger (e-mail og mobiltelefon) når disse opdateres. | DFDG, Jobnet |
736.6.2 | Som borger ønsker jeg at kunne få gensendt en verifikationskode. | DFDG, Jobnet |
736.6.3 | Som borger har jeg mulighed for at verificere mine eksisterende kontaktoplysninger. | DFDG, Jobnet |
736.6.4 | NotificationService skal nedlægges for at nedbringe død kode og mindske omkostninger ved vedligehold | DFDG, Work in Denmark |
736.6.5 | Oprydning i JobnetPersonNotificationReminderService | DFDG , Jobnet |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier |
Bemærkninger |
736.6.1 | 736.6.2 | 736.6.3 | 736.6.4 | 736.6.5 |
Der er ingen ændringer mod A-kasser og KSS. |
Anchor | ||||
---|---|---|---|---|
Anchor | ||||
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Snitflade | Serviceaftager der er berørt |
Bemærkninger |
DFDG | Jobnet | Plannersystemer | KSS | A-kasse | Ydelsessystem | JobKon | Andet |
JobnetPersonNotificationReminderService (ver 1) |
|
x |
Kun ændret logik ingen snitflade- |
- VerifyPersonContactData
x
Ny metode
- SavePersonContactAndNotificationData
x
Lukkes
- RequestNewVerificationCode
x
ændringer | ||||||||||
| x | Ny metode |
|
x |
Lukkes |
|
x |
Ny metode |
x |
Lukkes |
NotificationService(version 2) |
X |
Lukkes |
NotificationService(version 3) |
X |
Lukkes |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
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':
...
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
Mobiltelefon | Hvis mobilnummer er tilføjet/ændret sættes status til "Ikke verificeret til huskeservice" (PersonContactDataStatusTypeIdentifier = 2) |
Alm Telefon | Status bliver sat til "Verificeret af Borger" (PersonContactDataStatusTypeIdentifier = 3) med det samme. |
E-mail adresse (PersonContactDataTypeIdentifier = 3) | Hvis E-mailadresse er tilføjet/ændret sættes status på e-mailadressen til "Ikke verificeret til huskeservice" (PersonContactDataStatusTypeIdentifier = 2) Herefter udsendes en verifikationskode til den nye e-mailadresse (se regel i afsnit 4.2.2.1) |
Anchor | ||||
---|---|---|---|---|
|
...
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
...
- 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.Anchor _GoBack _GoBack
Input
Navn | Type | Detajler |
CvCustomerIdentifier | Forekomst: 1 | |
VerificationCode | String | Forekomst: 1 |
PersonContactDataTypeIdentifier | PersonContactDataTypeIdentifierType | Forekomst: 1 |
Output
Normal service kvittering.
Fejlkoder
Nummer | Type |
1001 | Invalid cpr |
1013 | Insufficient permissions |
1014 | Failed to validate message |
4400 | CV Customer Number is unknown |
9153 | The submitted PersonContactDataTypeIdentifier is not a valid codelist value |
9159 | No person contact data was registered for the submitted person |
9240 | The registered person contact data is not valid for verification |
9241 | The submitted verification code is not valid |
9242 | No person contact data registered for verification |
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.
Identifikator | Navn | Beskrivelse | Startdato | Slutdato |
16 | Verifikationsbesked | Bruges til verifikation af kontaktoplysninger. | 14-03-2017 |
Anchor | ||||
---|---|---|---|---|
|
...
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
Anchor | ||||
---|---|---|---|---|
|
...
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)
Status Før | Handling |
1 - Oprindeligt ikke verificeret | Behold status og send verifikationskode |
2 - Ikke verificeret til huskeservice | Behold status og send verifikationskode |
3 - Verificeret af borger | Returner fejl |
4 - Oprettet af sagsbehandler | Behold status og send verifikationskode |
5 – Ugyldigt | Sæt status til 2 - Ikke verificeret til huskeservice og send verifikationskode |
Der sendes ikke ny verifikationskode, hvis der mangler kontaktoplysninger eller hvis kontaktoplysningen allerede er verificeret.
Input
Navn | Type | Detajler |
CvCustomerIdentifier | Forekomst: 1 | |
PersonContactDataTypeIdentifier | PersonContactDataTypeIdentifierType | Forekomst: 1 |
Output
Intet output, blot en servicekvittering.
Fejlkoder
Nummer | Type |
1014 | The submitted message could not be validated |
4400 | The supplied CV Customer Number is unknown to the system |
XXX1 | The submitted PersonContactDataTypeIdentifier is not a valid codelist value |
XXX3 | The Contactdata is already verified |
Xxxx4 | Contactdata for the submitted PersonContactDataTypeIdentifier is missing. |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Anchor | ||||
---|---|---|---|---|
|
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.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Testscenarie | Berørte systemområder | Identificeret af |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Med udgangspunkt i flowdiagrammet, opbygges testcases mhp at opbygge alle de scenarier, som flowdigrammet indeholder
Anchor | ||||
---|---|---|---|---|
|
...