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 "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>

Hvis feltet indeholder andre tags, vil jobannoncen blive afvist.

• Øvrige tekstfelter indeholder uformatteret tekst
• Annonceperioden er 8 uger for alle annoncer
• Jobannoncer georeferes 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.

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 anvendt 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 and error updating the jobad
• 1016, PublishJob - wrong status. Expected NotReady or ReadyButNotPublished
• 1017, The user is not allowed to access non published job ad

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
• IsValidJobAd - Forespørger om indholdet i en jobannonce er tilstrækkeligt til at jobannoncen vil kunne sendes til godkendelse og publicering
• PublishJob - Sender en jobannonce til godkendelse og publicering
• 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.

GetJob

Denne metode bruges til at hente jobannonce detaljer

Input

Output

AddJob

Denne metode bruges til at oprette jobannonce på Jobnet. Jobannoncen sendes straks til godkendelse.

Input

Output

UpdateJob

Denne metode bruges til at opdatere eksisterende jobannonce på Jobnet. Jobannoncen sendes til godkendelse. Metoden kan anvendes ved annoncer med tilstande 8 - Not Approved, 9 - PublicationEnd]

Input

Output

CloseJob

Denne metode bruges til at lukke eksisterende jobannoncer på Jobnet således at de ikke længere er søgbare eller kan vises på Jobnet. Metoden kan anvendes ved annoncer med tilstande:6: Processed, 7: Publication

Input

Output

DeleteJob

Denne metode bruges til at slette jobannonce på Jobnet

Input

Output

SearchJob

Denne metode bruges til at fremsøge jobannoncer og se ejerskab og status på disse

Input

Output

SaveJobAsDraft

Denne metode bruges til at oprette eller opdatere en jobannonce der endnu ikke er færdig udfyldt på Jobnet. Annoncen forbliver i aktuel tilstand, dog ændres tilstand fra 1 NotReady til 2 ReadyButNotPublished, når annoncen kan valideres. Mettoden kan anvnedes ved tilstande: 1: Notready, 2: ReadyButNotPublished, 8: NotApproved, 9: PublicationEnd.

For at annoncen kan gemmes som kladde skal der som minimum være angivet: Information om virksomheden (HiringOrganizationDetails) og reference til personen der opretter annoncen (JobAdDetails.PostedBy), Arbejdssted (JobDetails.Joblocation) samt kontaktperson på annoncen (ApplicationDetails.JobcontactList).

Hvis der angives et JobAdId opdateres annoncen med det givne ID. Hvis der ikke angives et JobAdId oprettes en ny annoncen kladde. Jobannoncen har i kladde tilstand Status NotReady (1)

Input

Output

IsValidJobAd

Denne metode bruges til at validere om annoncen er færdig udfyldt

Input

Output

PublishJob

Denne metode bruges til at publisere en annonce efter annoncen er færdig udfyldt

Input

Output

GetTicket

Denne metode bruges til at hente en midlertidig kode til brug for at kunne se en forhåndsvisning af en annonce inden den publiseres

Input

Output