1005.18.43_UDV_(BVL) Gem søgning og jobagenter
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | Epic status | Eksterne snitflader |
---|---|---|---|---|
@Jette Knudsen | @Jan Nyman | Moderniseret jobnet første release | 0.3 | N/A |
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? |
---|---|---|---|
May 9, 2025 | 0.3 | @Jan Nyman | Epic udfyldt med løsninger og acceptkriterier |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/JOBS-9454
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 1005.18.43.1 - Det skal være muligt for borgere der er logget ind, at gemme sin søgning på Jobnet og slette den igen
- 5.3.1.1 Løsningsmodel
- 5.3.2 Flow tegninger på Jobnet
- 5.3.3 Gem søgning
- 5.3.4 Slet gemt søgning
- 5.3.5 Bruger flows på jobnet
- 5.3.6 1.0) Gem søgning
- 5.3.7 1.1) Gem søgning og opret jobagent i et flow (Denne del udgår fra classic i dag og får sit eget flow)
- 5.3.8 2.0) Vis gemte søgninger
- 5.3.9 3.0) Søg via eksisterende gemt søgning
- 5.3.10 4.0) Slet eksisterende gemt søgning
- 5.4 1005.18.43.2 - Det skal være muligt for brugere af Jobnet at oprette en jobagent ud fra sin søgning på Find job, uagtet om man er logget ind eller ej
- 5.4.1 Løsningsmodel
- 5.4.2 Bekræft eMail til jobagent
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
Afgrænsning af epic
Afgrænsning | ||
---|---|---|
Som bruger af Jobnet ønsker jeg at kunne gemme min filtrerede søgning på Find job med henblik på, at kunne genbruge disse søgekriterier. Jeg ønsker også at kunne oprette jobagenter, der automatisk sender mig e-mails om, at der er kommet nye Jobannoncer, hvor søgekriterierne matcher, den Jobaget, jeg har oprettet. | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for |
1005.18.43.1 | Det skal være muligt for borgere, der er logget ind, at gemme sin søgning på Jobnet og slette den igen | Jobnet |
1005.18.43.2 | Det skal være muligt for brugere af Jobnet at oprette en jobagent ud fra sin søgning på Find job, uagtet om man er logget ind eller ej | Jobnet |
|
|
|
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
N/A | <epic nr>.1.1 | <epic nr>.1 .2 | <epic nr>.1 .3 | <epic nr>.1 .4 |
Oversigt over berørte webservices
N/A - Denne epic er rent frontend
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.
Som en del af STAR modernisering af Jobnet omlægges borgerens gemte søgninger og jobagenter til det nye Jobnet. Den grundlæggende funktionalitet fra Jobnet classic bevares, da de forretningsmæssige arbejdsgange er uændret.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Der er ingen ændringer i regler for gemte søgninger og jobagenter for borger. I forhold til de anvendte DFDG services, beskriver denne epic alene borgerens funktionalitet på Jobnet.
Man kan ikke redigere en gemt søgning, man kan gemme, slette eller bruge den.
OBS: Vær opmærksom på at det i dag er 1 flow når man er logget ind, til at oprette en gemt søgning og Jobagent, det er fremadrettet delt ud til at være seperate flows.
1005.18.43.1 - Det skal være muligt for borgere der er logget ind, at gemme sin søgning på Jobnet og slette den igen
Løsningsmodel
STEP 1.
På Find Job i feltet “Dine Søgekriterier” kan brugeren, hvis han/hun er logget ind, tydeligt se en knap der hedder “Gem søgning”. Hvis brugeren ikke er logget ind, kan kan knappen ikke ses. (Alternativt skal den være grået ud, hvis man ikke er logget ind).
I udgangspunktet er knappen grået ud, så det er tydeligt, at den ikke kan anvendes. Knappen kan først anvendes, når brugeren har oprettet nogle søgekriterier.
STEP 2:
Ved klik på knappen åbner brugeren en modal, hvori brugeren skal registrere, at han vil gemme sine aktuelle søgekriterier.
Modalen indeholder en a)Tekst og et b)Inputfelt c) Knapper
a) Tekst: “Her kan du gemme din søgning med de søgekriterier, du har valgt, så du nemt kan genbruge søgningen, næste gang du logger ind. Giv din gemte søgning en titel, der gør det nemt at huske, hvad den indeholder”.
b) Inputfelt: Overskrift: “Titel på den gemte søgning”
Hjælpetekst i inputfelt: “Fx. Pædagogmedhjælper i København”
c) Teksten på de 2 Knapper er “Fortryd” og “Opret”
Ved klik på Fortryd lukkes modalen, og der sker ikke yderligere
Ved klik på “Opret” lukkes modalen og Titlen på søgningen fremgår nu i sektionen “Gemte søgninger”, og brugeren ser en Toast med beskeden “Din registrering er gemt”.
STEP 3:
Der laves en sektion på Find job, hvor titlerne på brugerens Gemte søgninger kan ses.
Sektionen med de gemte søgninger er synlig, hvis brugeren er logget ind
Sektionen er også synlig, selvom den er tom, fordi brugeren endnu ikke har gemte søgninger
Titlerne på de enkelte gemte søgninger fremgår som fremhævede tekstfelter.
Til venstre for titlerne findes et søgelup-ikon for at markere, at det er en søgning, Til højre for titlerne findes et X.
STEP 4:
Ved klik til højre - på skraldepandsikonet fremkommer en Bekræft-din-sletning-modal.
Den indeholder a) Tekst b) Knapper
a) Overskriften er “Slet gemt søgning”
Brødtekstet er “ Er du sikker på, at du vil slette din gemte søgning: [Titel på søgning]
b) Tekst på knapperne er “ Fortryd” og “Slet”.
Hvis brugeren klikker på “Fortryd” lukkes modalen og der sker ikke yderligere.
Hvis brugeren klikker på “Slet” sker der følgende:
a) Modalen lukkes
b) Den gemte søgning forsvinde fra sektionenen “Gemte søgninger”
c) Brugeren får en toastbesked, hvori der står: “Din registrering er gemt”
STEP 5:
Ved klik på et gemt-søgning-tekstfelt i øvrigt ( ikke ved skraldespanden) sker der 3 ting:
a) Den gemte søgnings søgekriterier bliver synlig i feltet med Søgekriterier
b) Knappen “Gem søgning” gråes ud”, da man ikke kan gemme en allerede gemt søgning 2 gange.
c) Udsøgningen foretages, og søge-resultatet afspejler de gemte søgekriterier i den gemte søgning.
Det fremhævede tekstfelt med titlen på søgningen vil fortsat fremgå af sektionen “Gemte søgninger”
Flow tegninger på Jobnet
Gem søgning
Slet gemt søgning
Bruger flows på jobnet
1.1) Gem søgning og opret jobagent i et flow udgår i det nye jobnet
1.0) Gem søgning | |
Formål | Borger kan gemme en søgning |
Aktører | Borger. |
Startbetingelse | Borger er logget ind |
Slutbetingelse | Borger har en gemt søgning i DFDG |
Trin |
|
Forretningsregler |
|
Link til data | |
Noter | En Gemt søgning adsiller sig ved ikke at have en eMail |
Screendump | N/A |
Noter til screendump | N/A |
1.1) Gem søgning og opret jobagent i et flow (Denne del udgår fra classic i dag og får sit eget flow) | |
Formål | Borger kan gemme en søgning og som jobagent i et flow |
Aktører | Borger. |
Startbetingelse | Borger er logget ind |
Slutbetingelse | Borger har en gemt søgning i DFDG |
Trin |
|
Forretningsregler |
|
Link til data | |
Noter | En Gemt søgning adsiller sig ved ikke at have en eMail En Jobagent adskiller sig ved at have en eMail |
Screendump | N/A |
Noter til screendump | N/A |
2.0) Vis gemte søgninger | |
Formål | Borger får vist sine gemte søgninger |
Aktører | Borger |
Startbetingelse | Borger er logget ind |
Slutbetingelse | Borger får vist alle sine gemte søgninger |
Trin |
|
Forretningsregler |
|
Link til data | Match.BorgersJobagentService (Version 1, 2025-2) | GetJobagenter (GET /v1/BorgersJobagent/Jobagent) |
Noter | En Gemt søgning adsiller sig ved ikke at have en eMail |
Screendump | Afventer screendump |
Noter til screendump | Afventer screendump |
3.0) Søg via eksisterende gemt søgning | |
Formål | Borger får vist sine gemte søgninger |
Aktører | Borger |
Startbetingelse | Borger er logget ind |
Slutbetingelse | Borger får vist alle sine gemte søgninger |
Trin |
|
Forretningsregler |
|
Link til data | |
Noter |
|
Screendump | Afventer screendump |
Noter til screendump | Afventer screendump |
4.0) Slet eksisterende gemt søgning | |
Formål | Borger får vist sine gemte søgninger |
Aktører | Borger |
Startbetingelse | Borger er logget ind |
Slutbetingelse | Borgers gemte søgning der er trykket slet på ligger ikke længere i DFDG |
Trin |
|
Forretningsregler |
|
Link til data | Match.BorgersJobagentService (Version 1, 2025-2) | GetJobagent (GET /v1/BorgersJobagent/Jobagent/{jobagentIdentifier}) |
Noter |
|
Screendump | Afventer screendump |
Noter til screendump | Afventer screendump |
1005.18.43.2 - Det skal være muligt for brugere af Jobnet at oprette en jobagent ud fra sin søgning på Find job, uagtet om man er logget ind eller ej
Løsningsmodel
STEP 1:
På Find Job feltet med Dine søgekriterier, vises brugeren knappen “Opret jobagent”, uanset om brugeren er logget ind eller ej.
Knappen er aktiv, hvis brugeren har valgt et eller flere søgekriterier. Hvis borgeren ikke har valgt nogle søgekriterier, kan knappen ikke bruges, og den er derfor grået ud.
STEP 2:
Ved klik på knappen “Opret Jobagent” fremkommer en modal, som indeholder følgende dele: a) et tekstområde b) en Drop-down c) 3 inputfelter og d) 2 knapper med teksterne “Fortryd” og “Opret”.
a) Tekst
Titel: “Opret en jobagent”
Tekst: “Du kan oprette en jobagent ud fra dine søgekriterier. Du vil få tilsendt en e-mail, når der kommer nye jobannoncer på Jobnet, som opfylder dine kriterier. Giv jobagenten en en sigende titel, så du kan huske, hvilke kriterier den dækker over. Du kan sagtens oprette flere jobagenter, som indeholder forskellige sæt af søgekriterier.”
b) Drop-down funktionsknap
Brugeren ser en Drop-down funktionsknap, som indeholder to valgmuligheder: “Dagligt” og “Ugentligt”.
Default står funktionsknappen på “Dagligt”.
c) 3 Inputfelter:
c1: Overskrift: “Titel på Jobagent”. Hjælpetekst i inputfelt: “Fx Frisørstillinger i Midtjylland, fuldtid”
c2: Overskrift: “Jobagenten skal sendes denne e-mail adresse”. Hjælpetekst: “ Navn@navnesen.dk”. Til højre for inputfeltet findes en knap med et brev-ikon og en tekst” Send kode”. Ved klip på denne knap sker der to ting:
c2a) der sendes en kode til brugerens angivne mailadresse
c2b) Der foldes et område ud nedenfor (c3)
[Spørgsmål: har vi mulighed for at validere om mailadressen opfylder almindelige formatkrav? Hvis bruger fx har glemt at sætte et “@” ind. Kan vi med det samme se om bekræftigelsesmailen når frem?]
c3) Overskrift: Du skal bekræfte e-mailadressen
Tekst: “For at sikre, at din Jobagent når frem til den rigtige e-mailadresse, har vi sendt en kode til [navn@navnesen]. Indtast koden nedenfor for at bekræfte e-mailadressen.”
[Hvordan ser mailen ud?]
Inputfeltet til at bekræfte koden indeholder ingen hjælpetekst.
Tekst på knap. “Bekræft”
Tekst: “Har du ikke modtaget kode? Tjek gerne dit spamfilter eller få tilsendt en ny kode”
[Få tilsendt en ny kode er linket. Det skal beskrives, hvad der sker, når man klikker her?]
d) 2 Funktionsknapper:
d1) Tekst på funktionsknappen til højre er “Fortryd”. Hvis brugeren klikker på denne, lukkes modalen, og Jobagenten oprettes ikke. [Kan dette lade sig gøre, og hvad sker der så med mail-adressen??]
d2) Tekst på funktionsknappen til venstre er “Opret”. Hvis brugeren klikker på denne sker der 3 ting:
d2a) Modalen lukkes
d2b)Jobagenten oprettes (og igangsætter den bagvedliggende beregning)
d2c) Brugeres vises en grøn toastbesked: “Din registrering er gemt”
Jobagenterne kan ikke tilgås fra Jobnet. Efterfølgende kan de kun administreres via jobagentmails.
Bekræft eMail til jobagent
STEP 3
Fra den dag Jobagenten er oprettet vil brugeren modtage mails, når der er relevante jobannoncer. Dvs Jobopslag, der opfylder søgekriterierne, som bruger har sat.
Forretningsreglerne for udsendelserne fremgår af EPIC xxx
Bruger modtager kun en mail, evt med flere jobagenter.
Den enkelte Jobagent indeholder et link, som bruger kan anvende, hvis brugeren ønsker at redigere eller slette Jobagenten.
Tekst på link: “Skift hyppighed på jobagenten eller afmeld”.
STEP 4
Ved klik på linket “Skift hyppighed på jobagenten eller afmeld”, lander borger på en skjult side på Jobnet.
Siden indeholder a) et tekstområde b) et Card per Jobagent med 1 Drop-downknap og 2 funktionsknapper
a) Tekstområde
Overskrift: “Foretag ændringer på din jobagent”
Tekst: “Her kan du skifte hyppigheden på din jobagent eller helt afmelde den”
b) Jobagent Card
b1: Overskrift: Jobagent:[Titlen på Jobagent]
b2:
b2a) Multiselect-knap skal have overskriften: “Indstil hyppighed” ( De 2 valgmuligheder er “Dagligt” eller “Ugentligt”). Default indstillingen er “Dagligt”.
b2b) Funktionsknap 1 har teksten : “Gem hyppighed”. Ved klik på denne vises en grøn toastbesked til brugeren med teksten: “Din registrering er gemt”
b2c) Funktionsknap 2 har teksten: “Afmeld jobagent”. Ved klik på denne åbnes en bekræftelses-modal, som indeholder b2c1: et tekstområde og b2c2: 2 funktionsknapper
b2c1: Et tekstområde. Overskriften skal være: “Afmelding af Jobagent”. Brødtekst: “ Er du sikker på, at du vil afmelde Jobagenten [Titel på Jobagent]
b2c2: To funktionsknapper:
b2c2a) Tekst: “Fortryd”. Ved klik på denne, lukkes modalen
b2c2b) Tekst: “Afmeld jobagent”. Ved klik på denne sker der 3 ting:
b2c2b1) Modalen lukkes og brugeren befinder sig på Find Job
b2c2b2) Jobagenten afmeldes
b2c2b3) brugeren ser en grøn toastbesked med teksten: “Din registrering er gemt”.
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
N/A | ||
* 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
N/A
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:
N/A
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: N/A
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.
Angiv hvem der har foretaget dette tjek: RHK
Angiv dato for tjek: 14.maj 2025
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.
Vedrørende Gemte søgninger: De gemte søgninger er knyttet til et personnummer og data opbevares 6 måneder efter brugeren har været aktiv på Jobnet.
Vedrørende Jobagenter: vi kan ikke knytte jobagenterne til et personnummer. Jobagenterne administreres dels af brugeren selv, som kan afmelde jobagenten, dels af systemet, som sletter Jobagenten, hvis brugeren ikke har klikket på mailen i 2 måneder. Vi sletter ikke Jobagenter som anvendes kontinuerligt.
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 )
N/A frontend
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
N/A frontend
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
N/A pt - Ikke afklaret på ny Jobnet