Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
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? |
---|---|---|---|
15.06.2021 | 0.1 | Knud de Place | Nyoprettet på baggrund af drøftelse med Netcompany og a-kasser om indberetning af afholdte CV-samtaler og udfordringer med indberetning af cv-godkendelsesstatus, hvis cv-oplysninger /søgbarhed eller medlemmets tilstand har ændret sig mellem tidspunktet for kvalitetssikring af CV'et og indberetningstidspunktet |
25.08.2021 | 0.1 | Carsten Olsen / Knud | Opdateret på baggrund af input fra KSS og kommuner. |
26.08.2021 | 0.1 | Knud | Opdateret på baggrund af input fra a-kasser og a-kasseleverandører på it-forretningssdag (nyt acc.kr. 2) |
30.09.2021 | 0.5 | Knud | v 0.5 (efter tilsagn er modtaget). CvComment max 400 tegn. |
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | ||
---|---|---|
Som en sagsbehandler vil jeg gerne kunne indberette CV-godkendelsesstatus ud fra cv'ets og borgers/medlemmets tilstand på det tidspunkt, hvor cv-oplysningerne blev vurderet/kvalitetssikret for at jeg kan få registreret cv-godkendelsesstatus, selvom cv-oplysninger / cv søgbarhed eller medlemmets/borgers tilstand har ændret sig i mellemtiden | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for |
951.19.1 | DFDG/JobSearch understøtter mulighed for registrering af CV-godkendelsesstatus for tidligere tilstand af CV / borger/medlem | DFDG/JobSearch |
951.19.2 | DFDG/JobSearch understøtter mulighed for registrering af CV-godkendelsesstatus 'CV ej godkendt' (Id 3), selvom CV'et ikke er i en tilstand, hvor det er klar til kvalitetssikring (da a-kasserne har forretningsmæssigt behov for at kunne registrere dette) | DFDG/JobSearch |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
951.19.1 | 951.19.2 | ||||
KSS og a-kasse ibrugtager ny version afservice/ metoder til registrering af CV-godkendelsesstatus for tidligere tilstand af CV / borger/medlem samt hentning af CV oplysninger Frivilligt: Ibrugtages hvis jobcenter eller a-kasse har det forretningsmæssige behov. | X | X | Metoden udvides til at muliggøre at CV-godkendelsesstatus kan indberettes sammen med jobcentrets / a-kassens registrering af den afholdte samtale, selvom cv'et eller personen på registreringsdagen ikke længere opfylder betingelserne for registrering af cv-godkendelse Ny version af metode på ny version af service: JobSearch.CvWorkFlowService (Version 2) - UpdateCvStatus | ||
KSS og a-kasse kan uændret anvende nuværende version og metode til registrering af cv-godkendelsesstatus (hvor der alene valideres mod den aktuelle tilstand på af CV og borger/medlem registreringstidspunktet) Dog skal KSS og a-kasse være opmærksom på at STAR vil udfase JobSearch.CvWorkFlowService (Version 1) ved lejlighed (senere release med særskilt tilsagnsrunde) og det kan derfor være at løft til version 2 i dette regi. | X | X | Den nuværende metode på nuværende version 1 af service: JobSearch.CvWorkFlowService (Version 1) - UpdateCvStatus | ||
Oversigt over berørte webservices
Manuel oversigt som er synlig for eksterne
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 |
---|---|---|---|---|---|
JobSearch.CvService (Version 2).Alle | Ændret | Den version bibeholdes uændret, serviceaftaler opfordres dog til at anvende den nye version 3 | A-kasse, KSS | N/A | D+S |
JobSearch.CvService (Version 3).GetCv (GET /v3/Cv) | Ændret | Ny version af metode der indeholder hændelsesdato (eventDate) | A-kasse, KSS | N/A | D+S |
JobSearch.CvService (Version 3).GetCvStatus (GET /v3/Cv/cvstatus) | Ændret | Ny version af metode der indeholder hændelsesdato (eventDate) | A-kasse, KSS | N/A | D+S |
JobSearch.CvService (Version 3).GetHistoricalCv (GET /v3/Cv/historicalcv) | Ændret | Ny version af metode der indeholder hændelsesdato (eventDate) | A-kasse, KSS | N/A | D+S |
JobSearch.CvWorkFlowService (Version 1).Alle | Ændret | Den version bibeholdes uændret, serviceaftaler opfordres dog til at anvende den nye version 2 | A-kasse, KSS | N/A | D+S |
JobSearch.CvWorkFlowService (Version 2) UpdateCvStatus | Ændret | Ny version af metode hvor hændelsesdato (eventDate) kan angives | A-kasse, KSS | BI | D+S |
WsrmMessageService (Version 11).GetCVStatusVersion7 | Andet | Der er samme WSRM besked der forsat anvendes, af denne vil hændelsesdato (eventDate) derfor IKKE fremgå | A-kasse, KSS | N/A | D+S |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Beskrivelse af epic
Baggrund
Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.
Acc.kr. 951.19.1 - DFDG understøtter mulighed for registrering af CV-godkendelsesstatus for tidligere tilstand af CV / borger/medlem
DFDG / JobSearch understøtter mulighed for registrering af CV-godkendelsesstatus for tidligere tilstand af CV / borger/medlem, selvom
- cv-oplysningerne ift. komplethed eller søgbarhed efterfølgende er ændret
- borger/medlemmets tilstand ikke aktuelt er således, at CV'et kan godkendes, fx fordi
- personen er blevet afmeldt,
- kontaktgruppen ændret til en anden kontaktgruppe, eller
- kontaktgruppen er lukket
/wiki/spaces/GI/pages/2335736344
Beholdes uændret, og fra denne serviceversion er det ikke muligt at registrerer historiske CV-godkendelsesstatus.
Serviceaftagerne opfordres til at skifte til version 2 for alle anvendte metoder.
JobSearch.CvWorkFlowService (Version 2, 2021-4)
UpdateCvStatus
Opdatering af metode på JobSearch.CvWorkFlowService (Version 2) - UpdateCvStatus (PUT /v2/CvWorkflow/cvstatus) således, at historisk CV-godkendelsesstatus kan registreres.
Forskelle ift. den eksisterende metode UpdateCvStatus er markeret med grøn baggrund.
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CivilRegistrationIdentifier [Header] | string | Pattern:((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 0 - 1 | |
x-requestId [Header] | string | 1 | ||
requestBody | UpdateCvStatusRequestDto | 1 | ||
- eventDate | date-time | 0 - 1 | Dato for CV oplysninger, der er kvalitetssikret (Cv godkendelse eller Ej godkendelse) Skal kun anvendes hvis der er tale om en historisk ændring til CV status | |
- cvStatusType | CvStatusTypeCodeList | 1 | ||
- comment | string | 0 - 1 | Kommentar til CV i forbindelse med CV status |
Comment: Max 400 tegn.
Forretningsregler for UpdateCvStatus
Ændringer ift. nuværende forretningsregler for UpdateCvStatus er markeret med grøn tekst:
Generelle
DFDG betragter ændringer i CV status som tilstandsskift på CV'et og markerer CV'et, hver gang der ændres status med denne metode.
Det markerede CV kan efterfølgende listes med GetCVList og hentes med GetHistoricalCV.- For alle KG kan CV'et kun sættes til "CV ej godkendt" (Id 3), hvis der er registreret CV-oplysninger
For borger uden kontaktgruppe (beskæftigede m.v.):
Jobcenter eller a-kasse skal ikke behandle denne målgruppeJobcentret eller A-kasse må ikke sætte CV status på disse borgere. Bemærk at en borger beholder en eventuel CV Status der sat, f.eks. CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3) under en aktiv kontaktgruppe og denne CV status genaktiveres ved gentilmelding
Personen skal have en åben kontaktgruppe i JobSearch (bemærk at personen kan have en åben KG i DFDG (fx PersonVisitationStatusService eller PersonStatusService) uden at personens kontaktgruppe er åben i JobSearch, så selvom personens kontaktgruppe ser ud til at være åben, når status aflæses i PersonStatusService (PSS), så kan personens KG være lukket i JobSearch)
Jobcentret kan eventuelt registrere kontaktgruppe igen. A-kassen kan bekræfte tilmeldingen (ved at registrere en ny tilmelding som jobsøgende), hvis dette skulle opstå.
Særlig for a-kasser:
A-kasser må registrere status for egne medlemmer
Fremtidig godkendelse, altså hvor hændelsesdato (eventDate) er efter dags dato, er ikke lovlig.
For Dagpengemodtager (KG1) og Uden ydelse (KG 8) - dimittend
A-kasser må endvidere registrere CV status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3) for tidligere medlemmer, hvis hændelsesdatoen (eventDate) ligger inden for medlemsperioden i den registrerende a-kasse og CV’et opfylder minimumskriterierne for CV-søgbarhed1
A-kasser må kun anvende CV status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3) i følgende situationer:
Almindelig godkendelse - Hændelsesdato (eventDate) er = Null (standardudfyldelse):
CV kan kun sættes "CV godkendt" (Id 2)CV'et er søgbart - fejlkode 30018 “Only allowed to set ‘CV godkendt’ when Cv is available” OG
- personen er i åben KG1 eller KG8 (som hidtil), eller personens seneste åbne KG (i JobSearch) var KG1 eller KG8 (nyt) [formål: Minimere behov for datagenopretninger, når DFDG og JobSearch er ude af synk]
- Almindelig godkendelse - Hændelsesdato (eventDate) er = Null (standardudfyldelse):
CV kan kun sættes "CV ej godkendt" (Id 3)CV'et er i status påbegyndt eller er søgbart OG
- personen er i åben KG1 eller KG8 (som hidtil), eller personens seneste åbne KG (i JobSearch) var KG1 eller KG8 (nyt) [formål: Minimere behov for datagenopretninger, når DFDG og JobSearch er ude af synk]
Historisk godkendelse hvor hændelsesdato (eventDate) er før dags dato må foretages hvis:
CV'et opfyldte minimumskriterierne for CV-søgbarhed1 OG
personen var i åben KG 1 eller KG 8 på eventDate, eller personens seneste åbne KG (i JobSearch) var KG1 eller KG8 på eventDate (nyt) [formål: Minimere behov for datagenopretninger, når DFDG og JobSearch er ude af synk]
Det er kun muligt at sætte Hændelsesdato (eventDate) til en dato før dags dato.
- A-kasser må udfylde CVComment aht. at kunne skrive en kommentar, hvis fx CV'et godkendes historisk
- (For Jobcentrets behandling af Dagpengemodtager (KG1) og Uden ydelse (KG 8) - dimittend vedrørende CV status "CV’et ikke længere er fyldestgørende" (Id 5) se nedenståene afsnit "Særligt for jobcentre")
Note 1) Minimumskriterierne for CV-søgbarhed: CV har CV status "Klar til godkendelse" (Id 1), "CV godkendt" (Id 2), "CV ej godkendt" (Id 3) eller "CV’et ikke længere er fyldestgørende" (Id 5)
Særligt for jobcentre:
Jobcentret må kun sætte CV status for egne borgere.
Fremtid godkendelse Hændelsesdato, altså hvor eventDate er efter dags dato, er ikke lovlig
- For Dagpengemodtager (KG1) og Uden ydelse (KG 8) - dimittend
Jobcentret må anvende CV status "CV’et ikke længere er fyldestgørende" (Id 5) og kan i CVComment angive en tekst til a-kassen
Jobcentret må kun sætte "CV’et ikke længere er fyldestgørende" (Id 5) hvis eksisterende CV status er "CV godkendt" (Id 2)
For jobparate og åbenlyst uddannelsesparate
Almindelig godkendelse - Hændelsesdato (eventDate) er = Null (standardudfyldelse):
CV kan kun sættes i status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3):Hvis det er søgbart (fejlkode 30018 “Only allowed to set ‘CV godkendt’ when Cv is available”) OG personen er jobparat eller åbenlyst uddannelsesparat
Historisk godkendelse - Hændelsesdato (eventDate) er før dags dato:
CV'et opfyldte minimumskriterierne for CV-søgbarhed2 OG personen var jobparat eller åbenlyst uddannelsesparat på eventDate
- Det er kun muligt at sætte Hændelsesdato (eventDate) til en dato før dags dato.
Jobcentret må kun anvende CV status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3). (CV status "CV’et ikke længere er fyldestgørende" (Id 5) kan anvendes men har ingen forretningsmæssig konsekvens)
For ikke-jobparate og ikke-åbenlyst-uddannelsesparate
Jobcentret må kun anvende CV status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3).
For ikke-jobparate er anvendelsen af CV-status frivillig for jobcentret og CV-status vil ikke blive vist på JobnetJobcentret må sætte CV status "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3):
Almindelig godkendelse - Hændelsesdato (eventDate) er = Null (standardudfyldelse):
CV kan sættes "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3):- Hvis personen er Ikke-jobparat eller ikke-åbenlyst uddannelsesparat, og da uanset om CV er søgbart (dvs. fejlkode 30018 “Only allowed to set ‘CV godkendt’ when Cv is available” afskaffes for ikke-jobparat og ikke-åbenlyst uddannelsesparat, da jobcentret af hensyn til arbejdsflow gerne vil kunne registrere "CV godkendt", selvom det ikke er søgbart)
Historisk godkendelse - Hændelsesdato (eventDate) er før dags dato:
Uanset om CV'et er søgbart på eventDate
CV'et opfyldte minimumskriterierne for CV-søgbarhed2 OG personen var Ikke- jobparat eller ikke-åbenlyst uddannelsesparat på eventDate
- Det er kun muligt at sætte Hændelsesdato (eventDate) til en dato før dags dato.
CVstatus "CV’et ikke længere er fyldestgørende" (Id 5) er ikke relevant for ikke jobparate. Må gerne anvendes men har ingen forretningsmæssig konsekvens
Note 2) Minimumskriterierne for CV-søgbarhed: "Klar til godkendelse" (Id 1), "CV godkendt" (Id 2) eller "CV ej godkendt" (Id 3) (Bemærk "CV’et ikke længere er fyldestgørende" (Id 5) anvendes ikke på jobparat og åbenlyst uddannelsesparat men behandles efter samme regler).
WsrmMessageService (Version 11, 2021-3)
GetCVStatusVersion7
Hvordan gemmes historisk cv-godkendelsesstatus og hvilke beskeder (WSRM) sender der
- Hvis statusskiftet påvirkes (skifter) den aktuelle CV-status, sendes en besked (WSRM) og skiftet lægges på hændelseslisten (cvChangesInfo), som ved en almindelig opdatering af CV-status
- Hvis statusskiftet ikke påvirker (skifter) den aktuelle CV status, sendes ikke en besked (WSRM) men skiftet lægges alene på hændelseslisten.
Dog vil det i hændelseslisten (cvChangesInfo) fremgå et hændelsestidspunkt (eventDate), der afspejle det forretningsmæssige hændelsestidspunkt.
/wiki/spaces/GI/pages/2807201999
Beholdes uændret, og fra denne er det ikke muligt at hente hændelsesdato for registreringen af historiske CV-godkendelsesstatus.
Serviceaftagerne opfordres til at skifte til version 2 for alle anvendte metoder.
JobSearch.CvService (Version 3, 2021-4)
GetCv (GET /v3/Cv), GetCvStatus (GET /v3/Cv/cvstatus) og GetHistoricalCv (GET /v3/Cv/historicalcv)
Disse metode medtager nu hændelsesdata (eventDate), dels selve CV-status (cvStatusInfo) og dels i ændringslisten (cvChangesInfo)
Se JobSearch.CvService (Version 3 [UDV], 2021-4) for grønne rækker.
Acc.kr. 951.19.2 - DFDG/JobSearch understøtter mulighed for registrering af CV-godkendelsesstatus 'CV ej godkendt' (Id 3) eller 'CV godkendt' (id 2), selvom CV'et ikke er i en tilstand, hvor det er klar til kvalitetssikring
Vi åbner for at
- a-kassen kan registrere "ikke godkendelse" i denne situation, men vi beholder CV status (i dette tilfælde ("CV påbegyndt"). Bagved gør vi så det, at vi gemmer CV status "CV påbegyndt" igen, men hvor DFDG sætter en kommentar (CV comment), at a-kasse har været inde og se, at CV ikke kunne godkendes.
Baggrund for ændringerne:
- Pind 1: Efterspurgt af a-kasser.
Der sendes WSRM.
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
Ændring af CV status generelt | Selvom denne ændring alene indeholder ændringer i forhold at kunne sætte en historisk CV status med en hændelsesdato påvirker rettelsen også det nuværende reglsæt for normale for CV status (i koden). Der er ikke lavet om i forretningsreglerne for CV status, men da ændringen i systemer har betydet en omlægning af koden således den både kan håndtere de normale samt de historisk Cv status skift er der behov for at vi testmæssigt kikke på begge dele, da der er en risiko for vi utilsigtet har påvirket de normale regler. Til info: Er den automatiseret test i forbindelse med de normale CV status skift er ikke ændret og køre stadig grøn, den er dog udvidet til også at teste den historiske del også. | Carsten Olsen |
En historisk ændring kan også ændre den nuværende CV i nogel tilfælde | Til info: i teatsammenhæng skal man være opmærksom på at selvom CV status er historisk, dvs. indeholder en hændelsesdato, kan den også påvirke den aktuelle CV status i det tilfælde at hændelsesdatoen ligge efter senest status | Carsten Olsen |
Hvem må ændre CV status | Selvom forretningsreglerne er de samme for hvilke CV status der må anvendes hvornår, er der forskel på hvem der må sætte den så være obs på at vi her følger det samme princip som mange andre steder at borgeren f.eks. skal være medlem af den a-kasse der laver ændringen på tidspunktet for ændringen | |
Hændelseslist (changelog) | Da der er tale reelt om en efterregistrering ligges denne hændelse på hendelseslisten på det tidspunkt DFDG fik den ind og ikke ind i forhold til hændelsestidspunketet. Dette er bl.a. fordi vi ønsker at bevare den oprindelige historik som borger har oplevet den. |
* 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: Nej
- Skal der køres konvertering: Nej
- Skal der køres databasescripts for opdatering af tabeller i databasen: Nej
Efter idriftsættelse:
Ingen afvigelser fra normal proces.
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
- Nye dataområder: Nej
- Nye snitflader: Nej
- Nye komponenter: Nej
- Nye miljøer: Nej
- Nye teknologier: Nej
- Nye aftagertyper: Nej
- Eller afvigelser fra principperne: Nej
- Eventuelle behov for reduktion af teknisk gæld skal afdækkes: Ingen TG
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.
Husk GDPR stillingtagen
Ingen personfølsomme data i epics
Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.
- Ja, det er tjekket, at epic ikke indeholder dette.
Angiv hvem der har foretaget dette tjek: Knud
Angiv dato for tjek: 26.08.2021
Opbevaring af oplysninger i STARs it-systemer
Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.
Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.
Hvem må tilgå oplysningerne?
Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.
Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.
Korrekte sikkerhedsattributter på services
PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.
Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )
Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | |
---|---|---|---|---|---|---|
A-kasse | X | |||||
JobCenter | X | X | ||||
Kommune | X | |||||
STAR | X | |||||
AUB | ||||||
UDK | ||||||
STIL |
INGEN ændringer ift. de nuværende servicemetoder.
A-kasse filtrering
Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin
Sagsbehandlerlogin på Jobnet - tag stilling til adgang!
En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.
En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.
Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.
Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin
INGEN ændringer ift. de nuværende servicemetoder.