Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Opdateret til 1.0, da Jobnets story er færdig.

...

...

...

Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning

Page Properties


STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release

Epic status

Eksterne snitflader

Camilla Hagedorn Trolle

Bjarne Hansen (Edora)Carsten Olsen

2022-3

1.0

...

KSS, a-kasse (t.o.)

Interne links (indhold i links ikke relevant for eksterne)

Jira Legacy
serverSystem JIRA
columnskey,po,fa,ux,sme,eksterne snitflader,interne snitflader,status,labels
maximumIssues4
jqlQueryissuetype = epic AND cf[10006] = 971.30 order by key
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a

...


...

Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

Dato

Version

Hvem

Hvad er ændret?

2022-07-13

0.5

Bjarne Hansen

Tilføjet præcisering af eksisterende og fremtidige mapninger af ophørsårsager

Interne links (indhold i links ikke relevant for eksterne)

Jira Legacy
serverSystem JIRA
columnskey,

...

po,

...

fa,

...

ux,

...

sme,

...

eksterne snitflader,interne snitflader,status,labels
maximumIssues4
jqlQueryissuetype = epic AND cf[10006] = 971.30 order by key
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
key

...

VIR-

...

1870

Jira Legacy
serverSystem JIRA

...

serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-7480

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyBI-1643

Indholdsfortegnelse

Table of Contents
outlinetrue

...

Afgrænsning af epic

Afgrænsning

Som KSS

vil jeg have forbedret kompatibilitet mellem VITAS og ActivityService

for at det er muligt for KSS at overføre data fra VITAS til ActivityService 

Acceptkriterier



Nr.

Beskrivelse

Relevant for

971.30.1

ActivityStatusCauseTypeIdentifier har koder til ikke-igangsat og normalt udløb

VITAS, DFDG, KSS, Jobnet

971.30.2

VITAS fritekstfelter er begrænset til 2.000 tegn ved nyoprettelse

VITAS, DFDG, KSS, Jobnet

971.30.3

VITAS tillader ikke permanent fleksjob for selvstændige

VITAS, DFDG, KSS

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger


971.30.1

971.30.2

971.30.3



A-kasse skal vide, at der kommer nye aktivitets-status-årsagskoder (ActivityStatusCauseTypeIdentifier) på aktiviteter, men skal ikke aktivt anvende de nye værdier

X





KSS skal vide, at der kommer nye aktivitets-status-årsagskoder (ActivityStatusCauseTypeIdentifier) på aktiviteter - og kan anvende de nye værdier, der er efterspurgt af KSS

X





KSS skal vide, at VITAS fritekstfelter begrænses til 2.000 tegn ved nyoprettede sager fra og med release 2022-3, mens eksisterende sager fortsat kan have længere tekster


X




KSS skal vide, at VITAS validerer at selvstændige ikke kan få permanent fleksjob ved nyoprettede sager fra og med release 2022-3.



X



Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne (links i listen virker kun med STAR Jira konto):

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

...

BorgerKommunikation.CodeListsService.ActivityStatusCauseTypeIdentifier

Ændret

Nye værdier i kodelisten - af hensyn til kommunikationen fra VITAS til KSS

A-kasse(t.o.), KSS

BI, VITAS

D+S

Automatisk oversigt

CodeListService (version 5).ActivityStatusCauseTypeIdentifier

Ændret

Nye værdier i kodelisten - af hensyn til kommunikationen fra VITAS til KSS

A-kasse(t.o.), KSS

BI, VITAS

D+S

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

Jira Legacy
serverSystem JIRA
columnssummary,varslingstype,varslingsnote,eksterne snitflader,interne snitflader,project
maximumIssues100
jqlQueryissuetype = Varsling AND linkedIssue in (VIR-303, DS-7480) ORDER BY summary, Varslingstype, "Eksterne snitflader", "Interne Snitflader"
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a

Beskrivelse af epic

