Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Denne integrationsvejledning beskriver hvordan systemer udenfor STAR (Styrelsen for Arbejdsmarked og Rekruttering) kan anvende JobAD webservice til dels at levere jobannoncer til publicering på jobnet.dk, dels til at afhente jobannoncer, der er publiceret på CV webservice, til at hente en borgeres aktuelle CV fra jobnet.dk.

Table of Contents

...

STAR tilbyder en webservice, som sætter eksterne organisationer i stand til dels at levere jobannoncer til jobnet.dk, dels til at hente aktuelt publicerede jobannoncer.

STAR har indtil 2018 udstillet to webservices, JobIn og JobOut, til hhv, at levere jobannoncer til publicering på jobnet.dk og til at afhente jobannoncer, der er publiceret på jobnet.dk. Disse udfases i 2018 og erstattes med den nye JobAD webservice.

Roller

JobAD webservicen tilbyder to hente en borgeres aktuelle CV, når borgere har givet samtykke hertil.

STAR vil fra ultimo 2020 udstillet denne webservices og den vil erstatte hidtidige løsninger der samtidigt vil bliver udfaset.

Roller

CV webservicen tilbyder en roller til systemer udenfor STAR:

  • Levering af jobannoncer til jobnet.dk
  • Afhentning af publicerede jobannoncer aktuelt CV fra jobnet.dk

...

CV snitfladebeskrivelse

Herunder finder du beskrivelse af den tekniske webservicekontrakt (swagger), samt detaljeret beskrivelse af metoder og datafelter i webservicen. Link til snitfladebeskrivelseDet skal bemærkes at snitfladen indeholder alle metoder

For hele cv strukturen se under Get /v1/Cv

Du kan finde forretningsregler for CV webservicen her:

JobAdService

WSDL til JobAD webservice

WSDL'en specificerer teknisk webservicekontrakt til JobAD webservicen.

Du kan finde WSDL'er til testmiljø her: https://jobt1.jobnettest.dk/JobAdService/v2/JobAdService.svc?wsdl

og XSD'er til testmiljø her: https://jobt1.jobnettest.dk/JobAdService/v2/JobAdService.svc?xsd=xsd0

Beskrivelse af metoder og datafelter i JobAD webservice

Du kan finde en beskrivelse af metoder og datafelter i JobAD webservicen her.

Begrænsninger i annoncetyper

...

Du kan finde forretningsbeskrivelse CV her:

Begrænsninger i forhold til CV data

CV webservicen anvendes af flere forskellige systemer, som har forskellige rettigheder i forhold til borgerens CV data.

Systemer uden for STAR kan oprette samme typer (JobAdDetails/Type) af jobannoncerhar sammen adgang til, som arbejdsgivere kan på Jobnet for arbejdsgivere.:

  • Job med almindelige ansættelsevilkår (Normal)
  • Fleksjob for personer med nedsat erhvervsevne (Flexjob)
  • Job for førtidspensionister på særlige vilkår (EarlyRetirement)
  • Job med almindelige ansættelsesvilkår - egnet til efterlønnere (NormalAndEarlyRetiree)
  • Skal annoncen have logoet 'Hotjob', da jobbet er for alle - også uden særlige forudsætninger (HotJob)

Der må ikke anvendes anonyme arbejdsgivere (JobDetails/IsAnonymousEmployer).

Eksempler

Herunder finder du eksempler på kald af webservicen, dels som SOAP requests og response, dels som et C# projekt.

Eksempler på SOAP kald

Fælles for disse eksempler er at [brugernavn] og [adgangskode] skal erstattes med faktiske værdier.

AddJob - opret jobannonce på jobnet.dk

Dette SOAP kald opretter en jobannonce på jobnet.dk. Ved succesfuld oprettelse returneres jobannoncens ID.

Request:

...

  • CV'er der er søgbare
  • CV's indhold
  • Relevant ansættelsesbetingelser

Det er kun muligt at hente CV oplysninger på borger vil GetCVOnToken, der kan f.eks. ikke foretages Cv søgning, opdateres i borgers CV m.v.

Model for integration med eksterne systemer



Processer

Levering af jobannoncer til jobnet.dk

Jobannoncer sendes til publicering på jobnet.dk ved at kalde metoden AddJob med de data, der skal indgå i jobannoncen. Herefter sendes jobannoncen straks til godkendelse.

Hvis jobannoncen godkendes, vil jobannoncen blive publiceret på jobnet.dk på det tidspunkt, der er angivet i jobannoncen, og jobannoncen afpubliceres automatisk, når den angivne publiceringsdato udløber.

Hvis jobannoncen ikke godkendes, vil der blive sendt en e-mail til jobannoncens kontaktperson, der beskriver årsagen til at jobannoncen ikke kunne godkendes. Jobannoncen kan opdateres ved at kalde metoden UpdateJob med revideret indhold og derefter kalde PublishJob.

En jobannonce kan afpubliceres på jobnet.dk ved at kalde CloseJob.

En jobannonce kan slettes fra jobnet.dk ved at kalde DeleteJob.

Arbejdsgivere vil kunne se deres egne (identificeret ved CVR-nummer) jobannoncer på Jobnet for Arbejdsgivere uanset status (godkendt, publiceret, ikke-godkendt mv).

Afhentning af publicerede jobannoncer fra jobnet.dk

Du kan hente alle publicerede jobannoncer på jobnet.dk ved først at fremsøge jobannoncerne ved kald af metoden SearchJob med de ønskede fremsøgningskriterier. Bemærk, at SearchJob anvender paging, dvs. at man skal kalde metoden med fortløbende sidenumre indtil alle jobannoncer er fremsøgt. Man kan hente jobannoncernes indhold ved at kalde GetJob for hver jobannonce med det ID, der er returneret af SearchJob.

