| Table of Contents |
|---|
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 medlemmerHvis 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
Kontaktgruppe | Personkategori | Klientkatagori | Tilmeldt | Fravær der fritager | JoblogPersonSearchTargetGroupTypeIdentifier |
|---|---|---|---|---|---|
Dagpengemodtagere (1) | N/A | Dagpengemodtager (1) | Ja | 2, 3, 4, 10, 11, 18, 24, 43, 44, 45, 46, 47, 66, 70, 71, 73, 74, 77, 78, 79, 80 | Dagpengemodtagere (1) |
Kontanthjælpsmodtager (2) | Jobparat (4) | Kontanthjælpsmodtager (2) | Ja | 2, 3, 4, 6, 7, 8, 10, 11, 12, 13, 18, 19, 20, 21, 43, 44, 45, 46, 47, 52, 61, 70, 71, 73, 76, 77, 78, 79, 80 | Jobparate kontanthjælpsmodtagere (2) |
Fleksjobvisiteret (7) | N/A | N/A | N/A | 3, 4, 8, 10, 11, 13, 19, 20, 21, 22, 24, 41, 43, 45, 46, 47, 51, 52, 61, 70, 71, 73, 77, 78, 79, 80 | Fleksjobvisiterede (3) |
Kontanthjælpsmodtager omfattet af integrationsprogrammet (3) | Jobparat (4) | Kontanthjælpsmodtager i integrationsprogram (7) | Ja | 3, 4, 8, 10, 11, 12, 13, 18, 19, 20, 43, 44, 45, 46, 52, 61, 70, 71, 73, 77, 79, 80 | Jobparate kontanthjælpsmodtagere af integr. (4) |
Modtager af uddannelseshjælp (12) | Åbenlyst uddannelsesparat (6) | N/A | Ja | 2, 3, 4, 6, 7, 8, 10, 11, 12, 13, 18, 19, 20, 21, 45, 46, 47, 52, 61, 70, 71, 73, 76, 78, 79, 80 | Åbenlyst uddannelsesparate (5) |
Overgangsydelsesmodtager efter LAB (26) | Jobparat (4) | N/A | Ja | 2, 3, 4, 6, 7, 8, 10, 11, 12, 13, 18, 19, 20, 21, 43, 44, 45, 46, 47, 52, 61, 70, 71, 73, 76, 77, 78, 79, 80 | Jobparate overgangsydelsesmodtager efter LAB (6) |
Selvforsørgelse-og hjemrejseydelsesmodtager efter INL (27) | Jobparat (4) | N/A | Ja | 3, 4, 8, 10, 11, 12, 13, 18, 19, 20, 43, 44, 45, 46, 47, 51, 52, 61, 64, 70, 71, 73, 77, 78, 79, 80 | Jobparate selvforsørgelses- og hjemsendelsesmodtagere efter INL (7) |
Uddannelsespålæg - Overgangsydelsesmodtager efter LAB (28) | Åbenlyst uddannelsesparat (6) | N/A | Ja | 2, 3, 6, 7, 4, 8, 10, 11, 12, 13, 18, 19, 20, 21, 45, 46, 47, 52, 61, 70, 71, 73, 76, 78, 79, 80 | Åbenlyst uddannelsesparat med uddannelsespålæg - Overgangsydelsesmodtagere efter LAB (8) |
Overgangsydelsesmodtager efter INL (29) | Jobparat (4) | N/A | Ja | 3, 4, 8, 10, 11, 12, 13, 18, 19, 20, 43, 44, 45, 46, 47, 52, 61, 64, 70, 71, 73, 77, 78, 79, 80 | Jobparate overgangsydelsesmodtagere efter INL (9) |
Link til snitfladebeskrivelser
| Child pages (Children Display) | ||
|---|---|---|
|
Link til forretningsbeskrivelser
| Search Results | ||||||
|---|---|---|---|---|---|---|
|
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. XXXX skal afklares om dette skal med
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
Ingen
GetJoblog (GET /v1/Joblog/AndenLogning)
Denne metode henter en Joblog af typen anden logning.
Forretningsregler
Ingen
GetJoblogDokument (GET v1/Joblog/{underretningIdentifier}/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 (JobserachJobsearch.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.