Denne epic implementerer forbedringer, som reducerer kompatibilitetsproblemer mellem VITAS, KSS'er og DFDG ActivityService. På møde mellem STAR, KMD og Schultz d. 24. februar 2022 blev følgende forbedringer aftalt:

  • VITAS begrænser fritekstfelter til 2.000 tegn ved oprettelse af nye sager. Eksisterende sager har uændrede feltlængder, som kan være op til 4.000 tegn (FB 232258, FB 171457 m.fl.).

  • VITAS må ikke returnere NULL i ActivityStatusCauseTypeIdentifier ved nye sager. ActivityStatusCauseTypeIdentifier udbygges med nye koder, som repræsenterer, 1) at bevillingen er lukket inden den er blevet godkendt, 2) bevilling er udløbet planmæssigt (FB 220307).

  • VITAS forhindrer permanent fleksjob for selvstændige (FB 217619).

Forbedringerne er et led i den løbende tilpasning af VITAS til ActivityService, så KSS'ernes opgave med at mappe fra VITAS til ActivityService forenkles. Figuren herunder illustrerer samspil mellem VITAS, KSS'er og ActivityService, samt formål med data i VITAS hhv. ActivityService.

...

Mange (måske de fleste?) tekster på bevillinger udarbejdes af sagsbehandlere på jobcentrene med henblik på at samme tekster kan anvendes både i dialog med virksomhed (VITAS) og i dialog med borgeren (ActivityService / Min plan). 

Ikke omfattede forbedringer

Epic'en adresserer ikke følgende sager i integrationen mellem VITAS, KSS'er og DFDG ActivityService, som fortsat er åbne:

FB

Beskrivelse

Oprettet dato

130668

ÆØ - Tilskudssats i VITAS tilføjes tykke WSRM beskeder JobOrderNotificationsService

2018-11-08

122822

ÆØ: JobAllocationTypeIdentifier mangler denne i WSRM (VITAS)? (Voksenelev)

2018-06-07

141870

Uoverensstemmelse mellem tal og data

2019-07-05


Bedre adskillelse mellem interne tilstande i VITAS og eksternt rettede tilstande (møde. 24. februar 2022)


154187

Håndtering af ophør på løntilskud og virksomhedspraktik, - hvor borger fortsætter i virksomhed inden forventet ophør

10/09-19

971.30.1 ActivityStatusCauseTypeIdentifier har koder til ikke-igangsat og normalt udløb

ActivityStatusCauseTypeIdentifier har i dag fortrinsvis koder for afslutning af en bevilling af særlige årsager og disse er ikke tilstrækkelige til at repræsentere alle de tilstandsskifter, hvor VITAS sender WSRM'er til KSS. KSS ønsker altid - for de ordninger, som anvender ActivityStatusCauseTypeIdentifier - at modtage en værdi i ActivityStatusCauseTypeIdentifier og ønsker ikke at modtage NULL. ActivityStatusCauseTypeIdentifier skal derfor udbygges med nye værdier, som understøtter alle de tilstandsskifter, hvor VITAS sender WSRM'er.

VITAS har overordnet set 3 faser i en bevilling jf. nedenstående figur.

...

ActivityStatusCauseTypeIdentifier får følgende nye koder:

Identifikator

Navn

Beskrivelse

Startdato

Slutdato

1

Fejloprettet

Jobcenteret har desværre fejloprettet aktiviteten

10-07-2008

01-07-2100

2

Revision af plan

Jobcenteret har revideret planen

10-07-2008

01-07-2100

3

Aflyst af jobcenter/AA/A-kasse/Kursusudbyder

Aktiveringen er aflyst af jobcenteret, din anden aktør, A-kassen eller kursusudbyderen

10-07-2008

01-07-2100

4

Overholdt ikke aktivitet

Borgeren har ikke fulgt aktiviteten

10-07-2008

01-07-2100

5

Udeblevet fra start/møde

Borgeren er udeblevet fra aktivitet

10-07-2008

01-07-2100

6

Afbrudt kursus

Borgeren har afbrudt sin deltagelse i et kursus