Bemærk, at man kun kan fremsøge og hente publicerede jobannoncer, samt at det kun er offentligt tilgængeligt indhold på jobannoncerne, der returnes

Procedure for tilslutning til JobAD webservice

Nye brugere, der er interesseret i at bruge JobAD webservice, skal starte med at kontakte Dorthe Uglebjerg.

Telefon og mail

En indledende afklaring kan foregå via telefon på 72 21 75 77, men processen startes først, når der sendes en mail på DUG@star.dk. I mailen skal det fremgå:

  • Hvem der er den nye kunde, adresse, firmanavn, kontaktperson og kontaktoplysninger
  • Hvilke(en) af de to roller, der ønskes at få adgang til at bruge: Publicering af jobannoncer på jobnet.dk eller Afhentning af publicerede jobannoncer fra jobnet.dk
  • Hvad webservice adgangen skal bruges til, fx visning af job på egen hjemmeside

Efter modtagelse af mail oprettes en intern sag, og webservice supporten får besked om, at give den nye kunde adgang til relevant web-service test-miljø.

Kunden går i gang

Den nye kunde udvikler herefter det software, der skal ende med, at de kan udveksle data med Jobnets webservicer. Udviklingstiden afhænger af de kompetencer og forudsætninger kunden råder over. Styrelsen for Arbejdsmarked og Rekruttering (STAR) udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservicer og viden til rådighed.

Support

Alle nye kunder får fem timers gratis support fra webservice supporten. De fem timer kan bruges i udviklingsperioden og i den efterfølgende drift. Support ud over fem timer skal godkendes af Dorthe Uglebjerg. Hvis det fravælges at betale for yderligere support, faktureres denne support mellem den nye kunde og web-service supporten og er Styrelsen for Arbejdsmarked og Rekruttering (STAR) uvedkommende.

Testmiljø og integrationstest

Du skal have gennemført  integrationstest inden du kan publicere jobannoncer på Jobnet. Integrationstesten gennemføres på et testmiljø, hvor JobAD webservicen har følgende URL: ???.

Du kan fremsøge og vise dine (og andres) jobannoncer på Jobnet i testmiljøet.

Efter test

Testen er velgennemført, når webservice supporten meddeler, at der ingen fejl er i udveksling af data mellem kundens system og test-miljøet.

Dorthe Uglebjerg sender herefter pr. mail en Jobnet-webservice kontrakt, der skal underskrives af den nye kunde og derefter sendes retur med posten til Dorthe Uglebjerg.

Når STAR modtager den underskrevne kopi med posten, åbnes der for drifts-miljøet for den nye kunde.


Eksempler

Herunder finder du eksempler på kald af webservicen, dels som SOAP requests og response, dels som et C# projekt.

Eksempler på SOAP kald

Fælles for disse eksempler er at [brugernavn] og [adgangskode] skal erstattes med faktiske værdier.

AddJob - opret jobannonce på jobnet.dk

