690.8 Kendskab til jobcenter på aktivitet
690.8 Ændringer til aktiviteter – bl.a. Kendskab til jobcenter på aktivitet
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 690.8.1 Som virksomhedskonsulent ønsker jeg at kunne se hvilket jobcenter der har oprettet en aktivitet
4.1.1 ActivityService (Version 3)
4.1.2 ActivityService (Version 4)
4.1.3 Andre service der udstiller aktiviteter
4.2 690.8.2 UpdateHistoricActvity tilrettes så den fremadrettet opdaterer aktiviteter på sagsbehandlerkladden også
4.3 690.8.3 På en aktivitet kan jeg registrere reference til en jobordre eller jobannonce.
4.3.1 ActivityService (Version 4)
4.3.2 CodeListService (Version 5)
4.3.3 Andre service der udstiller aktiviteter
4.4 690.8.4 Hvis forsørgelsestype indberettes af en serviceaftager ignoreres denne 690.8.5 En aktivitet der hentes i DFDG udstiller ikke forsørgelsestype
4.4.1 ActivityService (Version 4)
4.4.2 Andre service der udstiller aktiviteter
4.5 690.8.6 Nytteindsats for en dagpengemodtager, skal markeres som et rådighedsafprøvende tilbud
4.5.1 ActivityService (Version 3 og 4)
4.6 690.8.7 CVR- og p-nr. skal være udfyldt med 8 hhv. 10 tegn ved Create
4.6.1 Ny validering på CreateActivity –krav om CVR- og p.nr. eller hhv 8 og 10 tegn
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
Ændringslog
Dato | Version | Forfatter | Berørte afsnit |
18.01.16 | BDA | Dokument oprettet i version 0.1 | |
19.01.16 | 0.3 | BDA | Dokument løftet til version 0.3 |
01.08.17 | 0.3.1 | ALL | Opdateret med acceptkriterier hhv. vedr. reference på jobordre eller jobannonce og vedr. forsørgelsestyper |
03.10.2017 | 0.3.2 | ALL | Opdateret med nyt acceptkriterie vedr. rådighedsafprøvende tilbud. |
09.10.2017 | 0.3.3 | CO | Ændringer til DFDG sat ind, klar til tilsagn. |
16.10.2017 | 0.3.4 | CO | Tilrettet med input fra KSS og afsnit 3 udfyldt. |
23.10.2017 | 0.3.4 | CO | Collection af referencer flyttet til ActivityCoreItem |
31.10.2017 | 0.3.5 | kpp | Nyt acc.kr. 7: På Create-metoden valideres for, om CVR- og p.nr. eller hhv 8 og 10 tegn (hidtil er ikke valideret på input-siden, men kun på output) |
02.11.2017 | 0.3.6 | kpp | Afsnit 4.6.1: Hvis CVR- eller p-nr. ikke er 8 hhv. 10 tegn kastes eksisterende fejlkode 1014. |
Afgrænsning af epic
Afgrænsning | |||
Som en virksomhedskonsulent vil jeg kunne se hvilket jobcenter der har oprettet en aktivitet for at vide hvem jeg skal kontakte hvis spørgsmål. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie | |
690.8.1 | Som virksomhedskonsulent ønsker jeg at kunne se hvilket jobcenter der har oprettet en aktivitet | DFDG | |
690.8.2 | UpdateHistoricActvity tilrettes så den fremadrettet opdaterer aktiviteter på sagsbehandlerkladden også | DFDG | |
690.8.3 | På en aktivitet kan jeg registrere reference til en jobordre eller jobannonce. | DFDG | |
690.8.4 | Hvis forsørgelsestype indberettes af en serviceaftager ignoreres denne | DFDG | |
690.8.5 | En aktivitet der hentes i DFDG udstiller ikke forsørgelsestype | DFDG, Jobnet, BI, VOA | |
690.8.6 | Når jeg som sagsbehandler i et jobcenter afgiver et tilbud om nytteindsats for en dagpengemodtager, skal dette markeres som et rådighedsafprøvende tilbud. | DFDG | |
690.8.7 | Når jeg opretter aktiviteter valideres der på, om CVR- og p.nr. er udfyldt med 8 hhv. 10 tegn, så jeg ikke kan gemme aktiviteter, som det ikke senere er muligt et hente med Get-metoder | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||||||||
Acceptkriterie 690.8.1 | Acceptkriterie 690.8.2 | Acceptkriterie 690.8.3 | Acceptkriterie 690.8.6 | Acceptkriterie <nr.>690.8.7 | Acceptkriterie <nr.> | Acceptkriterie <nr.> | ||||
Virksomhedskonsulenten kan på en ativiteter der vises for en virksomhed – kunne se hvilket jobcenter der har oprettet aktiviteten | x | |||||||||
UpdateHistoricActvity tilrettes så den fremadrettet opdaterer aktiviteter på sagsbehandlerkladden også | X | |||||||||
Som KSS jeg kan anvende data fra en jobordre eller en jobannonce fx til oprettelse af aktivitet | X | |||||||||
Som KSS behøver jeg ikke indberette forsørgelsestype | ||||||||||
Som KSS skal behøver jeg markere nytteindsats for en dagpengemodtager som et rådighedsafprøvende tilbud. Jeg skal huske, at udfylde begrundelsesfeltet, da dette er obligatorisk for rådighedsafprøvende tilbud (validering i DFDG). | X | |||||||||
Som KSS kan jeg håndtere, at CPR-nr. og p-nr. skal være udfyldt med 8 hhv. 10 tegn | X |
Oversigt over berørte web services
Snitflade | Serviceaftager der er berørt | Bemærkninger | |||||||||
DFDG | Jobnet | Plannersystemer | KSS | A-kasse | Ydelsessystem | JobKon | Andet | ||||
ActivityService (Version 3).
| X | Ny fejlkode | |||||||||
ActivityService (Version 4).
| f | ||||||||||
CodeListService (Version 5). ReferanceTypeIdentifier | f |
f = frivillig
Beskrivelse af epic
Denne epic samler en række mindre rettelser og forbedringer i forbindelse med aktiviteter efterlyst bl.a. af KSS.
Dog er det sådan at det er frivilligt for KSS at benyttet version 4 i 2018-1 dog vil der j.f. afsnit 4.5 690.8.6 Nytteindsats for en dagpengemodtager, markeres automatisk som et rådighedsafprøvende tilbud. være påkrævet af anvende den nye fejlkode der vil være i både version 3 og 4.
690.8.1 Som virksomhedskonsulent ønsker jeg at kunne se hvilket jobcenter der har oprettet en aktivitet
ActivityService (Version 3)
Bevares uændret af hensyn til a-kasserne.
ActivityService (Version 4)
GetActivity
Udvides med myndighedkode for de jobcenter der har oprettet aktiviteten. Det er det Jobcenter kaldt der CreateActivity de anvendes. Det efterspørges også om det er muligt at medtage dato for første publicering af aktiviteten.
Kun relevante og ændrede elementer er vist.
Element | Type | Forekomst | Beskrivelse |
---|---|---|---|
GetActivityResponse | GetActivityResponseType | 1 | |
- ActivityItem | ActivityItemType3 | 1 | En specifik aktivitet for en borger. |
ActivityCoreItem | ActivityCoreItemType4 | 1 | Indeholder basisdata for en aktivitet. |
- RecordingAuthority | AuthorityCodeType | 0-1 | Myndighedskode på det oprettende jobcenter. |
Oplysningen kan kun hentes vis "GetActivity".
Andre service der udstiller aktiviteter
PersonStatusService (Version 20)
Berøres ikke ved denne ændring og oprettende jobcenter vil ikke fremgå i denne service på aktiviteter.
PlanService (Version 3)
Berøres ikke ved denne ændring og oprettende jobcenter vil ikke fremgå i denne service på aktiviteter.
JobnetActivityService (Version 3)
Berøres ikke ved denne ændring og oprettende jobcenter vil ikke fremgå i denne service på aktiviteter.
MyPlanService (Version 2 og 3)
Berøres ikke ved denne ændring og oprettende jobcenter vil ikke fremgå i denne service på aktiviteter.
WSRMessageService (Version 10 og 11) ændres ikke
WSRMbeskeder i relation til dette Berøres ikke ved denne ændring.
JobnetMyPlanService
Berøres ikke ved denne ændring og oprettende jobcenter vil ikke fremgå i denne service på aktiviteter.
PersonHistoryService (Version 4)
Berøres ikke ved denne ændring.
690.8.2 UpdateHistoricActvity tilrettes så den fremadrettet opdaterer aktiviteter på sagsbehandlerkladden også
Afventer beskrivelse til acceptkriterie er defineret i scope
UpdateHistoricActvity tilrettes så den fremadrettet opdaterer aktiviteter på sagbehandlerkladden også.
690.8.3 På en aktivitet kan jeg registrere reference til en jobordre eller jobannonce.
ActivityService (Version 4)
CreateActivity, UpdateActivity, CreateHistoricActivity, UpdateHistoricActivity og GetActivity
Alle metode udvides men en collection der indeholder valgfrie referancer til f.eks. jobordre (ordinær eller tilskuds), jobannonce m.f.
Forretningsregler:
- Hvis "Ekstern system reference" Id 4 så angives identifikation af hvilken reference det er i ReferanceTypeDescription. DFDG valideret ikke for dette.
Kun relevante og ændrede elementer er vist.
Element | Type | Forekomst | Beskrivelse |
---|---|---|---|
ActivityCoreItemCompanyActivity | ActivityCoreItemTypeCompanyActivityType4 | 1 | Indeholder basisdata for en aktivitet.Indeholder virksomhedsrettet aktivitetsdetaljer. Er denne type til stede er aktiviteten af typen 'virksomhed'. |
- ReferenceIdentifierCollection | ReferenceIdentifierType | 0-1 | Samling af referencer til andre registreringer i DFDG eller lokalt hos jobcenter. |
ReferenceIdentifierType | ReferenceIdentifierType | 0-* | Reference til andre registreringer i DFDG eller lokalt hos jobcenter. |
ReferenceIdentification | String | 1 | Nøgle til det referancen. Interne referancer til andet i DFDG skal være en GUID |
ClientSystemTypeIdentifier | 1 | System der ejer referancen. | |
ReferanceTypeIdentifier | ReferanceTypeIdentifierType | 1 | Hvilken type af reference identifikationen peger på. F.eks. en ordinær joborder, |
ReferanceTypeDescription | String | 0-1 | Hvis der er en ekstern reference så identifikation af hvilken reference det er |
Konvertering
Eksisterende JobOrderIdentifier konverteres ikke og fra version 4 af AktivityService skal/må feltet ikke mere anvendes. Feltet fjernes ikke af hensyn til eksisterende referancer og eksisternde referancer kan forsat læses og gemmes. DFDG validerer ikke på hvad der er i feltet og om det anvendes.
CodeListService (Version 5)
Kodelister vedr. activityservice.
ReferanceTypeIdentifier
Kodeliste der angiver om hvilken type af reference (ReferenceIdentification) peger på.
Bemærk: "Ekstern system reference" Id 4 kan bruges af de eksterne serviceaftagere til at angive lokale (interne referencer), det kan så i "ReferanceTypeDescription" beskrives hvilken reference der er tale om.
OBS. Listen er generisk og indeholder derfor også kodelisteværdier på typer der ikke nødvendigvis bliver brugt i forbindelse med aktiviteter.
Ny kodeliste.
Id | Navn | Beskrivelse | Startdato | Slutdato |
1 | Jobannonce | Reference til en jobannonce (jobAdId) i JobAddService. | 01-10-2017 | 01-07-2100 |
2 | Tilskudsansættelses ansøgning | Reference til tilskudsansøgning i VITAS (VitasJobOfferIdentifier) | 01-10-2017 | 01-07-2100 |
3 | Ordinært joborder | Reference til landsdækkende ordinær joborder (CompanyRecruitmentIdentifier) i CompanyRecruitmentService. | 01-10-2017 | 01-07-2100 |
4 | Ekstern system reference | Ekstern system reference | 01-10-2017 | 01-07-2100 |
Andre service der udstiller aktiviteter
Disse service berøres ikke, da ReferenceIdentifierCollection kun anvendes i ActivityService.
690.8.4 Hvis forsørgelsestype indberettes af en serviceaftager ignoreres denne690.8.5 En aktivitet der hentes i DFDG udstiller ikke forsørgelsestype
ActivityService (Version 4)
CreateActivity, UpdateActivity, CreateHistoricActivity, UpdateHistoricActivity og GetActivity
Model 1.
SustenanceTypeIdentifier fjernes fra snitflade men ikke database, af hensyn til historik og de andre service hvor den forsat udstilles.
Model 2.
Eventulle valideringer på SustenanceTypeIdentifier og indhold smides væk
Andre service der udstiller aktiviteter
PersonStatusService (Version 20)
Berøres ikke ved denne ændring.
PlanService (Version 3)
Berøres ikke ved denne ændring og SustenanceTypeIdentifier vil stadig fremgå.Dette er tekniskgæld til senere oprydning når data ikke mere er relevant på historiske aktiviteter.
JobnetActivityService (Version 3)
Berøres ikke ved denne ændring og SustenanceTypeIdentifier vil stadig fremgå.Dette er tekniskgæld til senere oprydning når data ikke mere er relevant på historiske aktiviteter.
MyPlanService (Version 2 og 3)
Berøres ikke ved denne ændring og SustenanceTypeIdentifier vil stadig fremgå.Dette er tekniskgæld til senere oprydning når data ikke mere er relevant på historiske aktiviteter.
WSRMessageService (Version 10 og 11) ændres ikke
WSRMbeskeder i relation til dette Berøres ikke ved denne ændring og SustenanceTypeIdentifier vil stadig fremgå.Dette er tekniskgæld til senere oprydning når data ikke mere er relevant på historiske aktiviteter.
JobnetMyPlanService
Berøres ikke ved denne ændring og SustenanceTypeIdentifier vil stadig fremgå.Dette er tekniskgæld til senere oprydning når data ikke mere er relevant på historiske aktiviteter.
PersonHistoryService (Version 4)
Berøres ikke ved denne ændring.
690.8.6 Nytteindsats for en dagpengemodtager, skal markeres som et rådighedsafprøvende tilbud
ActivityService (Version 3 og 4)
CreateActivity, UpdateActivity, CreateHistoricActivity og UpdateHistoricActivity
Forretningsregel (i alle metoder, Ny regel, der ændres ikke i eksisterende regler):
- Når et tilbud om nytteindsats for en dagpengemodtager indberettes, skal det markeres automatisk som et rådighedsafprøvende tilbud. Ved virksomhedsrettet aktivitet skal det når:
- Kontaktgruppen er Id 1, Dagpengemodtager
- JobTypeIdentifier er
- Id 46 Nytteindsats, kommune
- Id 47 Nytteindsats, regional
- Id 48 Nytteindsats, stat
- Id 49 Nytteindsats, selvejende institution
DFDG validerer for, at nytteindsats for dagpengemodtagere skal indberettes som rådighedsafprøvende. Dvs. kaster fejl, hvis dette ikke er tilfældet(fejlkode XXXX "For the specified JobTypeIdentifier is AvailabilityProving mandatoryKun forslag til tekst."
- Eksisterende valideringer i f.t. rådighedsafprøvende tilbud gælder også for de tilbud, der automatisk er markeret som rådighedsafprøvende.
690.8.7 CVR- og p-nr. skal være udfyldt med 8 hhv. 10 tegn ved CreateActivity
Det er ikke hidtil valideret, om der er anvendt et CVR-nr. eller et p-nr. på 8 hhv. 10 tegn, når der registreres aktiviteter med Create-metoden. Det har betydet, at der i DFDG er gemt mange aktiviteter med CVR- og p-numre kortere end 8 hhv. 10 tegn.
Sådanne aktiviteter kan imidlertid ikke hentes ud vha. Get-metoderne på ActivityService eller i PSS, idet der på Output-siden foretages valideringer.
Derfor indføres validering på input-siden.
Ny validering på CreateActivity –krav om CVR- og p.nr. eller hhv 8 og 10 tegn
På Create-metoden indføres validering for, om CVR- og p.nr. er hhv 8 og 10 tegn.
Der valideres fortsat ikke for, om det anvendte CVR- og p-nr. findes i CVR-registeret. Der er således tale om en validering af det tekniske format – og ikke af, om de anvendte CVR- og p-nr. er forretningsmæssigt valide.
Dette er bl.a. bagrundet i, at nogle tilbud/aktiviteter gennemføres hos virksomheder m.v., der ikke har et CVR-nummer. For tilbud/aktiviteter, der gennemføres hos virksomheder m.v. uden CVR-nr., kan som CVR-nr. fx anvendes 00000000 (8 stk. 0'er) og som p-nr. fx anvendes 0000000000 (10 stk. 0'er).
Særlige krav til test
Testscenarie | Berørte systemområder | Identificeret af |
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.