CitizenJoblogService (2022-4)

Servicen indeholder metoder som skal anvendes, hvis a-kassen har valgt at udstille den fælles joblog via deres selvbetjeningløsning.

Til sagsbehandler brug i jobcentre og a-kasser kan dog anvendes en række Get-metoder på servicen.

Forretningsbeskrivelse

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.

Per release 2018-1 indføres batch oprydning af gamle Joblog dokumenter.  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   (GetJoblogDocument / UpdateJoblogDocument / DeleteDocument) returneres fejlkode 9301.

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.

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.