1005.17.82 Jeg-søger-job-som - ny version 2 af JobSearch.JoboenskeService
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release
| STAR Release
| STAR Release
| Epic status | Eksterne snitflader |
---|---|---|---|---|---|---|
@Rebecca Kormind @Knud de Place (STAR) | @Michèle Leyssac Naur (Unlicensed) @Carsten Olsen | 2024-1 | 2024-1 | N/A | 1.0 | KSS (f), A-kasse (f) |
Indgik i tilsagn:
til release 2024-1, bølge 2
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? |
---|---|---|---|
17.10.2023 | 0.3 | @Knud de Place (STAR) | Oprettet. Indeholder de for eksterne aftagere relevante (ændringer til webservice snitflader) fra Jobnets implementering af 1005.18.18 Jobnet - Jeg søger job som - Dit Jobmatch |
04.12.2023 | 0.5 | @Knud de Place (STAR) | Ved opdatering af JSJS (‘Jeg søger job som' stillingsbetegnelse) fra Jobnet kan borgere med én eller flere udgåede stillingsbetegnelser alene slette alle udgåede stillingsbetegnelser på én gang, inden der kan foretages andre opdateringer i JSJS. Så WSRM vil ikke indeholde udgåede stillingsbetegnelser, når borger selv opdaterer sine JSJS |
02.01.2024 | 1.0 | @Knud de Place (STAR) | v1.0. Ikke andre ændringer |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/JOBS-1771
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 3 Afgrænsning af epic
- 4 Oversigt over berørte webservices
- 5 Beskrivelse af epic
- 5.1 Baggrund
- 5.2 Regler
- 5.3 Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
- 5.3.1 Jobcentre og a-kasser
- 5.4 1005.17.82.1 - Ny mulighed for tilføjelse, opdatering og sletning af jeg-søger-job-som stillingsbetegnelser én af gangen
- 5.4.1 Løsning
- 5.4.1.1 JoboenskeService (version 2)
- 5.4.1.1.1 Ny metode CreateJoboensker -
- 5.4.1.1.2 Ny metode DeleteJoboenske -
- 5.4.1.1.3 Ny metode UpdateJoboensker -
- 5.4.1.1 JoboenskeService (version 2)
- 5.4.1 Løsning
- 5.5 1005.17.82.2 - Eksisterende servicemetoder og version 1 af service holdes i live
- 5.5.1 Løsning
- 5.6 1005.17.82.3 - Ved tilføjelse eller sletning af en stillingsbetegnelse sendes en WSRM indeholdende den resulterende kollektion af borgers stillingsbetegnelser
- 5.6.1 GetPersonProfessionCollection
- 5.6.1.1 Ændringer til indhold
- 5.6.2 GetRecoveryCompositeMessage
- 5.6.1 GetPersonProfessionCollection
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
Afgrænsning af epic
Afgrænsning |
---|
Som Jobnet og ekstern aftager vil jeg gerne have mulighed for i Jeg-søger-job-som, at tilføje og fjerne én stillingsbetegnelse ad gangen (fremfor, at CreateJoboensker skal indeholde hele den kollektion, der skal være gældende) for at jeg nemmere kan implementere servicekald til opdatering af borgers jeg-søger-job-som stillingsbetegnelser
Som ekstern aftager ønsker jeg eksisterende logik holdt i live parallelt så jeg ikke i 2024-1 skal overgå til ændret logik for registrering af jeg-søger-job-som stillingsbetegnelser |
Acceptkriterier
Nr. | Beskrivelse | Relevant for | Intern STAR userstory |
---|---|---|---|
1005.17.82.1 | Ny mulighed for tilføjelse, opdatering og sletning af jeg-søger-job-som stillingsbetegnelser én af gangen | JobSearch |
|
1005.17.82.2 | Eksisterende servicemetoder og version 1 af service holdes i live | JobSearch |
|
1005.17.82.3 | Ved tilføjelse, opdatering eller sletning af en stillingsbetegnelse sendes en WSRM indeholdende den resulterende kollektion af borgers stillingsbetegnelser | JobSearch / DFDG |
|
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader
Kriterie | 1005.17.82.1 | 1005.17.82.2 | 1005.17.82.3 | Bemærkning |
---|---|---|---|---|
KSS og a-kasse kan vælge at anvende nye metoder på ny version 2 af servicen eller forblive på version 1 | X | Xe |
|
|
KSS og a-kasse er opmærksom på, at WSRM med jeg-søger-job-som stillingsbetegnelser i visse situationer vil indeholde både gældende og udgåede stillingsbetegnelser vil indeholde det fulde sæt af borgers aktuelle, gyldige JSJS-stillingsbetegnelser |
|
| X | WSRM’en indeholder som hidtil det fulde sæt af borgers aktuelle, gyldige JSJS-stillingsbetegnelser |
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.
(kopiér og indsæt manuelt i tabellen)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
---|---|---|---|---|---|
Andet | Version 1 er service forbliver i live og kan fortsat anvendes | A-kasse(t.o.), KSS(t.o.) | N/A | Jobsøgning | |
Ny | Ny metode i version 2 af servicen. Metoden benyttes til at oprette et eller flere jobønsker (som tilføjelse) i borgers kollektion af jobønsker/'Jeg søger job som'. | A-kasse(f), KSS(f) | N/A | Jobsøgning | |
Ny | Ny metode i version 2 af servicen. Metoden benyttes til at slette et enkelt jobønske i borgers kollektion af jobønsker/'Jeg søger job som'. | A-kasse(f), KSS(f) | N/A | Jobsøgning | |
Ændret | I version 2 af servicen udvides Get-metoden med GUID’er på borgers registrering af jeg-søger-job-som stillingsbetegnelser | A-kasse(f), KSS(f) | N/A | Jobsøgning | |
Ny | Ny metode i version 2 af servicen. Metoden benyttes til at opdatere et enkelt jobønske i borgers kollektion af jobønsker/'Jeg søger job som'. | A-kasse(f), KSS(f) | N/A | Jobsøgning | |
WsrmMessageService (Version 11). GetPersonProfessionCollectionVersion5 | Andet | Struktur uændret indhold, men afsendelse ændret. Og kan indeholde udgåede stillingsbetegnelser. Test er derfor nødvendig. | A-kasse, KSS | N/A | Jobsøgning |
WsrmMessageService (Version 11).GetRecoveryCompositeMessageVersion8 | Andet | Struktur uændret indhold, men afsendelse ændret. Test er derfor nødvendig. | KSS | N/A | Jobsøgning |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
summary | Varslingstype | Varslingsnote | Eksterne snitflader | Interne Snitflader | project | EPIC Number |
---|
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.
Jobcentre og a-kasser
KSS og a-kasse kan forblive på version 1 af JobSearch.JoboenskeService eller overgå til version 2.
Det er frivilligt for KSS og a-kasse at tage de 2 nye metoder på servicens version 2 i brug.
1005.17.82.1 - Ny mulighed for tilføjelse, opdatering og sletning af jeg-søger-job-som stillingsbetegnelser én af gangen
Der udvikles ny mulighed for tilføjelse, opdatering og sletning af jeg-søger-job-som stillingsbetegnelser én af gangen.
Løsning
Ny version 2 af JobSearch.JoboenskeService med
Ny metode CreateJoboensker
Ny metode DeleteJoboenske
Ny metode UpdateJoboensker
Udvidelse af metoden GetJoboensker med GUID / Unik identifier på jobønsket
Version 1 af JobSearch.JoboenskeService holdes i live
JoboenskeService (version 2)
Forretningsside med metodebeskrivelser https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505
Ny metode CreateJoboensker - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#CreateJoboenske-(POST-/v1/Joboenske)
Forretningsregler - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#Forretningsregler.1
Ny metode DeleteJoboenske - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#DeleteJoboenske-(DELETE-/v1/Joboenske/%7BJoboenskeIdentifier%7D)
Forretningsregler - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#Forretningsregler.2
Ny metode UpdateJoboensker - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#UpdateJoboenske-(PUT-/v1/Joboenske/%7BJoboenskeIdentifier%7D)
Forretningsregler - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4171071505#Forretningsregler.3
1005.17.82.2 - Eksisterende servicemetoder og version 1 af service holdes i live
Eksisterende servicemetoder og version 1 af service holdes i live.
Løsning
Version 1 af JobSearch.JoboenskeService holdes i live.
KSS og a-kasse kan forblive på version 1 eller overgå til version 2.
1005.17.82.3 - Ved tilføjelse eller sletning af en stillingsbetegnelse sendes en WSRM indeholdende den resulterende kollektion af borgers stillingsbetegnelser
Ved hver tilføjelse eller sletning eller opdatering af en stillingsbetegnelse sendes en WSRM indeholdende den resulterende kollektion af borgers stillingsbetegnelser.
WSRM’en indeholder som hidtil det fulde sæt af borgers aktuelle, gyldige JSJS-stillingsbetegnelser.
Ved opdatering af JSJS (‘Jeg søger job som' stillingsbetegnelse) fra Jobnet kan borgere med én eller flere udgåede stillingsbetegnelser alene slette alle udgåede stillingsbetegnelser på én gang, inden der kan foretages andre opdateringer i JSJS. Så WSRM vil ikke indeholde udgåede stillingsbetegnelser, når borger selv opdaterer sine JSJS
GetPersonProfessionCollection
Besked om oprettelse eller opdatering af borgers jobønsker.
GetPersonProfessionCollectionVersion5 dannes som hidtil, når
sagsbehandler opdaterer stillingsbetegnelser ifm. jc-tilmelding
borgeren/medlemmet selv opdaterer stillingsbetegnelser ifm. jc-tilmelding
når jeg-søger-job-som opdateres af borger/medlem direkte på Jobnet / i tilknytning til CV'et
når jeg-søger-job-som synkroniseres/ændres pga. ændringer af stillingsbetegnelser ifm. jc-tilmelding foretaget af sagsbehandler
når jeg-søger-job-som synkroniseres/ændres pga. ændringer af stillingsbetegnelser ifm. jc-tilmelding foretaget af borger/medlem
Ændringer til indhold
WSRM’en indeholder som hidtil det fulde sæt af borgers aktuelle JSJS-stillingsbetegnelser.
I de situationer, hvor borgers 'Jeg søger job som' stillingsbetegnelser indeholder én eller flere udgåede stillingsbetegnelser - og der tilføjes 1 eller slettes 1 stillingsbetegnelse med de nye metoder (CreateJoboenske og DeleteJoboenske) - vil den resulterende WSRM besked indeholde en kollektion af stillingsbetegnelser med én eller flere udgåede stillingsbetegnelser samt de fortsat gyldige stillingsbetegnelser.
Der dannes en WSRM-besked med en kollektion af borgeres samlede sæt af stillingsbetegnelser (med én eller flere udgåede stillingsbetegnelser samt de fortsat gyldige stillingsbetegnelser) for hver gang de nye metoder (CreateJoboenske og DeleteJoboenske) opdaterer borgers 'Jeg søger job som' stillingsbetegnelser.
GetRecoveryCompositeMessage
WSRM besked der sendes til KSS ved samtidig raskmelding, tilmelding og/eller kontaktgruppeopdatering.
Ved sagsbehandlers raskmelding via IllnessCompositeService angives fortsat det fulde sæt af ‘Jeg søger job som' stillingsbetegnelser, der fremadrettet skal være gældende. WSRM-beskeden til KSS om raskmeldingen vil afledt af dette også fortsat indeholde det fulde sæt af ‘Jeg søger job som' stillingsbetegnelser, der fremadrettet skal være gældende.
Særlige krav til test
Test scenarie | Deltagelse i test | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|---|
KSS og a-kasse, der tager nye metoder i brug kan tilføje og slette stillingsbetegnelser én ad gangen | KSS / a-kasse tilføjer 1 stillingsbetegnelse til borger, der allerede har mindst 1 jeg-søger-job-som stillingsbetegnelse KSS / a-kasse sletter 1 stillingsbetegnelse, der allerede har mindst 2 jeg-søger-job-som stillingsbetegnelser | JobSearch.JoboenskeService (version 2).
|
|
KSS / a-kasse kan håndtere at der modtages WSRM-besked, der indeholder en stillingsbetegnelse, der er udgået | Borger har en kollektion af stillingsbetegnelser, hvoraf mindst 2 er udgået. KSS / a-kasser sletter 1 af disse stillingsbetegnelser og kan håndtere, at WSRM med kollektion af de resulterende stillingsbetegnelser indeholder | JobSearch.JoboenskeService (version 2).
|
|
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:
Her beskriver PO/FA konsekvenser for løsninger efter idriftsættelse, hvis noget afviger fra normale setup.
Arkitektur- og implementeringsnoter
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.
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:
Angiv dato for tjek:
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 |
|
|
|
|
|
|
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