Denne service gør det muligt at understøtte joblog både som sagsbehandler i jobcentret eller a-kassen eller som borger via Jobnet eller brugervendt a-kasse løsning. Der er derfor både metode der er forbeholdt sagsbehandlere, fælles metoder og metode forbeholdt borger via borgervente løsninger.

Forretningsbeskrivelse

En joblog er et værktøj, hvor det er muligt at notere alle de handlinger, der knytter sig til den enkeltes jobsøgning. F.eks.

• Hvilken stilling borger har søgt – og hvornår

• Status om borger har kontaktet arbejdsgiveren m.v.

• Om borger søgt digitalt, skriftligt eller pr. telefon.

• Hvilken kilde til jobbet f.eks. uopfordrede borger anvendt

• Hvilke jobsøgningsaktiviteter borger har planlagt.

Jobloggen kan således give:

• Input til handling

• Gennemsigtighed

• Ærlighed

• God basis for dialog med jobkonsulent

Jobloggen skal skabe grundlaget for en god kommunikation med sagsbehandleren samt hjælpe brugeren med at holde styr på sin jobsøgning. Det er også i loggen man kan krydse sine planlagte opgaver af og dermed med god samvittighed holde fri.

A-kassen og jobcentret får adgang til oplysningerne, så de kan følge med i den lediges jobsøgning og bedst muligt kan målrette vejledningen til den enkelte.

Jobcenter

Servicen indeholder metoder der gør det muligt for sagsbehandlere / jobkonsulenter i Jobcenteret at se jobloggen for egne borgere.
Jobcenteret har ikke mulighed for at opdatere jobloggen.

A-kasse

Servicen indeholder metoder der gør det muligt for sagsbehandlere / jobkonsulenter i a-kassen at se jobloggen for egne medlemmer. A-kassen kan se joblogs oprettet i a-kassens medlemsperiode.

Fra brugervendt a-kasse løsning er det mulig for borger kan opdaterer sig joblog. A-kasses brugervendt løsning har kun adgang til at registrere på egne medlemmer
Hvis a-kassen ikke har valgt at tilgå disse metoder via deres eget fagsystem, kan de udstillede metoder på Jobnet for jobkonsulenter anvendes (indtil 31. december 2022, hvor JobKon lukkes). 

Borger

Det gør det muligt for dagpengemodtagere at vælge hvorfra de ønsker at benytte jobloggen og kan frit veksle imellem at benytte Jobloggen via Jobnet eller via a-kassens selvbetjeningløsning. Ledige dagpengemodtagere, hvis a-kasse ikke udstiller til jobloggen i deres selvbetjeningløsning, skal anvende jobloggen på Jobnet.

Afstand og rejsetid på Joblogs

Når både borgers hjemmeadresse og selve Joblog-entryen jobbet er geokodet kan afstand og forventet daglig rejsetid beregnes. Afstand er fugleflugtsafstand mellem de 2 punkter. Afstanden gemmes for at gøre det lettere at bruge i søgningen. Fugleflugtafstanden er enkelt vej. Det vil fremgå af teksten på jobnet over for borgeren.

Forventet daglig rejsetid beregnes ved at lave et serviceopslag hos Rejseplanen og finde hurtigste rute med ankomsttid klokken 8 og så gange med 2, så man får en samlet daglig transporttid. Det vil fremgå af teksten på jobnet over for borgeren.

Geokodning og beregning af rejsetid

Hvis der ikke leveres geokoordinater eller rejsetid med på nye Joblogs fra Jobnet, sørger DFDG for dette.

For ikke at koble systemet tæt til en ekstern part gøres følgende. Der forsøges at lave geokodning og rejsetidsberegning synkront, men hvis servicen er langsom eller ikke svarer returneres ikke en fejl, men blot en Joblog uden geokoordinater og/eller rejsetid. I det tilfælde vises på Jobnet, at rejsetid og/eller afstand ikke kunne beregnes.

Herefter forsøges asynkonront med et batchjob, der kan samle op på de fejlede og på registreringer fra a-kassernes egne joblog-løsninger (selvbetjeningsløsninger). Ved succesfuld opsamling, vil rejsetid og afstand fremgå af jobloggen i Jobnet, når den genopfriskes.