Dette SOAP kald opretter en jobannonce på jobnet.dk. Ved succesfuld oprettelse returneres jobannoncens ID.


Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract" xmlns:job2="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:AddJobRequestType>
<job:jobAd>
<job:ApplicationDetails>
<job:CountryCode>DK</job:CountryCode>ApplicationMethods>
<job:MunicipalityId>101</job:MunicipalityId>ApplyOnline>
<job:MunicipalityName>København< <job:Url><![CDATA[https://ssl1.peoplexs.com/Peoplexs22/CandidatesPortalNoLogin/ApplicationForm.cfm?PortalID=2035&VacatureID=929638]]></job:MunicipalityName>Url>
<job:PostalCity>København Ø<</job:PostalCity>ApplyOnline>
<job:PostalCode>2100<</job:PostalCode>ApplicationMethods>
<job:StreetBuildingIdentifier>11</job:StreetBuildingIdentifier>JobContactList>
<job:StreetName>Lyngbyvej</job:StreetName>
<job2:JobContactType>
<job:Email>test@testing.dk</job:AddressStructure>Email>
<job:CvrNumber>35954716</job:CvrNumber>PersonNameStructure>
<job:Name>FØTEX< <job:PersonGivenName>Nora</job:Name>PersonGivenName>
<job:PNumber>1013466951<PersonSurnameName>Malkeko</job:PNumber>PersonSurnameName>
</job:HiringOrganizationDetails>
<job</job:JobAdDetails>PersonNameStructure>
<job:JobPublishDates>
<job:PublishEndDate>2017-11-08T00:00:00.0000000+01:00<Title>HR-teamleder</job:PublishEndDate>Title>
<job:PublishStartDate>2017-09-14T00:00:00.0000000+02:00</job:PublishStartDate> <job2:HidePhoneNumbers>false</job2:HidePhoneNumbers>
</job:JobPublishDates>
<job2:TelephoneNumberStructure>
<job:PostedBy>
<job:Email>fra@test.dk<PrimaryNumber>22334455</job:Email>PrimaryNumber>
<job:PersonNameStructure> </job2:TelephoneNumberStructure>
<job:PersonGivenName>Fætter<</jobjob2:PersonGivenName>JobContactType>
<job:PersonSurnameName>Højben<</job:PersonSurnameName>JobContactList>
</job:PersonNameStructure>ApplicationDetails>
<job:Title>HR-konsulent</job:Title>HiringOrganizationDetails>
<job2:ContactGuid>eef750d1-2bb6-e511-80cc-40f2e9c3d2fc</job1:ContactGuid>
<job:AddressStructure>
<job2<job:PrimaryNumber>87785000<CountryCode>DK</job1job:PrimaryNumber>CountryCode>
</job:PostedBy>
<job:MunicipalityId>101</job:MunicipalityId>
<job:Type>Normal<MunicipalityName>København</job:Type>
MunicipalityName>
<job:PostalCity>København <Ø</job:JobAdDetails>PostalCity>
<job:JobDetails>
PostalCode>2100</job:PostalCode>
<job:AuthorityId>0<StreetBuildingIdentifier>11</job:AuthorityId>StreetBuildingIdentifier>
<job:Classification>StreetName>Lyngbyvej</job:StreetName>
<job:EmploymentType>PermanentJob<</job:EmploymentType>AddressStructure>
<job:IsEuresJob>false<CvrNumber>35954716</job:IsEuresJob>CvrNumber>
<job:IsPublicSectorJob>false<Name>FØTEX</job:IsPublicSectorJob>Name>
<job:IsWorkInDenmarkJob>false<PNumber>1013466951</job:IsWorkInDenmarkJob>PNumber>
</job:Classification>HiringOrganizationDetails>
<job:Description><![CDATA[<p>Som teamkoordinator i Kundeservice refererer du til service- og personalechefen, samt teamlederen. Du bliver ansvarlig for dine egne opgaver relateret til den daglige drift af kasselinje, bager og kundeservice.</p>JobAdDetails>
<job:JobPublishDates>
<job:PublishEndDate>2017-11-08T00:00:00.0000000+01:00</job:PublishEndDate>
<job:PublishStartDate>2017-09-14T00:00:00.0000000+02:00</job:PublishStartDate>
</job:JobPublishDates>
<p>Dine fokusomr&aring;der er optimering af bemanding og driften af kundeservice og kasselinje, hvor du skal sikre den bedste indk&oslash;bsoplevelse for vores kunder.&nbsp;<br /><br /><strong>Dine opgaver</strong></p> <job:PostedBy>
<job:Email>fra@test.dk</job:Email>
<job:PersonNameStructure>
<ul> <job:PersonGivenName>Fætter</job:PersonGivenName>
<li>Du st&aring;r for at planl&aelig;gge og optimere bemandingen - herunder udarbejdelse af bemandingsplaner i vores postbutik og bagerudsalg.</li><job:PersonSurnameName>Højben</job:PersonSurnameName>
</job:PersonNameStructure>
<job:Title>HR-konsulent</job:Title>
<li>Du kommer til at f&oslash;lge op p&aring; driftsrutiner i Kundeservice</li><job2:ContactGuid>eef750d1-2bb6-e511-80cc-40f2e9c3d2fc</job1:ContactGuid>
<job2:PrimaryNumber>87785000</job1:PrimaryNumber>
</job:PostedBy>
<li>Du arbejder med at vedligeholde og videreudvikle vores h&oslash;je serviceniveau</li> <job:Type>Normal</job:Type>
</job:JobAdDetails>
<job:JobDetails>
</ul> <job:AuthorityId>0</job:AuthorityId>
<job:Classification>
<p>I takt med, at du udvikler dig, vil du f&aring; mere og mere ledelsesansvar for afdelingens medarbejdere.<br /><br /> <job:EmploymentType>PermanentJob</job:EmploymentType>
<job:IsEuresJob>false</job:IsEuresJob>
<strong>Kvalifikationer<br /></strong><job:IsPublicSectorJob>false</job:IsPublicSectorJob>
Du er udadvendt, service- og kundeorienteret, og du g&oslash;r dit til at sikre kunden den bedste oplevelse. Du har et stort overblik, en bred viden om service generelt og er en god rollemodel. Dine evner til at samarbejde og kommunikere er i top, og du kan motivere dine kolleger til at yde deres bedste.<br /><br />
<job:IsWorkInDenmarkJob>false</job:IsWorkInDenmarkJob>
</job:Classification>
<job:Description><![CDATA[<p>Som teamkoordinator i Kundeservice refererer du til service- og personalechefen, samt teamlederen. Du bliver ansvarlig for dine egne opgaver relateret til den daglige drift af kasselinje, bager og kundeservice.</p>
<p>Dine <strong>Gode karrieremuligheder<br /></strong>
Vi tilbyder til geng&aelig;ld et sp&aelig;ndende job med gode karrieremuligheder inden for Dansk Supermarked. Varehuset besk&aelig;ftiger ca. 200 medarbejdere, som gl&aelig;der sig til at byde dig velkommen.<br /><br />
<strong>L&oslash;n</strong><br />Efter kvalifikationer.</p>]]>
</job:Description>fokusomr&aring;der er optimering af bemanding og driften af kundeservice og kasselinje, hvor du skal sikre den bedste indk&oslash;bsoplevelse for vores kunder.&nbsp;<br /><br /><strong>Dine opgaver</strong></p>
<ul>
<li>Du st&aring;r for at planl&aelig;gge og optimere bemandingen - herunder udarbejdelse af bemandingsplaner i vores postbutik og bagerudsalg.</li>
<job:HidePhonenumbers>false</job:HidePhonenumbers>
<li>Du kommer til <job:IsAnonymousEmployer>false</job:IsAnonymousEmployer>
<job:IsDisabilityFriendly>false</job:IsDisabilityFriendly>
at f&oslash;lge op p&aring; driftsrutiner i Kundeservice</li>
<job:JobDates>
<li>Du arbejder med at vedligeholde og videreudvikle vores <job:ApplicationDeadlineDate>2017-11-08T00:00:00.0000000+01:00</job:ApplicationDeadlineDate>h&oslash;je serviceniveau</li>
<job:StartAsSoonAsPossible>true</job:StartAsSoonAsPossible></ul>
</job:JobDates>
<job:JobLocation>
<job:Address> <p>I takt med, at du udvikler dig, vil du f&aring; mere og mere ledelsesansvar for afdelingens medarbejdere.<br /><br />
<job:CountryCode>DK</job:CountryCode><strong>Kvalifikationer<br /></strong>
Du <job:MunicipalityId>101</job:MunicipalityId>
<job:MunicipalityName>København</job:MunicipalityName>
<job:PostalCity>København Ø</job:PostalCity>
<job:PostalCode>2100</job:PostalCode>
<job:StreetBuildingIdentifier>11</job:StreetBuildingIdentifier>er udadvendt, service- og kundeorienteret, og du g&oslash;r dit til at sikre kunden den bedste oplevelse. Du har et stort overblik, en bred viden om service generelt og er en god rollemodel. Dine evner til at samarbejde og kommunikere er i top, og du kan motivere dine kolleger til at yde deres bedste.<br /><br />
<strong>Gode karrieremuligheder<br <job:StreetName>Lyngbyvej</job:StreetName>/></strong>
</job:Address>
<job:NoLocalBusinessAddress>false</job:NoLocalBusinessAddress>
</job:JobLocation>
<job:NumberOfPositions>1</job:NumberOfPositions>
<job:OccupationId>1219902</job:OccupationId>Vi tilbyder til geng&aelig;ld et sp&aelig;ndende job med gode karrieremuligheder inden for Dansk Supermarked. Varehuset besk&aelig;ftiger ca. 200 medarbejdere, som gl&aelig;der sig til at byde dig velkommen.<br /><br />
<job:Schedule>
<strong>L&oslash;n</strong><br />Efter kvalifikationer.</p>]]>
<job:DailyWorkTime>
</job:Description>
<job:Day>false<HidePhonenumbers>false</job:Day>HidePhonenumbers>
<job:Evening>false<IsAnonymousEmployer>false</job:Evening>IsAnonymousEmployer>
<job:Night>false<IsDisabilityFriendly>false</job:Night>
IsDisabilityFriendly>
<job:JobDates>
<job:Weekend>false<:ApplicationDeadlineDate>2017-11-08T00:00:00.0000000+01:00</job:Weekend>ApplicationDeadlineDate>
<<job:StartAsSoonAsPossible>true</job:DailyWorkTime>StartAsSoonAsPossible>
<job:WeeklyWorkTimeTypes>PartTime<</job:WeeklyWorkTimeTypes>JobDates>
<job:WorkHour>JobLocation>
<job:Address>
<job:Max>25<CountryCode>DK</job:Max>CountryCode>
<job:Min>20<MunicipalityId>101</job:Min>MunicipalityId>
<<job:MunicipalityName>København</job:WorkHour>MunicipalityName>
< <job:PostalCity>København Ø</job:Schedule>PostalCity>
<job:Title>Teamkoordinator til serviceafdelingen<PostalCode>2100</job:Title>PostalCode>
< <job:StreetBuildingIdentifier>11</job:JobDetails>
StreetBuildingIdentifier>
< <job:StreetName>Lyngbyvej</job:jobAd>StreetName>
</job:AddJobRequestType>Address>
</soapenv:Body>
</soapenv:Envelope>

Påkrævet felter

Det kan være svært at se hvilke felter der påkrævet ud fra requestet. Men følgende felter kræves udfyldt:

<job:JobAdDetails>
   <job:Type>...</job:Type>
</job:JobAdDetails>

<ApplicationDetails>
   <JobContactList>
      <PersonNameStructure>
           <PersonGivenName>...</PersonGivenName>
           <PersonSurnameName>...</PersonSurnameName>
      </PersonNameStructure>
   </JobContactList>
</ApplicationDetails>

<HiringOrganizationDetails>
    <AddressStructure>
       <Contact>
           <PersonNameStructure>
               <PersonGivenName>...</PersonGivenName>
               <PersonSurnameName>...</PersonSurnameName>
           </PersonNameStructure>
       </Contact>
    </AddressStructure>
</HiringOrganizationDetails>

Response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<AddJobResponse xmlns="http://jobnet.af.dk/JobAdService"> <job:NoLocalBusinessAddress>false</job:NoLocalBusinessAddress>
</job:JobLocation>
<job:NumberOfPositions>1</job:NumberOfPositions>
<job:OccupationId>1219902</job:OccupationId>
<job:Schedule>
<job:DailyWorkTime>
<job:Day>false</job:Day>
<job:Evening>false</job:Evening>
<job:Night>false</job:Night>
<job:Weekend>false</job:Weekend>
</job:DailyWorkTime>
<job:WeeklyWorkTimeTypes>PartTime</job:WeeklyWorkTimeTypes>
<job:WorkHour>
<job:Max>25</job:Max>
<job:Min>20</job:Min>
</job:WorkHour>
</job:Schedule>
<job:Title>Teamkoordinator til serviceafdelingen</job:Title>
<AddJobResult>4455828<</AddJobResult>job:JobDetails>
</AddJobResponse>job:jobAd>
</job:AddJobRequestType>
</ssoapenv:Body>
</ssoapenv:Envelope>

SearchJob - søg publicerede jobannoncer

Dette SOAP kald fremsøger aktuelt publicerede jobannonce på jobnet.dk.

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:SearchJobRequestType>
<job:SearchParameters>
<job:CreatedFrom>2001-01-01</job:CreatedFrom>
<job:CreatedTo>2018-01-01</job:CreatedTo>
</job:SearchParameters>
</job:SearchJobRequestType>
</soapenv:Body>
</soapenv:Envelope>

...


Påkrævet felter

Det kan være svært at se hvilke felter der påkrævet ud fra requestet. Men følgende felter kræves udfyldt:

<job:JobAdDetails>
   <job:Type>...</job:Type>
</job:JobAdDetails>

<ApplicationDetails>
   <JobContactList>
      <PersonNameStructure>
           <PersonGivenName>...</PersonGivenName>
           <PersonSurnameName>...</PersonSurnameName>
      </PersonNameStructure>
   </JobContactList>
</ApplicationDetails>

<HiringOrganizationDetails>
    <AddressStructure>
       <Contact>
           <PersonNameStructure>
               <PersonGivenName>...</PersonGivenName>
               <PersonSurnameName>...</PersonSurnameName>
           </PersonNameStructure>
       </Contact>
    </AddressStructure>
</HiringOrganizationDetails>


Response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<AddJobResponse xmlns="http://jobnet.af.dk/JobAdService">
<AddJobResult>4455828</AddJobResult>
</AddJobResponse>
</s:Body>
</s:Envelope>

SearchJob - søg publicerede jobannoncer

Dette SOAP kald fremsøger aktuelt publicerede jobannonce på jobnet.dk.


Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>

<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:SearchJobRequestType>
<job:SearchParameters>
<job:CompanyName>FØTEX</job:CompanyName>
<job:CreatedFrom>2017CreatedFrom>2001-01-01</job:CreatedFrom>
<job:CreatedTo>2018-01-01</job:CreatedTo>
<job:JobAttributes></job:SearchParameters>
<job:JobAttribute>WorkInDenmark<</job:JobAttribute>SearchJobRequestType>
<job:JobAttribute>EURES</job:JobAttribute>
<job:JobAttribute>Foreign</job:JobAttribute>
<job:JobAttribute>State</job:JobAttribute>
</job:JobAttributes></soapenv:Body>
</soapenv:Envelope>


Da dette request potentielt kan levere ganske mange søgeresultater kan man med fordel sætte paging op eller præcisere søgningen med fx JobAttributes.


Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>

<job:Credentials>
<job1:Password>[adgangskode]</jobjob1:SearchParameters>Password>
<job1:Username>[brugernavn]</jobjob1:SearchJobRequestType>Username>
</soapenvjob:Body>Credentials>
</soapenv:Envelope>Header>

...

  <soapenv:Body>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <job:SearchJobRequestType>
<SearchJobResponse xmlns="http://jobnet.af.dk/JobAdService">
<job:SearchParameters>
<SearchJobResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><job:CompanyName>FØTEX</job:CompanyName>
<SearchResult><job:CreatedFrom>2017-01-01</job:CreatedFrom>
<Created>2017-02-14T00:00:00</Created><job:CreatedTo>2018-01-01</job:CreatedTo>
<JobAdId>4410682</JobAdId><job:JobAttributes>
<NumberOfViews>0</NumberOfViews><job:JobAttribute>WorkInDenmark</job:JobAttribute>
<OccupationName i:nil="true"/><job:JobAttribute>EURES</job:JobAttribute>
<PublishedBy i:nil="true"/><job:JobAttribute>Foreign</job:JobAttribute>
<PublishedFrom>9999-12-31T00:00:00</PublishedFrom><job:JobAttribute>State</job:JobAttribute>
<PublishedTo>9999-12-31T00:00:00</PublishedTo></job:JobAttributes>
</job:SearchParameters>
<Status>NotReady<</Status>job:SearchJobRequestType>
</soapenv:Body>
</soapenv:Envelope>


Response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<Title/<SearchJobResponse xmlns="http://jobnet.af.dk/JobAdService">
</SearchResult><SearchJobResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<SearchResult>
<Created>2017-02-14T00:00:00</Created>
<JobAdId>4410850<<JobAdId>4410682</JobAdId>
<NumberOfViews>0</NumberOfViews>
<OccupationName i:nil="true"/>
<PublishedBy i:nil="true"/>
<PublishedFrom>9999-12-31T00:00:00</PublishedFrom>
<PublishedTo>9999-12-31T00:00:00</PublishedTo>
<Status>NotReady</Status>
<Title/>
</SearchResult>
</SearchJobResult>
<SearchResult>
</SearchJobResponse>
</s:Body>
</s:Envelope>

GetJob - hent jobannonce

Dette SOAP kald henter en jobannonce, som er fremsøgt i listen herover

[id] skal erstattes med et kendt JobAdId.

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>
<job:Credentials>
<job1:Password>[adgangskode]</job1:Password> <Created>2017-02-14T00:00:00</Created>
<JobAdId>4410850</JobAdId>
<NumberOfViews>0</NumberOfViews>
<OccupationName i:nil="true"/>
<PublishedBy i:nil="true"/>
<PublishedFrom>9999-12-31T00:00:00</PublishedFrom>
<PublishedTo>9999-12-31T00:00:00</PublishedTo>
<job1:Username>[brugernavn]</job1:Username>
<<Status>NotReady</job:Credentials>Status>
</soapenv:Header>
<soapenv:Body>
<job:GetJobRequestType>
<Title/>
<job:JobAdId>[id]</job:JobAdId>SearchResult>
</job:GetJobRequestType>SearchJobResult>
</soapenvSearchJobResponse>
</s:Body>
</soapenvs:Envelope>

Response:

<s

GetJob - hent jobannonce

Dette SOAP kald henter en jobannonce, som er fremsøgt i listen herover

[id] skal erstattes med et kendt JobAdId.


Request:

<soapenv:Envelope xmlns:ssoapenv="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetJobResponseType xmlnsxmlns:job="http://jobnet.af.dk/JobAdService">
<JobAd xmlns:ijob1="http://wwwschemas.w3datacontract.org/2004/2001/XMLSchema-instance07/JobAdService.DataContract">
<soapenv:Header>

<ApplicationDetails><job:Credentials>
<ApplicationMethods><job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
<ApplyByEmail></job:Credentials>
<Email>test@igen.dk</Email></soapenv:Header>
<soapenv:Body>
<job:GetJobRequestType>
<job:JobAdId>[id]</ApplyByEmail>job:JobAdId>
<ApplyByLetter>false</ApplyByLetter>
</job:GetJobRequestType>
</soapenv:Body>
</soapenv:Envelope>


Response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetJobResponseType xmlns="http://jobnet.af.dk/JobAdService">
<ApplyByTelephone>
<JobAd xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<TelephoneNumber>33445566</TelephoneNumber><ApplicationDetails>
<ApplicationMethods>
</ApplyByTelephone>
<ApplyByEmail>
<ApplyOnline i:nil="true"/>
<<Email>test@igen.dk</ApplicationMethods>Email>
<Description i:nil="true"/>
</ApplyByEmail>
<JobContactList xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract"> <ApplyByLetter>false</ApplyByLetter>
<a:JobContactType><ApplyByTelephone>
<Email>test@mer.dk<<TelephoneNumber>33445566</Email>TelephoneNumber>
<PersonNameStructure></ApplyByTelephone>
<PersonGivenName>Anders</PersonGivenName>
<ApplyOnline i:nil="true"/>
</ApplicationMethods>
<PersonSurnameName>And</PersonSurnameName>
<Description i:nil="true"/>
</PersonNameStructure><JobContactList xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<Title>Entreprenør</Title><a:JobContactType>
<a:HidePhoneNumbers>false</a:HidePhoneNumbers><Email>test@mer.dk</Email>
<a:TelephoneNumberStructure><PersonNameStructure>
<MobileNumber<PersonGivenName>Anders</>PersonGivenName>
<PrimaryNumber>55667788<<PersonSurnameName>And</PrimaryNumber>PersonSurnameName>
<SecondaryNumber</>PersonNameStructure>
<Telefax>55667789<<Title>Entreprenør</Telefax>Title>
<<a:HidePhoneNumbers>false</a:TelephoneNumberStructure>HidePhoneNumbers>
</a:JobContactType> <a:TelephoneNumberStructure>
</JobContactList>
<Referral>Karsten Elbæk</Referral><MobileNumber/>
</ApplicationDetails>
<HiringOrganizationDetails><PrimaryNumber>55667788</PrimaryNumber>
<AddressStructure>
<SecondaryNumber/>
<CountryCode>DK</CountryCode>
<Telefax>55667789</Telefax>
<FloorIdentifier/>
<MunicipalityId>360<</MunicipalityId>a:TelephoneNumberStructure>
<MunicipalityName>Lolland<</MunicipalityName>a:JobContactType>
<PostalCity>Maribo<</PostalCity>JobContactList>
<Referral>Karsten <PostalCode>4930<Elbæk</PostalCode>Referral>
</ApplicationDetails>
<StreetBuildingIdentifier>7</StreetBuildingIdentifier>
<HiringOrganizationDetails>
<StreetName>V Henriksens Vej</StreetName><AddressStructure>
<SuiteIdentifier<CountryCode>DK</>CountryCode>
< <FloorIdentifier/AddressStructure>>
<BranchCode i:nil="true"/>
<MunicipalityId>360</MunicipalityId>
<BranchDescription i:nil="true"/> <MunicipalityName>Lolland</MunicipalityName>
<Contact xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract"> <PostalCity>Maribo</PostalCity>
<Email>mne@mne.dk</Email><PostalCode>4930</PostalCode>
<PersonNameStructure><StreetBuildingIdentifier>7</StreetBuildingIdentifier>
<StreetName>V <PersonGivenName i:nil="true"/>
Henriksens Vej</StreetName>
<PersonSurnameName i:nil="true"<SuiteIdentifier/>
</PersonNameStructure>AddressStructure>
<Title<BranchCode i:nil="true"/>
<BranchDescription <a:PrimaryNumber>55667788</a:PrimaryNumber>i:nil="true"/>
<Contact <a:SecondaryNumber i:nil="true"/xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract">
<a:Telefax>55667789</a:Telefax><Email>mne@mne.dk</Email>
</Contact>
<PersonNameStructure>
<CvrNumber>24212254</CvrNumber>
<PersonGivenName i:nil="true"/>
<Name>M.N. Entreprise A/S</Name>
<PNumber>1006412573</PNumber><PersonSurnameName i:nil="true"/>
<Url </>PersonNameStructure>
</HiringOrganizationDetails><Title i:nil="true"/>
<Id>1188921</Id>
<a:PrimaryNumber>55667788</a:PrimaryNumber>
<JobAdDetails>
<JobPublishDates><a:SecondaryNumber i:nil="true"/>
<LastModifiedDate>2007-12-13T16:47:32.05</LastModifiedDate>
<a:Telefax>55667789</a:Telefax>
</Contact>
<PublishEndDate>2017-09-10T00:00:00</PublishEndDate><CvrNumber>24212254</CvrNumber>
<Name>M.N. <PublishStartDate>2017-08-02T00:00:00</PublishStartDate>Entreprise A/S</Name>
<<PNumber>1006412573</JobPublishDates>PNumber>
<NumberOfReadsByCitizen>504<<Url/NumberOfReadsByCitizen>>
</HiringOrganizationDetails>
<PostedBy i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract"/> <Id>1188921</Id>
<Status>PublicationEnd</Status><JobAdDetails>
<Type>Normal</Type><JobPublishDates>
</JobAdDetails>
<LastModifiedDate>2007-12-13T16:47:32.05</LastModifiedDate>
<JobDetails>
<PublishEndDate>2017-09-10T00:00:00</PublishEndDate>
<AuthorityId>0</AuthorityId>
<AuthorityPhoneNumber/><PublishStartDate>2017-08-02T00:00:00</PublishStartDate>
<Classification></JobPublishDates>
<EmploymentType>PermanentJob<<NumberOfReadsByCitizen>504</EmploymentType>NumberOfReadsByCitizen>
<IsEuresJob>false</IsEuresJob><PostedBy i:nil="true" xmlns:a="http://schemas.datacontract.org/2004/07/JobAdService.v1.DataContract"/>
<IsPublicSectorJob>false<<Status>PublicationEnd</IsPublicSectorJob>Status>
<<Type>Normal</Classification>Type>
</JobAdDetails>
<Description>Tømrersvende søges til selvstændigt arbejde. kunne<JobDetails>
tale og forstå dansk. Henvendelse til Karsten Elbæk på tlf. 20826213 eller Martin Nielsen tlf. 25377500.</Description> <AuthorityId>0</AuthorityId>
<DriversLicences<AuthorityPhoneNumber/>
<HidePhonenumbers>false</HidePhonenumbers><Classification>
<IsAnonymousEmployer>false< <EmploymentType>PermanentJob</IsAnonymousEmployer>EmploymentType>
<IsDisabilityFriendly>false< <IsEuresJob>false</IsDisabilityFriendly>IsEuresJob>
<JobDates>
<IsPublicSectorJob>false</IsPublicSectorJob>
<ApplicationDeadlineDate>2017-09-10T00:00:00</ApplicationDeadlineDate></Classification>
<Description>Tømrersvende søges <EmploymentDate i:nil="true"/>
<StartAsSoonAsPossible>true</StartAsSoonAsPossible>
</JobDates>til selvstændigt arbejde. Må kunne tale og forstå dansk. Henvendelse til Karsten Elbæk på tlf. 20826213 eller Martin Nielsen tlf. 25377500.</Description>
<JobLocation><DriversLicences/>
<HidePhonenumbers>false</HidePhonenumbers>
<Address>
<IsAnonymousEmployer>false</IsAnonymousEmployer>
<CountryCode>DK</CountryCode>
<IsDisabilityFriendly>false</IsDisabilityFriendly>
<JobDates>
<ApplicationDeadlineDate>2017-09-10T00:00:00</ApplicationDeadlineDate>
<FloorIdentifier <EmploymentDate i:nil="true"/>
<StartAsSoonAsPossible>true</StartAsSoonAsPossible>
<MunicipalityId>360</MunicipalityId>
</JobDates>
<MunicipalityName>Lolland</MunicipalityName>
<JobLocation>
<PostalCity i:nil="true"/> <Address>
<PostalCode i:nil="true"/><CountryCode>DK</CountryCode>
<StreetBuildingIdentifier<FloorIdentifier i:nil="true"/>
<StreetName i:nil="true"/><MunicipalityId>360</MunicipalityId>
<MunicipalityName>Lolland</MunicipalityName>
<SuiteIdentifier<PostalCity i:nil="true"/>
</Address> <PostalCode i:nil="true"/>
<NoLocalBusinessAddress>false</NoLocalBusinessAddress> <StreetBuildingIdentifier i:nil="true"/>
</JobLocation>
<StreetName i:nil="true"/>
<NumberOfPositions>3</NumberOfPositions>
<OccupationId>7115101</OccupationId><SuiteIdentifier i:nil="true"/>
<Schedule> </Address>
<NoLocalBusinessAddress>false</NoLocalBusinessAddress>
</JobLocation>
<NumberOfPositions>3</NumberOfPositions>
<OccupationId>7115101</OccupationId>
<Schedule>
<DailyWorkTime>
<Day>false</Day>
<Evening>false</Evening>
<Night>false</Night>
<Weekend>false</Weekend>
</DailyWorkTime>
<WeeklyWorkTimeTypes>FullTime</WeeklyWorkTimeTypes>
<WorkHour>
</WorkHour>
</Schedule>
<Title>Tømrer/Snedkere søges</Title>
</JobDetails>
</JobAd>
</GetJobResponseType>
</s:Body>
</s:Envelope>

Fejlkoder

Dette SOAP kald returnerer en fejlkode på grund af valideringsfejl. Se oversigt over fejlkoder her

Eksempel på kald med ugyldigt JobAdID.


Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:job="http://jobnet.af.dk/JobAdService" xmlns:job1="http://schemas.datacontract.org/2004/07/JobAdService.DataContract">
<soapenv:Header>

<job:Credentials>
<job1:Password>[adgangskode]</job1:Password>
<job1:Username>[brugernavn]</job1:Username>
</job:Credentials>
</soapenv:Header>
<soapenv:Body>
<job:GetJobRequestType>
<job:JobAdId>42</job:JobAdId>
</job:GetJobRequestType>
</soapenv:Body>
</soapenv:Envelope>


Response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<s:Fault>
<faultcode>s:Client</faultcode>
<faultstring xml:lang="en-US">JobAd exception when calling GetJob method. Details: The job with id 42 could not be found</faultstring>
<detail>
<JobAdFault xmlns="http://jobnet.af.dk/JobAdService" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Code>JobAdNotFound</Code>
<Message>JobAd exception when calling GetJob method. Details: The job with id 42 could not be found</Message>
</JobAdFault>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>

Eksempel i C#

Her vises et eksempel hvordan et kald til JobAdService skabes med C#. Her er vist et kald til hhv. funktionen GetJob og SearchJob.

private void GetJob()
{
    JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
    JobAd jobb = jobAdService.GetJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, 4534569);
    Console.WriteLine(jobb);

}

private void SearchJob()
{
   JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
   SearchParameters sp = new SearchParameters();
   sp.CreatedFrom = DateTime.Now.AddDays(-400);
   sp.CreatedTo = DateTime.Now;
   sp.PageSize = 10;
   sp.PageNumber = 0;
   sp.Status = Status.Publication;
   sp.JobAttributes = new JobAttribute[] { JobAttribute.EURES };
   SearchResult[] jobs = jobAdService.SearchJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, sp);
   Console.WriteLine(jobs);

}

