JobAdService [Erstattes ifm release 2023-3 af ny JobAnnonceService]

VersionTilføjetFjernetKommentar
1

2015-4
Version 1 har status "deprecated". Systemer skal migrere til version 2, da version 1 vil blive slettet fra og med release 2019-4.
22018-2

Nuværende version. Udgår 11/06/21.

32021-2

Idriftsættes 11/06/21 og og erstatter samtidig version 2. Anvender ESCO-STAR klassifikation i stedet for DISCOAMS.



2023-3
Service har status "deprecated". Alle bruger adgange lukket



Forretningsbeskrivelse

JobAd service indeholder metoder, som understøtter følgende:

  • Indberetning af jobannoncer, som skal publiceres på jobnet.dk i ét webservicekald

  • Interaktiv indberetning af jobannoncer (opret kladde, opdater løbende, send til godkendelse og publicering)

  • Fremsøg jobannoncer

  • Hent jobannonce

Forretningsregler

  • Feltet "JobAd/JobDetails/Description" indeholder HTML tekst (encodes med CDATA), hvor følgende tags er tilladt:

    • <b>, <i>, <u>, <br>, <li>, <p>, <small>, <big>, <em>, <strong>, <sub>, <sup>, <ul>, <ol>, <a>

Hvis feltet indeholder andre tags, vil jobannoncen blive afvist.

For <a> tags, vil der ikke blive valideret hvilke attributter, der er påført men på Jobnet vil kun 'href' attributten blive brugt, grundet sikkerheds- og forretningshensyn.

Links indsættes med <a href> tag, fx "<a href="http://dr.dk">Danmarks Radio</a>" (Tidligere understøttede JobAD URL'er direkte i teksten, men de bør undgås, idet URL parametre ikke kan behandles konsistent). 

  • Øvrige tekstfelter indeholder uformatteret tekst

  • Annonceperioden er 8 uger for alle annoncer

  • Jobannoncer georefereres til visning på kort, hvis muligt

Vedr.CountryCode: Grønland har CountryCode "GL" og ikke "DK".

Type (JobAdType) skal være udfyldt. "Nothing" må ikke anvendes.

Ikke-anonyme jobannoncer skal indeholde både CVR-nummer og P-nummer (JobAD version 3 fra 11/06/21).

WorkInDenmark job (IsWorkInDenmarkJob) kan ikke være Hotjob (Type).

For annoncer der skal publiceres på Eures gælder følgende forretningsregler (fra 11/06/18)

  • Annoncen skal have CVR-nummer på arbejdsgiveren
  • Arbejdslokationen skal være i et land, der er medlem af Eures
  • Arbejdsgiveren kan ikke være anonym

For arbejdstimer gælder følgende forretningsregler (fra 11/06/18)

  • Arbejdstimer må kun angives hvis PartTime er valgt i WeeklyWorkTimeTypes

  • Hvis der er angivet et minimum skal der angives et maksimum og vice versa
  • Min skal være mindre end eller lig Max. Min skal ligge i intervallet 0 til 36. Min skal ligge i intervallet 1 til 36. (JobAD version 3 fra 11/06/21)

Jobannoncer slettes automatisk 12 måneder efter at de senest har været aktive. 

Roller og rettigheder

JobAD service understøtter følgende roller:

  • Jobcenter - Jobkonsulenter på jobcentre kan indberette jobannoncer for arbejdsgivere m.fl. Fx ved at anvende Jobkon

  • Star - STARs supportmedarbejdere kan administrere jobannoncer. Fx ved at anvende Jobkon

  • Employer - Arbejdsgivere kan indberette egne jobannoncer ved anvende JobAG

  • Other - JobAD kan anvendes som ekstern snitflade af arbejdsgivere, jobportaler mv. til integration med deres egne applikationer. De kan kun administrere egne jobannoncer

  • UnemploymentFund - Jobkonsulenter på a-kasser kan indberette jobannoncer for arbejdsgivere m.fl. Fx ved at anvende Jobkon

  • JobAdRequester - JobAD kan anvendes som snitflade af fx jobportaler til at hente publicerede jobannoncer. Kun offentligt tilgængelige data returneres.

FejlKoder

  • 1000, General error when calling JobAd Service.

  • 1001, The username/password does not have access to the service

  • 1002, The username/password does not have access to the service operation

  • 1003, The username/password does not have access to the job ad type

  • 1004, The username/password does not have access to work with anonymous jobs

  • 1005, The cvr is blocked on Jobnet

  • 1006, The JobCenter CVR(from the UserRid) was not found

  • 1007, User doesn't have access to modify the specified jobad

  • 1008, Provide either UserRid or ContactId not both

  • 1009, UserRid could not be found

  • 1010, ContactId is could not be found

  • 1011, No statistics found for the job ad

  • 1012, Validation failed. Se details in the Detail.Message property

  • 1013, The job ad was not found

  • 1014, The job id has to be provided

  • 1015, There was an error updating the jobad

  • 1016, PublishJob - wrong status. Expected NotReady or ReadyButNotPublished

  • 1017, The user is not allowed to access non published job ad

  • 1018, Authorization for the request was not granted 

Metoder

  • GetJob - Returnerer jobannonce

  • AddJob - Indberetter en jobannonce, som straks sendes til godkendelse og publicering på jobnet.dk 

  • UpdateJob - Opdaterer indholdet på en jobannonce, som ikke er blevet godkendt til publicering. Jobannoncen sendes ikke automatisk til godkendelse og publicering.

  • CloseJob - Afslutter publicering af en jobannonce på jobnet.dk

  • DeleteJob - Sletter en jobannonce

  • SearchJob - Fremsøger jobannoncer ved at angive søgekriterier

  • SaveJobAsDraft - Gemmer en jobannonce i kladdetilstand. Anvendes ved interaktiv oprettelse af jobannoncer. Jobannoncen sendes ikke til godkendelse og publicering. Kun til STAR's egne systemer.

  • IsValidJobAd - Forespørger om indholdet i en jobannonce er tilstrækkeligt til at jobannoncen vil kunne sendes til godkendelse og publicering. Kun til STAR's egne systemer.

  • PublishJob - Sender en jobannonce til godkendelse og publicering. Kun til STAR's egne systemer.

  • GetTicket - Ticket til preview af jobannonce inden publicering. Kun til STAR's egne systemer.

Tilstande

Diagrammet herunder viser jobannoncernes mulige tilstande, samt hvordan JobAD servicens metoder kan anvendes afhængig af tilstande.

OBS! Tilstand 2 (ReadyButNotPublished) er ikke understøttet. Tilstand 1 repræsenterer kladde uanset om annoncen kan publiceres eller ej.

Link til snitfladebeskrivelse JobAdService (Version 2, 2018-2)