Feltet rejsetid og Afstand kan udfyldes af A-kassen, men skal være beregnet på samme måde som i STARs beregning i GeoService. Eventuelle lokale rejsetidsberegninger i A-kassesystemet beregnet på anden måde, må ikke gemmes i DFDG, da der ellers kan opstå forskel på de joblogs, der er oprettet fra Jobnet og dem fra A-kassens system.

Oprydning i oploadede dokumenter

DFDG fortage løbende oprydning i dokumenter i jobloggen. Hvis et dokument er fjernet ifm. oprydning, vil dette ikke fremgå af historik, men kun i dokumentets metadata (status = Deleted By System samt delete dato). Forsøges det at tilgå dokumentet via GetJoblogDokument (GET v1/Joblog/{underretningIdentifier}/dokument/{dokumentId}, UpdateJoblogDokument (PUT /v1/Joblog/dokument/{dokumentIdentifier}) eller DeleteJoblogDokument (Delete /v1/Joblog/dokument/{dokumentIdentifier}/svar/{dokumentIdentifier})) returneres fejlkode 9301.

Datavask / ulovlige tegn strippes

For følgende metoder valideres inden indlæsning i DFDG således, at strengværdier strippes for ugyldige karakterer:

• CreateJoblog (POST /v1/Joblog/Jobsoegning)

• UpdateJoblog (PUT /v1/Joblog/Jobsoegning/{joblogIdentifier})

• CreateJoblog (POST /v1/Joblog/Andenlogning)

• UpdateJoblog (PUT /v1/Joblog/Andenlogning/{joblogIdentifier})

• CreateJoblogDokument (POST /v1/Joblog/dokument)

• UpdateJoblogDokument (PUT /v1/Joblog/dokument/{dokumentIdentifier})

