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)

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


2018-11.0KSS


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.
Der skal være reference til, hvor et ID på en jobordre eller jobannonce kommer fra således, at KSS kan lave automatik til oprettelse af aktivitet.
Som serviceaftager vil jeg have at DFDG ikke udstiller redundante eller misvisende data - For at undgå muligheden for fejlvisning/fortolkning
Tilbud om nytteindsats for en dagpengemodtager, markeres automatisk som et rådighedsafprøvende tilbud.



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
[Descopet]


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.
Eksisterende valideringer i f.t. rådighedsafprøvende tilbud gælder også for de tilbud, der automatisk er markeret som rådighedsafprøvende.

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).

  • CreateActivity
  • UpdateActivity
  • CreateHistoricActivity
  • UpdateHistoricActivity




X






Ny fejlkode


ActivityService (Version 4).

  • CreateActivity
  • UpdateActivity
  • CreateHistoricActivity
  • UpdateHistoricActivity
  • GetActivity




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

ClientSystemTypeIdentifierType

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.