Her kan du se en demo console application i c#.

View file
nameTestJobAd.zip
height250

Processer

Levering af jobannoncer til jobnet.dk

Jobannoncer sendes til publicering på jobnet.dk ved at kalde metoden AddJob med de data, der skal indgå i jobannoncen. Herefter sendes jobannoncen straks til godkendelse.

Hvis jobannoncen godkendes, vil jobannoncen blive publiceret på jobnet.dk på det tidspunkt, der er angivet i jobannoncen, og jobannoncen afpubliceres automatisk, når den angivne publiceringsdato udløber.

Hvis jobannoncen ikke godkendes, vil der blive sendt en e-mail til jobannoncens kontaktperson, der beskriver årsagen til at jobannoncen ikke kunne godkendes. Jobannoncen kan opdateres ved at kalde metoden UpdateJob med revideret indhold og derefter kalde PublishJob.

En jobannonce kan afpubliceres på jobnet.dk ved at kalde CloseJob.

En jobannonce kan slettes fra jobnet.dk ved at kalde DeleteJob.

Arbejdsgivere vil kunne se deres egne (identificeret ved CVR-nummer) jobannoncer på Jobnet for Arbejdsgivere uanset status (godkendt, publiceret, ikke-godkendt mv).

Afhentning af publicerede jobannoncer fra jobnet.dk