Der tages i valideringen udgangspunkt i UTF8 karaktersættet (som defineret på https://www.utf8-chartable.de/unicode-utf8-table.pl?number=1024 ) og derfor er følgende serier lovlige, med tilhørende undtagelser nedenfor:

• Accepterede tegn: fra og med U+0020 til og med U+007E (tegn, serie 1) 

  • f.o.m. U+00A0 t.o.m. U+02AF (tegn, serie 2) 

  • f.o.m. U+000A t.o.m. U+000D (linjeskift)

• Herfra undtaget: "<" (U+003C) og ">" (U+003E)

Den konkrete udmøntning kan ses i gennemgang af karaktersættet på undersiden 956.11... Implementeret UTF8 charset.

Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

Regler for hvilke målgrupper der skal Joblogge

Metoder

Følgende metoder er forbeholdt borger via Jobnet eller brugervendt a-kasse løsning

Disse metode er rette mod borgeres behandling af sin joblog og sagsbehandler kan/må ikke ikke gøre dette på vegne af borger.

• CreateJoblog (POST /v1/Joblog/Jobsoegning)

• UpdateJoblog (PUT /v1/Joblog/Jobsoegning/{joblogIdentifier})

• CreateJoblog (POST /v1/Joblog/Andenlogning)

• UpdateJoblog (PUT /v1/Joblog/Andenlogning/{joblogIdentifier})

• DeleteJoblog (DELETE /v1/Joblog/{joblogIdentifier})

• UpdateJoblog (PUT /v1/Joblog/Jobsoegning/Status/{joblogIdentifier})

• UpdateJoblog (PUT /v1/Joblog/Andenlogning/Status/{joblogIdentifier})

• CreateJoblogDokument (POST /v1/Joblog/dokument)

• UpdateJoblogDokument (PUT /v1/Joblog/dokument/{dokumentIdentifier}

• DeleteJoblogDokument (Delete /v1/Joblog/dokument/{dokumentIdentifier}/svar/{dokumentIdentifier}))

Følgende metoder kan anvende af alle (borger, jobcentre, a-kasser og anden aktør)

• GetJoblog (GET /v1/Joblog)

• GetJoblog (GET /v1/Joblog/Jobsoegning)

• GetJoblog (GET /v1/Joblog/AndenLogning)

• GetJoblogDokument (GET v1/Joblog/{underretningIdentifier}/dokument/{dokumentId}

• GetJoblog (GET /v1/Joblog/Jobsoegning/Stillinger/{fraTidspunkt})

• GetJoblog (GET /v1/Joblog/Jobsoegning/MaksimumAfstand/{fraTidspunkt})

• GetJoblogSoegning (POST /v1/Joblog/Joblogsoegning)

GetJoblog (GET /v1/Joblog)

Denne metode alle Joblogs for den angivne borger. Der returneres to kollektioner en med jobsøgningsjoblogs og en med anden joblogs.

Forretningsregler

• Joblogs skal/vil være under 4 år gamle pga. GDPR oprydning.

• Der skal der anvendes af fra- og til-periode (fraDato og tilDato) ved kald af metoden. Af hensyn til svartid anbefales det, at der ikke kaldes med uendelige tidsintervaller.

  • Det er aendringstidspunkt, der afgør, om en joblog ligger inden for perioden og kommer med i udtrækket.

GetJoblog (GET /v1/Joblog/Jobsoegning)

Denne metode henter en Joblog af typen Jobsøgning.

Forretningsregler

• Er dokumentet markeret som slettet i DFDG, returneres fejlkode.

GetJoblog (GET /v1/Joblog/AndenLogning)

Denne metode henter en Joblog af typen anden logning.

Forretningsregler

• Er registreringen markeret som slettet i DFDG, returneres en fejlkode.

GetJoblogDokument (GET v1/Joblog/{joblogIdentifier}/dokument/{dokumentId}

Funktion til at hente et specifikt dokument.

Forretningsregler

• Er dokumentet markeret som slettet eller evt. er blevet fjernet fra DFDG returneres fejlkode.

GetJoblogSoegning (POST /v1/Joblog/Joblogsoegning)

Denne metode kan benyttes til at udsøge borgere på baggrund af deres brug af joblog. 

Forretningsregler

• Søgning tager højde for fraværsforhold, der fritager for joblog. Datagrundlaget der anvendes til udsøgning opdateres én gang i døgnet (om natten). Registreringer af fraværsforhold d.d. vil uanset om de har historisk startdato derfor først indgår i datagrundlaget for udsøgning 'i morgen'. For tiden påbegyndes opdateringen af søgedata ca. 04:45 og er færdig omkring en halv time senere, men det kan ikke garanteres, at opdateringen altid kan være klar på dette tidspunkt.

• Der kan udsøges joblogs der oprettet op 180 dage tilbage i tiden.

• A-Kasser kan kun søge på egne medlemmer.

• Jobcentre kan kun søge på egne borgere.

• I søgningen er slutdato tidspunktet implicit kl. 00:00:00 - og derfor inkluderes joblogs for den anførte EndDate reelt ikke i søgningen. Hvis der fx ønskes foretaget en søgning til og med 31. oktober skal EndDate angives til at være 1. november. 

• Ved dato-søgning er startdato og slutdato udtryk for, at der søges på ansøgninger med ansøgningsdato (ansoegelsesdato) i den angivne interval. aendringstidspunktikke anvendes til noget i joblogsøgningen ud over, at feltet kommer med ud i søgeresultatet.

• NumberOfDaysWithJoblogRequired

  • For dagpengemodtagere: ​​​​​​​Antal dage mellem start- og slutdato, hvor tilmeldt som jobsøgende (hvor der i udg. pkt er pligt til at joblogge) (inkl. start- og slutdato) i udsøgningen fratrukket antal dage, hvor borger har været fritaget for at at joblogge. Det kan fx være pga. fravær eller fordi borger ikke har være tilmeldt som jobsøgende hele udsøgningsperioden.

• NumberOfDaysWithExemptionFromJoblog

  • ​​​​​​​Antallet af dage, hvor borger pga. fravær/fritagelser eller afmelding ikke har haft pligt til at joblogge

Det er reelt forretningsreglerne i Fraværs- og fritagelsesvejledningen, der ligger på https://star.dk/it/borger-it/tilmelding-registrering-jobcentret-sygefravaer-fravaer-fritagelser/fravaer-og-fritagelser/vejledninger-fravaer-fritagelser/, der er kodet ind i udsøgningsmotoren 

CreateJoblog (POST /v1/Joblog/Jobsoegning)

Denne metode opretter en Joblog af typen JobSearch.  

Forretningsregler

• Årstal i ansoegelsesdato og ansoegningsfrist skal være 2015 eller senere. Ellers kastes fejlkoderne 9444

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

CreateJoblog (POST /v1/Joblog/Andenlogning)

Denne metode opretter en Joblog af typen anden logning.

Forretningsregler

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

DeleteJoblog (DELETE /v1/Joblog/{joblogIdentifier})

Denne metode sletter en Joblog.

Forretningsregler

• Ingen

UpdateJoblog (PUT /v1/Joblog/Jobsoegning/Status/{joblogIdentifier})

Denne metoder sætter status på en Joblog af typen Jobsøgning.

Forretningsregler

• Sættes status til "Ikke søgt endnu" må ansoegelsesdato ikke være sat.

• Sættes status til andet end "Ikke søgt endnu" skal ansoegelsesdato være sat.

• Datoen må ikke være fremtidig (i så fald kastes fejlkode 9134)

UpdateJoblog (PUT /v1/Joblog/Andenlogning/Status/{joblogIdentifier})

Denne metode sætter status på en Joblog af typen anden logning. Status kan enten sættes til aktiv eller lukket.

Forretningsregler

• Sættes status til "Ikke søgt endnu" må ansoegelsesdato ikke være sat.

• Sættes status til andet end "Ikke søgt endnu" skal ansoegelsesdato være sat.

• Datoen må ikke være fremtidig (i så fald kastes fejlkode 9134)

UpdateJoblog (PUT /v1/Joblog/Jobsoegning/{joblogIdentifier})

Denne metode opdaterer en Joblog af typen Jobsøgning.

Forretningsregler

• Hvis statusPaaJobsoegningslogninger ved opdatering er forskellig fra Ikke søgt (Jobsearch.JobsoegningsstatusIdentifierCodeList= 1) skal nedenstående være opfyldt:

  • ansoegelsesdato skal være udfyldt

  • ansoegelsesdato skal være i fortiden.

  • Årstal i ansoegelsesdato skal være 2015 eller senere. Ellers kastes fejl 9444

  • Årstal i ansoegningsfrist skal være 2015 eller senere. Ellers kastes fejl 9445

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

UpdateJoblog (PUT /v1/Joblog/Andenlogning/{joblogIdentifier})

Denne metode opdaterer en Joblog af typen Anden logning.

Forretningsregler

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

CreateJoblogDokument (POST /v1/Joblog/dokument)

Metode til at oprette et dokument til en borgers Joblog.

Forretningsregler

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

• Filer der kan uploades må max have en størrelse på 1 MB

UpdateJoblogDokument (PUT /v1/Joblog/dokument/{dokumentIdentifier})

Funktion til at opdatere et eksisterende dokument på en Joblog.

Forretningsregler

• Det er ikke nødvendigt at vedhæfte det fysiske dokument såfremt det alene er metadata der skal opdateres - det eksisterende dokument vil ikke blive fjernet. 

• Hvis fjernelse af ugyldige tegn i et joblog-request resulterer i en tom streng, returnerer DFDG en fejlkode - 9443

DeleteJoblogDokument (Delete /v1/Joblog/dokument/{dokumentIdentifier}/svar/{dokumentIdentifier}))

Funktion der slettemarkerer et Joblogdokument ved at sætte dokumentstatus (Jobsearch.DocumentStatusTypeIdentifier (slavekodeliste master skal bo i ekstern kommunikation)) til "Slettet af bruger"

GetJoblog (GET /v1/Joblog/Jobsoegning/Stillinger/{fraTidspunkt})

Denne metode returnerer en liste af stillingsbetegnelser samt et antal for de joblogs af typen jobsøgning borgeren har fortaget fra en dato angivet i servicekaldet.

Forretningsregler

• Beregningen af en joblogs stillingsbetegnelse fortages af BI, der er lagt op til at der bliver beregnet joblogs stillingsbetegnelser 30 dage tilbage.

GetJoblog (GET /v1/Joblog/Jobsoegning/MaksimumAfstand/{fraTidspunkt})

Denne metode returnerer den maksimale kilometerangivelse ud fra de joblogs af typen jobsøgning borgeren har fortaget fra dato angivet i servicekaldet.