10-07-2008

01-07-2100

7

Ikke ansat

Borgeren er ikke ansat

10-07-2008

01-07-2100

8

Ikke kontaktet/mødt arbejdsgiver

Borgeren har ikke kontaktet eller er ikke mødt hos arbejdsgiver

10-07-2008

01-07-2100

9

Ønsker ikke jobbet

Borgeren ønsker ikke jobbet

10-07-2008

01-07-2100

10

Opsagt af ledig

Borgeren har opsagt sin ansættelse

10-07-2008

01-07-2100

11

Opsagt af virksomheden

Borgeren er opsagt af virksomheden

10-07-2008

01-07-2100

12

Eksporteret

Årsagen skal sættes på alle aktiviteter i et it-system, der har eksporteret en aktivitet i forbindelse med enten opstart eller flytning

02-12-2010

01-07-2100

13

Overgået til ressourceforløb

Overgået til ressourceforløb

04-02-2013

01-07-2100

14

Bevilling ikke godkendt

Virksomhed, jobcenter eller borger har ikke godkendt bevillingen eller har trukket bevillingen tilbage

01-04-2022

01-07-2100

15

Aktivitetsperioden afsluttet ordinært

Bevillingen er lukket efter ordinært udløb

01-04-2022

01-07-2100

VITAS mapning til ActivityStatusCauseTypeIdentifier

VITAS mapper til disse nye koder jf. nedenstående tabel:

JobAllocationStatusTypeIdentifier

Identifikator

JobAllocationStatusTypeIdentifier

Navn

Beskrivelse

ActivityStatusCauseTypeIdentifier

Identifikator

ActivityStatusCauseTypeIdentifier

Navn

1

Afventer godkendelse hos virksomhed

Bevilling eller vurdering oprettet på en ansøgning og afventer godkendelse hos virksomhed

N/A

N/A

2

Godkendt af virksomhed

Virksomhed har godkendt bevilling eller vurdering

N/A

N/A

3

Afvist af virksomhed

Virksomhed har afvist bevilling eller vurdering

14

Bevilling ikke godkendt

4

Lukket

Bevilling eller vurdering er blevet lukket

Jf. registrering på sagen, hvis der er registreret ophørsårsag. Og ellers:15

f. registrering på sagen, hvis der er registreret ophørsårsag. Og ellers:Aktivitetsperioden afsluttet ordinært

5

Forlængelsesanmodning

Virksomhed har anmodet om forlængelse

N/A

N/A

6

Forlængelse godkendt

Anmodning om forlængelse godkendt

N/A

N/A

7

Forlængelse afvist

Anmodning om forlængelse afvist

N/A

N/A

8

Ophørsanmodning

Virksomhed har anmodet om ophør

Jf. ophørsårsag på sagen

Jf. ophørsårsag på sagen

9

Ophør godkendt

Anmodning om ophør godkendt

Jf. ophørsårsag på sagen

Jf. ophørsårsag på sagen

10

Ophør afvist

Anmodning om ophør afvist

N/A

N/A

11

Afventer godkendelse af borger

Bevilling eller vurdering oprettet på en ansøgning eller bevilling og afventer godkendelse hos borger

N/A

N/A

12

Godkendt af borger

Borger har godkendt bevilling eller vurdering

N/A

N/A

13

Afvist af borger

Borger har afvist bevilling eller vurdering

14

Bevilling ikke godkendt

BEMÆRK: Ikke alle ordninger anvender ActivityStatusCauseTypeIdentifier.

Observation til senere overvejelse sammen med KSS

OBS! Ikke del af denne epic.

VITAS bør ved evt. renovation udstille nye, eksternt rettet hændelser (ikke status) til KSS'erne fx med tilhørende eksterne tilstande:

Ekstern hændelse

Ekstern tilstand

Bemærkning

Bevilling under godkendelse

Under godkendelse

Er ikke en bevilling endnu. Relevant for KSS?

Bevilling godkendt

Godkendt

