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)

STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader


2017-11.0KSS, A-kasse

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
(new method)




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

String

Kontaktinfo (f.eks. email, tlf, etc)

Forekomst: 1

PersonContactDataTypeIdentifier

PersonContactDataTypeIdentifierType

Forekomst: 1

EventDateTime

DateTime

Registreringsdato fra DFDGForekomst: 1

PersonContactDataStatusIdentifier

PersonContactDataStatusIdentifierType

Status på kontaktinfo
Forekomst: 1

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

PersonCivilRegistrationIdentifierType-2

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.