846.3 A-kasser registrerer helbredsmæssige begrænsninger via webservice
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 14/02-2017)

STAR Product Owner (PO)	[Indsæt navn og e-mail] Knud de Place – kpp@star.dk
Forretningsanalytikere (FA). Evt. arkitekter, UX m. fl.	[Indsæt navne og e-mails]

STAR Projektleder (PL)	Forretningsanalytiker (FA)	STAR Release	Epic status	Eksterne snitflader
Knud de Place (STAR)		2018-1	1.0	A-kasse

Indholdsfortegnelse
1 Ændringslog
1.1 Forretningsmæssig baggrund
1.2 Epic er obligatorisk i 2018-1
1.3 Opfordring til at tage service i brug
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1 Fejlkoder for de 3 metoder vedr. registrering af helbredsmæssige begrænsninger
4.1.1 Fejlkoder vedrørende CreateHealthLimitation
4.1.2 Fejlkoder vedrørende UpdateHealthLimitation
4.1.3 Fejlkoder vedrørende DeleteHealthLimitation
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories

Ændringslog

Dato	Version	Forfatter	Berørte afsnit
13.04.2017	0.1	Knud de Place	Nyoprettet på baggrund af tilsvarende epic 846.2 i 2017-4. Dog er nærværende epic obligatorisk i 2018-1.
23.10.2017	1.0	kpp	Løftet til v1.0
19.01.2018	2.0	kpp	4.1 med underafsnit: I mangel på soapfaults i snitfladebeskrivelsen af PersonRegistrationService på wiki (http://starwiki.atlassian.net/wiki) er indsat fejlkoder, der fremgik af den gl. wiki vedr. Create-, Update- og DeleteHealthLimitation

Forretningsmæssig baggrund

Som led i den længerevarende udfasning af Arbejdsmarkedsportalen skal a-kasserne overgå til at anvende webservicekommunikation med DFDG frem for opslag og registreringer via Arbejdsmarkedsportalens brugergrænseflader således, at de sidste dele af portalen kan lukkes.
For en række services/områder har det ikke hidtil været obligatorisk for a-kasserne at anvende DFDGs webservices. Nogle a-kasser anvender dog i forvejen webservices på disse områder.
Denne epic omfatter a-kassernes ibrugtagning af webservice på nogle af disse områder.
Der er ikke udviklingsopgaver i denne epic for DFDG, da der er tale om services, der i forvejen anvendes i produktion af KSS'erne og (formentlig) også enkelte a-kasser.

Epic er obligatorisk i 2018-1

Denne epic er obligatorisk i 2018-1.
Tilsvarende epics var frvillige i 2017-3 og 2017-4.
STAR vil gerne i forbindelse med tilsagn til relaasen have oplyst, om a-kassen evt. allerede i forvejen anvender den pågældende webservice til registrering og opdatering af helbredsmæssige begrænsninger (PersonRegistrationService (version 9), metoderne CreateHealthLimitation, UpdateHealthLimitation og DeleteHealthLimitation), og læse allerede registrerede helbredsmæssige begrænsninger via PersonStatusService.

Opfordring til at tage service i brug

Det forventes, at det bliver obligatorisk i 2018-1 at registrere og opdatere helbredsmæssige begrænsninger via PersonRegistrationService og læse allerede registrerede helbredsmæssige begrænsninger via PersonStatusService. Derfor opfordres til, at a-kassen inden 2018-1 begynder at implementere registrering og opdatering af helbredsmæssige begrænsninger via PersonRegistrationService og visning ud fra oplysningerne i PersonStatusService.

Afgrænsning af epic

Afgrænsning
Som a-kasse skal jeg kunne foretage en række yderligere registreringer for, at STAR som de har varslet kan lukke Arbejdsmarkedsportalen (ved en senere release) i forhold til mine registreringer som sagsbehandler i en a-kasse.
Acceptkriterier
Nr.	Beskrivelse	Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie
846.3.1	A-kasser tager metoden CreateHealthLimitation i PersonRegistrationService i brug ift. registrering af helbredsmæssige begrænsninger.	SF/test. Ingen DFDG udviklingsopgaver.
846.3.2	A-kasser tager metoden UpdateHealthLimitation i PersonRegistrationService i brug ift. opdateringer af registrering af helbredsmæssige begrænsninger.	SF/test. Ingen DFDG udviklingsopgaver.
846.3.3	A-kasser tager metoden DeleteHealthLimitation i PersonRegistrationService i brug ift. opdateringer af registrering af helbredsmæssige begrænsninger.	SF/test. Ingen DFDG udviklingsopgaver.
846.3.4	A-kasser læser helbredsmæssige begrænsninger via PersonStatusService	SF/test. Ingen DFDG udviklingsopgaver.

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader	Berørte acceptkriterier				Bemærkninger
	846.3.1	846.3.2	846.3.3	846.3.4
A-kasser tager i eget fagsystem metoden CreateHealthLimitation i PersonRegistrationService i brug ift. registrering af helbredsmæssige begrænsninger.	x
A-kasser tager i eget fagsystem metoden UpdateHealthLimitation i PersonRegistrationService i brug ift. opdatering af registreringer af helbredsmæssige begrænsninger.		x
A-kasser tager i eget fagsystem metoden DeleteHealthLimitation i PersonRegistrationService i brug ift. sletning af registreringer af helbredsmæssige begrænsninger.			x
A-kasser læser fra eget fagsystem – via PersonStatusService - helbredsmæssige begrænsninger registreret i DFDG				x

Oversigt over berørte web services

Snitflade	Serviceaftager der er berørt								Bemærkninger
	DFDG	Jobnet	Plannersystemer	KSS	A-kasse	Ydelsessystem	JobKon	Andet
PersonRegistrationService (version 9)										Der henvises til wiki, da servicen er i produktion
CreateHealthLimitation					X
UpdateHealthLimitation					X
DeleteHealthLimitation					X

PersonStatusService (version 19 eller nyere GetVariablePersonStatus HealthLimitationInfo					X					Læsning af helbredsmæssige begrænsninger.

Beskrivelse af epic

Denne epic til denne ISB: N/a.
Epic indeholder ikke yderligere beskrivelse, da der er tale om services, der allerede er i produktion.
Fsva. tekniske og forretningsmæssige beskrivelser af de berørte services henvises til wiki https://starwiki.atlassian.net/wiki/display/FYS/PersonRegistrationService og https://starwiki.atlassian.net/wiki/display/FYS/PersonStatusService.
Der henvises endvidere til pjece på www.dfdg.dk - http://dfdg.dk/~/media/DFDG/Vejledninger/Tassvejledning/2013_02_20_Pjece_om_registrering_af_helbredpdf.ashx.

Fejlkoder for de 3 metoder vedr. registrering af helbredsmæssige begrænsninger

I den aktuelle mangel på soapfaults i snitfladebeskrivelsen af PersonRegistrationService på wiki (http://starwiki.atlassian.net/wiki) er i de følgende 3 underafsnit indsat de fejlkoder, der fremgik af den gl. wiki vedr. Create-, Update- og DeleteHealthLimitation.
Det forventes ikke, at der har været ændringer til fejlkoder, der anvendes til de tre metoder.

Fejlkoder vedrørende CreateHealthLimitation

Fejlkode	Fejlbesked	Release
1001	The submitted cpr is either to long or short or contains data not interpretable as a date	Produktion
1010	The submitted cpr is unknown to the system	Produktion
1014	The submitted message could not be validated	Produktion
4404	The person with specified cpr does not exist	Produktion
4405	The person with specified cpr is dead	Produktion
4668	The startdate must not be in the past	Produktion
4669	The enddate must not be earlier than the start date	Produktion
4742	The enddate must not be before today	Produktion

Fejlkoder vedrørende UpdateHealthLimitation

Fejlkode	Fejlbesked	Release
1001	The submitted cpr is either to long or short or contains data not interpretable as a date	Produktion
1010	The submitted cpr is unknown to the system	Produktion
1014	The submitted message could not be validated	Produktion
4404	The person with specified cpr does not exist	Produktion
4405	The person with specified cpr is dead	Produktion
4575	You are not authorized to execute the operation	Produktion
4589	The submitted Identifier is unknown to the system	Produktion
4647	The Startdate cannot be changed	Produktion
4668	The startdate must not be in the past	Produktion
4669	The enddate must not be earlier than the start date	Produktion
4742	The enddate must not be before today	Produktion
4748	The Enddate cannot be changed	Produktion
4762	The health limitation content must not include HTML tags	Produktion

Fejlkoder vedrørende DeleteHealthLimitation

Fejlkode	Fejlbesked	Release
1014	The submitted message could not be validated	Produktion
4575	You are not authorized to execute the operation	Produktion
4589	The submitted Identifier is unknown to the system	Produktion
4668	The startdate must not be in the past	Produktion
4743	This registration cannot be deleted	Produktion
4762	The health limitation content must not include HTML tags	Produktion

Særlige krav til test

Testscenarie	Berørte systemområder	Identificeret af
Ekstern integrationstest A-kasser der ikke allerede anvender de pågældende services og metoder skal foretage ekstern integrationstest til disse services og metoder.		Knud
E2E-test af udvalgte scenarier:
Registrering af helbredsmæssige begrænsninger på medlem	Personregistrering	Knud
Opdatering af registrering af helbredsmæssige begrænsninger registreret på medlem	Personregistrering	Knud
Registrering af helbredsmæssige begrænsninger på andre end egne medlemmer kan ikke foretages af a-kassen	Personregistrering	Knud
Opdatering af registrering af helbredsmæssige begrænsninger på andre end egne medlemmer kan ikke foretages af a-kassen	Personregistrering	Knud
Sletning af registreret helbredsmæssige begrænsninger registreret på medlem	Personregistrering	Knud
Sletning af registreret helbredsmæssige begrænsninger registreret på andre end egne medlemmer kan ikke foretages af a-kassen	Personregistrering	Knud

Kendte udeståender fra udviklingsfasen

N/a.

User stories