736.8 Status på kontaktoplysninger
736.8 Status på kontaktoplysninger
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 17/12-2015)
Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1.1 Løsningsmodel
4.2 736.8.1 E-mailadresser kan markeres med status som (formodet) ugyldige, verificeret eller ikke-verificerede
4.2.1 JobnetPersonNotificationReminderService (Version 1)
4.2.2 PersonNotificationReminderService (Version 1)
4.2.3 Eksisterende kontaktinfo
4.2.4 CodeListService (Version 5)
4.3 736.8.4 Sagsbehandlere kan se om borgeres kontaktoplysninger er markeret som ikke-verificeret eller ugyldige 736.8.5 Landssupportere kan se om borgeres kontaktoplysninger er markeret som ikke-verificeret eller ugyldige.
4.3.1 PersonStatusService Version 18
4.3.2 LSS
4.4 736.8.2 Huskeservice sender ikke til e-mailadresser eller mobiltelefonnumre, der er markeret som ugyldige eller ikke-verificeret.
4.4.1 Huskeservice
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
Ændringslog
Dato | Version | Forfatter | Berørte afsnit |
18/4 2016 | 0.1 | Simon Engell Kamber | 2 (Epic oprettet) |
19/4 2016 | 0.1 | Simon Engell Kamber | 2 (Tilføjet acceptkriterier, ændret navn) |
25/4 2016 | 0.1 | Carsten Olsen | Indhold flyttet fra 726.2 og opdateret mht. acceptkriterier. |
25/4 2016 | 0.5 | Carsten Olsen | Løftet til version 0.5 |
18/8 | 0.5 | Simon Engell Kamber | Acceptkriterie udgået. |
26.09.2016 | 0.5 | Carsten Olsen | Ajourført med input fra KSS specielt omkring status Ugyldig |
27.09.2016 | 0.5 | Ulrich Landbo | Tilføjelse af løsningsforslag for LSS ift. accept kriterie 736.8.4 |
06.10.2016 | 0.5 | Sidsel Nielsen | Tilføjet metode til at ændre status og 4.2.4 Når Email registreres i forbindelse med tilmelding |
12.10.2016 | 0.5 | Carsten Olsen | Forretningsregler til ny metode i afsnit 4.2.4 opdateret |
01.12.2016 | 0.5 | Sidsel Nielsen | Tilføjet skema til 4.2.4 for overskuelighed |
01.12.2016 | 1.0 | Carsten Olsen | Testafsnit ajourført og løftet til version 1.0 |
02.12.2016 | 1.0 | Sidsel Nielsen | Tilrettet skema i afsnit 4.2.4 |
05.12.2016 | 1.0 | Ole Sørensen | Reviewrettelse til afsnit 4.2.4 |
Afgrænsning af epic
Afgrænsning | |||
Som STAR vil jeg kunne skelne mellem gyldige, ugyldige og ikke-verificerede emailadresser og mobil telefonnumre, så jeg undgår at sende til forkerte mails telefonnumre. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie | |
736.8.1 | E-mailadresser og mobil tlf kan markeres med status som ugyldige, verificerede eller ikkeverificerede til huskeservice. | DFDG | |
736.8.2 | Huskeservice sender ikke til e-mailadresser eller mobiltelefonnumre, der er markeret som ugyldige eller ikke verificerede til huskeservice. | DFDG | |
736.8.3 | Sagsbehandlere (Jobcenter og a-kasse) kan se borgeres kontaktoplysninger inkl. status markering, dog er ugyldige kontaktoplysninger ikke medtaget. | DFDG | |
736.8.4 | Landssupportere kan se borgeres kontaktoplysninger inkl. status markering. | LSS |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||||||||
736.8.4 | Acceptkriterie 2 | Acceptkriterie <nr.> | Acceptkriterie <nr.> | Acceptkriterie <nr.> | Acceptkriterie <nr.> | |||||
KSS/A-kasser kan modtage ny version af PSS | X | |||||||||
Sagsbehandlere kan anvende kontaktoplysninger, dog således relevant statusinformation kan medtages. Bemærk: Overfor Jobcentre og a-kasser udstilles ikke ugyldige kontaktinformationer | (X) | Udstillingsform er frivillig for KSS/A-kasser |
Oversigt over berørte web services
Snitflade | Serviceaftager der er berørt | Bemærkninger | |||||||||
DFDG | Jobnet | Plannersystemer | KSS | A-kasse | Ydelsessystem | JobKon | Andet | ||||
JobnetPersonNotificationReminderService (Version 1). SavePersonContactAndNotificationData | X | ||||||||||
JobnetPersonNotificationReminderService (Version 1).SavePersonContactData | X | ||||||||||
PersonNotificationReminderService (Version 1).SavePersonContactData | X | Bemærk ingen snitfladeændringer | |||||||||
PersonNotificationReminderService (Version 1).SavePersonContactStatus | X | ||||||||||
CodeListService (Version 5). PersonContactDataStatusIdentifierType | X | ||||||||||
PersonStatusService Version 18. GetVariablePersonStatus. PersonContactDataInfo | X | X | X | X | X | ||||||
PersonStatusService Version 18. GetVariablePersonStatusCV. PersonContactDataInfoCollection og PersonNotificationCollection | X |
Beskrivelse af epic
Denne epic høre til denne ISB: 736.
Løsningsmodel
I denne epic etablerer DFDG logikken til at mailadresse og/eller mobil telefonnummer kan have en status således at DFDG fremadrette vil kunne håndterer at:
- Der ikke sendes til ugyldige mailadresser og telefonnumre
- Jobcenter (KSS) og a-kasse ikke modtager mailadresse og/eller telefonnummer der er konstateret ugyldige
- Jobnet får mulighed for at verificere mailadresse og telefonnummer (Jobnet implementerer først dette i epic 736.6)
- DFDG udstiller status på mailadresse og telefonnummer
- DFDG giver borgere besked hvis borgers mailadresse og telefonnummer bliver ugyldig
På DFDG etableres en Jobnet metode til at verificerer mobiltelefon nr. og e-mail adresse, denne er ikke relevante for KSS, da DFDG betragter en indberetning fra sagsbehandler som implicit verificeret. De mulige verifikationsstatusser laves som en kodeliste.
736.8.1 E-mailadresser kan markeres med status som (formodet) ugyldige, verificeret eller ikke-verificerede
JobnetPersonNotificationReminderService (Version 1)
Bemærk ingen snitfladeændringer til øvrige metoder i forhold til 2016-2.
SavePersonContactAndNotificationData og SavePersonContactData
Forretningsregler:
- Når der oprettes eller ændres i e-mailadresser og/eller mobil telefonnumre (og alm. telefonnr) fra Jobnet sættes status til Id 1 "Oprindeligt ikke verificeret".Bemærk: Status sættes IKKE til Id 2 "Ikke verificeret", da denne status først må anvendes, når Jobnet kan verificerer i emailadresser og telefonnumre dette sker i epic 736.6.
Øvrige forretningsregler uændret.
PersonNotificationReminderService (Version 1)
Bemærk ingen snitfladeændringer til øvrige metoder i forhold til 2016-2.
SavePersonContactData
Forretningsregler:
- Når et mobiltelefon nr og/eller e-mail adresse (og alm. telefonnr) gemmes via denne metode sættes kodelisteværdien PersonContactDataStatusIdentifierType til Id 4 "Oprettet af sagsbehandler".
Øvrige forretningsregler uændret.
WSRM beskeder
Forretningsregler:
- Kontaktdata status skal ikke sendes med i WSRM besked, da KSS ikke bruger denne information.
- Kontaktdata som har status "Ugyldigt", skal ikke sendes med i WSRM besked.
- Hvis borgeren kun har kontaktdata som har status "Ugyldigt" skal der ikke sendes en WSRM besked.
Øvrige forretningsregler uændret.
Eksisterende kontaktinfo
Alle eksisterende kontaktinformationer (e-mail, mobil tlf og alm. tlf) sættes status til Id 1 "Oprindeligt ikke verificeret".
Når Email registreres i forbindelse med tilmelding
Når en e-mail registreres i forbindelse med tilmelding (UnemploymentEnrollmentService) skal denne have sat status:
Input | Status før | Status efter |
Slet kontaktoplysning | <N/A> | Som før |
Ændret kontaktoplysning | <N/A> | Oprettet af Sagsbehandlersagsbehandler |
Samme email | Verificeret af borger<N/A> | Som førVerificeret af borger |
Samme email | Ugyldig | Ugyldig |
Samme email | Alle andre | Oprettet af Sagsbehandler |
Bemærk: Status sættes IKKE til Id 2 "Ikke verificeret", da denne status først må anvendes, når Jobnet kan verificerer i emailadresser og telefonnumre dette sker i epic 736.6.
CodeListService (Version 5)
Bemærk: det kun er version 5 af kodelisten PersonContactDataStatusTypeIdentifierType medtages i.
PersonContactDataStatusIdentifierType
Kodeliste med verificeringsstatus for borgers mobil telefon nr og e-mailadresse.
Ny kodeliste.
Id | Navn | Beskrivelse | Startdato | Slutdato |
1 | Oprindeligt ikke verificeret | Oprindelig mobil tlf. nr. eller e-mail der endnu ikke er verificeret. Lovligt at anvende, DFDG/huskeservice sender. | 01-04-2000 | 01-07-2100 |
2 | Ikke verificeret til huskeservice | Mobil tlf. nr. eller e-mail der endnu ikke er verificeret til anvendelse af huskeservice. Lovligt at anvender men DFDG/huskeservice sender ikke. | 01-04-2000 | 01-07-2100 |
3 | Verificeret af borger | Mobil tlf. nr. eller e-mail der er verificeret af borger selv. Lovligt at anvender, DFDG/huskeservice sender. | 01-04-2000 | 01-07-2100 |
4 | Oprettet af sagsbehandler | Mobil tlf. nr. eller e-mail der er oprettet af sagsbehandler på vegne af borger. Lovligt at anvender, DFDG/huskeservice sender. | 01-04-2000 | 01-07-2100 |
5 | Ugyldigt | Mobil tlf. nr. eller e-mail der er ugyldigt og lukket da det konstateret fejlbehæftet. Ulovligt at anvende, DFDG/huskeservice sender ikke. | 01-04-2000 | 01-07-2100 |
736.8.4Sagsbehandlere kan se om borgeres kontaktoplysninger er markeret som ikke-verificeret eller ugyldige 736.8.5 Landssupportere kan se om borgeres kontaktoplysninger er markeret som ikke-verificeret eller ugyldige.
Statusoplysninger udstilles i PersonStatusService for eksterne og Jobnet og på LSS.
PersonStatusService Version 18
GetVariablePersonStatus
Statusoplysninger om e-mail og mobiltelefon nr medtages i PSS v18 i collection "PersonContactInfoData"
Forretningsregler:
- Når myndighed Jobcenter eller a-kasse kalder PPS medtages ikke kontaktinformationer der er ugyldige dvs. med status (PersonContactDataStatusIdentifierType) ="Ugyldigt" (Id 5) i PersonContactDataInfoType
Output
PersonContactDataInfo
Navn | Type | Detajler |
PersonContactDataInfo | PersonContactDataInfoType | Forekomst: 0-1 |
PersonContactDataInfoType
Navn | Type | Detajler |
PersonContactDataInfoCollection | PersonContactDataInfoType | Forekomst: 0-* |
PersonContactDataInfoType
Navn | Type | Detajler |
PersonContactData | Kontaktinfo (f.eks. email, tlf, etc) | |
PersonContactDataTypeIdentifier | PersonContactDataTypeIdentifierType | Forekomst: 1 |
EventDateTime | DateTime | Registreringsdato fra DFDGForekomst: 1 |
PersonContactDataStatusIdentifier | PersonContactDataStatusIdentifierType | Status på kontaktinfo |
AuthorityStructure | AuthorityStructureType | Forekomst: 1 |
CaseWorkerStructure | CaseWorkerStructureType | Forekomst: 1 |
GetVariablePersonStatusCV
Collection PersonContactDataInfoCollection og PersonNotificationCollection medtages.
LSS
Visning af PSS i LSS udvides med de nye statusdata for kontaktinformationer i ovenstående afsnit.
I LSS vil den nye status (kodeliste) blive vist som en tekst skrevet med normal ikke fed sort skrift efter felterne E-mail ogog Mobil.
736.8.2 Huskeservice sender ikke til e-mailadresser eller mobiltelefonnumre, der er markeret som ugyldige eller ikke-verificeret.
Huskeservices afsendelseslogik tilpasse så der ikke sendes på uverificeret eller ugyldige mobil telefon nr og e-mailadresse
Huskeservice
Forretningsregler:
- Det sendes ikke beskeder hvis PersonContactDataStatusIdentifierType er ID 2, 5.
Øvrige forretningsregler ændres ikke.
Status på E-mailadresser/mobilnummer kan ændres via ny metode på PersonNotificationAndReminderService
PersonNotificationReminderService (Version 1)
SavePersonContactStatus
Metode til at sætte status på en kontakttype (sms, email mv)
Input
Navn | Type | Detajler |
PersonCivilRegistrationIdentifier | Forekomst: 1 | |
PersonContactDataType | PersonContactDataType | Forekomst: 1 |
PersonContactDataStatusTypeIdentifier | PersonContactDataStatusIdentifierType | Forekomst: 1 |
Output
Normal servicekvittering.
Fejlkoder
Nummer | Type |
1001 | The submitted cpr is either to long or short or contains data not interpretable as a date |
1010 | The submitted cpr is unknown to the system |
1012 | Logon failed for user |
1013 | User has insufficient permissions to access this webservice |
1014 | The submitted message could not be validated |
4575 | You are not authorized to execute the operation |
4985 | Unknown unemploymentfundcode |
4986 | Unknown jobcentercode |
9153 | The submitted PersonContactDataTypeIdentifier is not a valid codelist value |
9193 | The submitted PersonContactPersonContactDataStatusTypeIdentifier is not a valid codelist value |
9194 | The person has no person contact data for the submitted PersonContactDataTypeIdentifier |
Særlige krav til test
Testscenarie | Berørte systemområder | Identificeret af |
I forbindelse med at denne epic har DFDG lavet en intern kodeomstrukturering der betyder at denne epic funktionalitet bør teste bredere mht. kontaktinfo of ændring af disse | ||
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.