Du kan hente alle publicerede jobannoncer på jobnet.dk ved først at fremsøge jobannoncerne ved kald af metoden SearchJob med de ønskede fremsøgningskriterier. Bemærk, at SearchJob anvender paging, dvs. at man skal kalde metoden med fortløbende sidenumre indtil alle jobannoncer er fremsøgt. Man kan hente jobannoncernes indhold ved at kalde GetJob for hver jobannonce med det ID, der er returneret af SearchJob.

Bemærk, at man kun kan fremsøge og hente publicerede jobannoncer, samt at det kun er offentligt tilgængeligt indhold på jobannoncerne, der returnes

Procedure for tilslutning til JobAD webservice

Nye brugere, der er interesseret i at bruge JobAD webservice, skal starte med at kontakte Dorthe Uglebjerg.

Telefon og mail

En indledende afklaring kan foregå via telefon på 72 21 75 77, men processen startes først, når der sendes en mail på DUG@star.dk. I mailen skal det fremgå:

  • Hvem der er den nye kunde, adresse, firmanavn, kontaktperson og kontaktoplysninger
  • Hvilke(en) af de to roller, der ønskes at få adgang til at bruge: Publicering af jobannoncer på jobnet.dk eller Afhentning af publicerede jobannoncer fra jobnet.dk
  • Hvad webservice adgangen skal bruges til, fx visning af job på egen hjemmeside

