Version | Tilføjet | Fjernet | Kommentar |
---|---|---|---|
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. | |
2 | 2018-2 | Nuværende version. Udgår 11/06/21. | |
3 | 2021-2 | Idriftsættes 11/06/21 og og erstatter samtidig version 2. Anvender ESCO-STAR klassifikation i stedet for DISCOAMS. |
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)