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.

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)
• CreateJoblog (POST /v1/Joblog/Andenlogning)
• UpdateJoblog (PUT /v1/Joblog/Jobsoegning/{joblogIdentifier})
• 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})
• DeleteJoblogDokument (Delete /v1/Joblog/dokument/{dokumentIdentifier}/svar/{dokumentIdentifier}))
• CreateJoblogDokument (POST /v1/Joblog/dokument)
• UpdateJoblogDokument (PUT /v1/Joblog/dokument/{dokumentIdentifier}

GetEntries

Denne metode alle Joblogs for den angivne borger. Der returneres to kollektioner en med JobSearch-joblogs og en med OtherActivity-joblogs.

GetJobSearchEntry

Denne metode henter en JoblogEntry af typen JobSearch.

GetOtherEntry

Denne metode henter en JoblogEntry af typen OtherActivity.

GetJoblogDocument

Funktion til at hente et specifikt dokument. Er dokumentet markeret som slettet eller evt. er blevet fjernet fra DFDG returneres fejlkode.

PersonSearch

Denne metode kan benyttes til at udsøge borgere på baggrund af deres brug af joblog. 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 EndDate 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 StartDate og EndDate udtryk for, at der søges på ansøgninger med ansøgningsdato (SubmissionDate) i den angivne interval. LastModifiedDate ikke anvendes til noget i joblogsøgningen ud over, at feltet kommer med ud i søgeresultatet.

NumberOfDaysWithJoblogRequired

For dp.modtagere: ​​​​​​​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 

Metoder

Rettigheder til at kalde servicen

A-kasser kan kun registrere på egne medlemmer

Jobcentre, a-kasser og anden aktør kan anvende følgende metoder:

• GetEntries
  
• GetJobSearchEntry
  
• GetOtherEntry
  
• GetJoblogDocument
  
• GetOccupationsFromJobSearchEntries

Sikkerhedsattributter

Servicen er omlagt til de nye sikkerhedsattributter i 2021-1 - og vil derfor fremgår kaste fejlkode 4575 "You are not authorized", hvis servicen kaldes af en aftagertype, der ikke har rettighed til at kalde den pågældende servicemetode. Der kan evt. tidligere være kastet en mere aftagertype-specifik fejlkode i denne situation.

Datavask / ulovlige tegn strippes

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

• CreateJoblogDocument 
  

• CreateJobSearchEntry 
  

• CreateOtherEntry 
  

• UpdateJoblogDocument
  

• UpdateJobSearchEntry 
  

• UpdateOtherEntryCreateJobSearchEntry

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 "An element in the request contains only invalid characters (see details in InnerException)"

CreateJobSearchEntry 

Denne metode opretter en Joblog af typen JobSearch.  

Årstal i SubmissionDate og SubmissionDeadlineDate skal være 2015 eller senere. Ellers kastes fejlkoderne 9444 "Submission date has to be 2015-01-01 or later" eller 9445 "Submission deadline date has to be 2015-01-01 or later".

CreateOtherEntry

Denne metode opretter en Joblog af typen OtherActivity.

DeleteEntry

Denne metode sletter en Joblog.

GetEntries

Denne metode henter alle Joblogs for den angivne borger, de skal dog være under 4 år gamle. Der returneres to kollektioner, en med JobSearch-joblogs og en med OtherActivity-joblogs.

I version 4 af servicen skal der anvendes af fra- og til-periode (GetEntriesFromDate og GetEntriesToDate) ved kald af metoden. Af hensyn til svartid anbefales det, at der ikke kaldes med uendelige tidsintervaller.

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

GetJobSearchEntry

Denne metode henter en JoblogEntry af typen JobSearch hvis den er under 4 år gammel jf. opdateringsdato (ved joblogs der er ældre end 4 år, svares at de ikke findes - fejlkode 4830 - The JoblogEntry was not found).

GetOtherEntry

Denne metode henter en JoblogEntry af typen OtherActivity hvis den er under 4 år gammel jf. opdateringsdato (ved joblogs der er ældre end 4 år, svares at de ikke findes - fejlkode 4830 - The JoblogEntry was not found).

SetJobSearchEntryStatus

Denne metoder sætter status på JoblogEntry af typen JobSearch. Sættes status til "Ikke søgt endnu" må SubmissionDate ikke være sat. Sættes status til andet end "Ikke søgt endnu" skal SubmissionDate være sat.

Datoen må ikke være fremtidig (i så fald kastes fejlkode 9134 - Submission date is required when latest status for joblog is different from Ikke søgt endnu)

SetOtherEntryStatus

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

UpdateJobSearchEntry

Denne metode opdaterer en JoblogEntry af typen JobSearch.

Hvis JobSearchStatus ved opdatering er forskellig fra Ikke søgt (JobSeekingStatusTypeIdentifier = 1) skal nedenstående være opfyldt:

• Jobsøgningsdato (SubmissionDate) skal være udfyldt
• Jobsøgningsdato (SubmissionDate) skal være i fortiden.
• Årstal i SubmissionDate skal være 2015 eller senere. Ellers kastes fejl 9444 "Submission date has to be 2015-01-01 or later"
• Årstal i SubmissionDeadlineDate skal være 2015 eller senere. Ellers kastes fejl 9445 "Submission deadline date has to be 2015-01-01 or later"

UpdateOtherEntry

Denne metode opdaterer en JoblogEntry af typen OtherActivity.

CreateJoblogDocument

Metode til at oprette et dokument til en borgers JoblogEntry. Filer der kan uploades må max have en størrelse på 1 MB 

CreateTasks

Denne metode kan anvendes til at oprette joblogtasks på en joblog.

DeleteJoblogDocument

Funktion der slettemarkerer et Joblogdokument ved at sætte DocumentStatusTypeIdentifier til "Slettet af bruger"

DeleteTasks

Denne metode kan slette joblogtasks for en joblog. 

GetJoblogDocument

Funktion til at hente et specifikt dokument. Er dokumentet markeret som slettet eller evt. er blevet fjernet fra DFDG returneres fejlkode 

SetTaskStatus

Denne metode skifter status for en task. 

UpdateJoblogDocument

Funktion til at opdatere et eksisterende dokument på en Joblog. 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. 

UpdateTasks

Denne metode kan opdatere joblogtasks for en joblog. 

GetOccupationsFromJobSearchEntries

Metoden er fra og med 2021-2 kun tilgængelig på Version 5 af servicen

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.

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

GetMaximumDistanceInKm

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