Efter modtagelse af mail oprettes en intern sag, og webservice supporten får besked om, at give den nye kunde adgang til relevant web-service test-miljø.

Kunden går i gang

Den nye kunde udvikler herefter det software, der skal ende med, at de kan udveksle data med Jobnets webservicer. Udviklingstiden afhænger af de kompetencer og forudsætninger kunden råder over. Styrelsen for Arbejdsmarked og Rekruttering (STAR) udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservicer og viden til rådighed.

Support

Alle nye kunder får fem timers gratis support fra webservice supporten. De fem timer kan bruges i udviklingsperioden og i den efterfølgende drift. Support ud over fem timer skal godkendes af Dorthe Uglebjerg. Hvis det fravælges at betale for yderligere support, faktureres denne support mellem den nye kunde og web-service supporten og er Styrelsen for Arbejdsmarked og Rekruttering (STAR) uvedkommende.

Testmiljø og integrationstest

Du skal have gennemført  integrationstest inden du kan publicere jobannoncer på Jobnet. Integrationstesten gennemføres på et testmiljø, hvor JobAD webservicen har følgende URL: ???.

Du kan fremsøge og vise dine (og andres) jobannoncer på Jobnet i testmiljøet.

Efter test

Testen er velgennemført, når webservice supporten meddeler, at der ingen fejl er i udveksling af data mellem kundens system og test-miljøet.

