Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
| Page Properties | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
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 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Jira Legacy | ||
|---|---|---|
|
...
|
| Jira Legacy | ||
|---|---|---|
|
...
...
|
| Jira Legacy | ||
|---|---|---|
|
...
...
|
Indholdsfortegnelse
| Table of Contents | ||
|---|---|---|
|
...
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 | |||
|---|---|---|---|---|---|
...
Acceptkriterie <nr.>
...
Acceptkriterie <nr.>
...
Acceptkriterie <nr.>
...
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 |
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 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
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 (
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
...
Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:
...
DFDG
Services
WSRMer
Kodelister
PersonStatusService (PSS)
PersonHistoryService (PHS)
LSS (Landssupportsystem) og herunder Registerudtræk (hvis STAR har dataejerskab og der er lavet PHS på domænet)
...
Jobnet
...
VITAS
...
JobKon
...
JobAG
...
BI integrationsplatform
...
Alle områder
Nye batchjobs
Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon)
Dataløft
Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.
...
Kommunalt sagsbehandlingssystem
...
A-kasse sagsbehandlingssystem
...
Kommunalt bookingsystem
JobcenterPlanner (JCP)
WorkForcePlanner (WFP)
...
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.