Afventer starttidspunkt

Bevilling igangsat

Aktiv

Starttidspunkt nået

Bevillingsperiode på aktiv bevilling er ændret

Aktiv

Forlænget / reduceret, m. evt. ophørsårsag

Bevilling ophørt

Lukket

Ordinært udløb eller afbrudt før tid, m. evt. ophørsårsag

Bevilling annulleret

Annulleret 

Bevillingen blev aldrig godkendt og dermed aldrig til en bevilling. Relevant for KSS?

Denne ændring er ikke relevant nu og skal analyseres nærmere inden beslutning. Formålet er at undgå at afkoble VITAS' interne tilstandshåndtering fra eksterne interessenter

...

Brugervejledning om negative underretningspligtige hændelser fra jobcenter til a-kasse og a-kassens besvarelser (star.dk).

971.30.2 VITAS fritekstfelter er begrænset til 2.000 tegn ved nyoprettelse

VITAS anvender i dag oftest feltlængder på 4.000 tegn ved fritekstfelter. Det betyder, at virksomheder og sagsbehandlere kan indtaste tekster, der ikke kan lagres i ActivityService, som har følgende maksimale feltlængder:

MyPlanService

  • Core-elementet

  • CauseRemark: 1-2000 tegn

  • ReasonForActivity: 1-2400 tegn

  • ActivityDescription: 1-2000 tegn

VITAS skal fremover kun tillade feltlængder på max. 2.000 tegn ved nyoprettelse af sager (ansøgninger, bevillinger ...). VITAS ændrer ikke på eksisterende data, som fortsat kan være op til 4.000 tegn. VITAS implementerer derfor længdebegrænsningen ved frontend validering, mens backend valideringen stadig anvender 4.000 tegn. 

KSS vil opleve, at WSRM'er og webservices er uændrede og tillader fortsat længder på op til 4.000 tegn. KSS vil opleve at WSRM'er og webservicekald ved nye sager i praksis altid har længder på max. 2.000 tegn, mens  WSRM'er og webservicekald ved ældre sager kan returnere feltlængder på op til 4.000 tegn. KSS håndterer for lange tekster i forhold til ActivityService ved ældre sager. Dette princip er aftalt med KSS på mødet 24. februar 2022.

KSS kan evt. trunkere for lange data på ældre sager og henvise til VITAS, fx "... Teksten er beskåret, men findes komplet i VITAS, som sagsbehandleren har adgang til". Borgeren har ikke adgang til VITAS.

Konsekvens

Tidligere udvidelse omgøres:

...

971.30.3 VITAS tillader ikke permanent fleksjob for selvstændige

VITAS validerer at selvstændige ikke kan få permanent fleksjob, dvs. følgende kombination er ikke tilladt:

...

 FlexjobDurationIdentifierType type=2 og EmployedInOwnCompany=true

VITAS' mapninger af ophørsårsager

Når arbejdsgivere registrerer ophør på bevillinger, skal de (afhængig af ordning) angive årsag til ophør. Det gøres med følgende valg (Virksomhedspraktik, ,tilsvarende for Løntilskud og delvis for Voksenlærling):

...

Ved valg af "Den ansatte er ophørt før tid" udfyldes "Uddyb venligst årsagen" jf. ovenstående.

Info

VITAS har en (for nylig opdaget) forretningsregel om at WSRM IKKE må indeholde ActivityStatusCauseTypeIdentifier ved valg af "Den ansatte er ophørt før tid".