Dorthe Uglebjerg sender herefter pr. mail en Jobnet-webservice kontrakt, der skal underskrives af den nye kunde og derefter sendes retur med posten til Dorthe Uglebjerg.

...

Message>
</JobAdFault>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>

Eksempel i C#

Her vises et eksempel hvordan et kald til JobAdService skabes med C#. Her er vist et kald til hhv. funktionen GetJob og SearchJob.

private void GetJob()
{
    JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
    JobAd jobb = jobAdService.GetJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, 4534569);
    Console.WriteLine(jobb);

}

private void SearchJob()
{
   JobAddServiceClient jobAdService = new JobAddServiceClient("IJobAddService");
   SearchParameters sp = new SearchParameters();
   sp.CreatedFrom = DateTime.Now.AddDays(-400);
   sp.CreatedTo = DateTime.Now;
   sp.PageSize = 10;
   sp.PageNumber = 0;
   sp.Status = Status.Publication;
   sp.JobAttributes = new JobAttribute[] { JobAttribute.EURES };
   SearchResult[] jobs = jobAdService.SearchJob(new Credentials { Username = [brugernavn], Password = [adgangskode] }, sp);
   Console.WriteLine(jobs);

}

Her kan du se en demo console application i c#.

View file
nameTestJobAd.zip
height250


Child pages (Children Display)