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.