Årsag: Hvis KSS registrerer ophør i ActivityService med en ActivityStatusCauseTypeIdentifier for årsagerne vedr. "Den ansatte er ophørt før tid", udløser aktiviteten en NUP (Negativ Underretningspligtig hændelse) til a-kasserne, som kan påføre den berørte borger en sanktion. Det er kun jobcentre, som må udløse en NUP, det må arbejdsgiverne ikke. (Nogle) KSS'er opretter og opdaterer automatisk ActivityService baseret på WSRM'er fra VITAS, hvilket betyder, at arbejdsgiverens registrering i VITAS kan udløse en NUP og det må ikke ske. STAR kan derfor ikke åbne op for mapning af disse ophørsårsager før alle KSS'er har givet tilsagn om at de aldrig registrerer en ActivityStatusCauseTypeIdentifier i ActivityService uden at det er godkendt af en sagsbehandler i jobcenteret. Det er tidsmæssigt ikke muligt at aftale dette tilsagn til release 2022-3. Det vil være muligt at aftale dette med KSS'er til en senere release.

Se også: https://star.dk/media/17661/2021_04_12_vejledning-om_underretningskoder_tilbagemeldinger_2021_1.pdf

For release 2022-3 gælder derfor følgende mapninger fra arbejdsgiverens registrering af årsag til ophør til ActivityStatusCauseTypeIdentifier i WSRM:

Intern kode i VITAS

Ophørsårsag i VITAS

Ordninger

Kode i DFDG

Forklaring DFDG

0

Den ansatte stopper, da praktikperioden er udløbet

Virksomhedspraktik

15

Bevillingen er lukket efter ordinært udløb

1

Den ansatte vil fortsætte i virksomheden uden praktik

Virksomhedspraktik

15

 Bevillingen er lukket efter ordinært udløb

2

Den ansatte er ophørt før tid (flere undervalg)

Virksomhedspraktik, Løntilskud

 -

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

3

Fejlregistrering

Virksomhedspraktik, Løntilskud, Voksenlærling

1

Fejloprettet

4

Aflyst af jobcenter eller anden aktør

Virksomhedspraktik, Løntilskud, Voksenlærling

3

Aflyst af jobcenter/AA/A-kasse/Kursusudbyder

0

Den ansatte stopper, da løntilskudsperioden er udløbet

Løntilskud

15

Bevillingen er lukket efter ordinært udløb

1

Den ansatte vil fortsætte i virksomheden uden løntilskud

Løntilskud

 15

Bevillingen er lukket efter ordinært udløb

5

Voksenlærlingen er udeblevet fra uddannelsen

Voksenlærling

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

6

Voksenlærlingen har afbrudt uddannelsen

Voksenlærling

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

11

Virksomheden har afbrudt voksenlærlingeforløbet

Voksenlærling

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

10

Borgeren har opsagt sin ansættelse

Virksomhedspraktik, Løntilskud

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

11

Borgeren er opsagt af virksomheden

Virksomhedspraktik, Løntilskud

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

5

Borgeren er udeblevet fra aktivitet

Virksomhedspraktik, Løntilskud

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

4

Borgeren har ikke fulgt aktiviteten

Virksomhedspraktik, Løntilskud

-

Må IKKE mappes, da det vil generere NUP’er - gælder alle undervalg

Mapninger markeret med gult er nye i 2022-3, mens øvrige mapninger er uændrede i forhold til foregående release.

Særlige krav til test

Test scenarie

Berørte systemområder (herunder nye batchjobs*) 

Identificeret af

* Batchjobs

  • bør testes både med delta og fuldt load,

  • bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden

  • bør testes i samarbejde med teams som har afhængigheder

  • kørselstid, særligt hvis det er en del af NightlyBatch

Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse:

  • Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres

  • skal der køres konvertering

  • Skal der køres databasescripts for opdatering af tabeller i databasen

Efter idriftsættelse:

Arkitektur- og implementeringsnoter 

Mapning til ActivityService implementeres i en særskilt komponent i VITAS således at kendskab til ActivityService ikke spredes til hele VITAS applikationen. Derved vil det også blive lettere at omlægge til eventbroker på et senere tidspunkt, når / hvis en sådan implementeres hos STAR.

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

  • Nye dataområder

  • Nye snitflader

  • Nye komponenter

  • Nye miljøer

  • Nye teknologier

  • Nye aftagertyper

  • Eller afvigelser fra principperne

  • Eventuelle behov for reduktion af teknisk gæld skal afdækkes

Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.