Developer Hub » Vacatures plaatsen via XML » Documentatie » Uitleg XML-schema
Stap 1: Algemene informatie · Stap 2: Uitleg XML-schema · Stap 3: Validatie · Stap 4: Aanmelden
Uitleg XML-schema
Om te beginnen kun je een voorbeeld downloaden. Hopelijk wordt het snel duidelijk waar je welke gegevens moet invullen. Toch gaan we uitgebreid elk element bespreken en uitleggen hoe je het hoort te gebruiken. Je kunt ook altijd het XML-schema (XSD) downloaden.
Met PHP, Java of een andere programmeertaal is het mogelijk om een XML-document te genereren. Bekijk eens het PHP-voorbeeld.
Verplichte velden
Slechts enkele elementen zijn verplicht in te vullen. Als een element verplicht is, staat dit aangegeven bij het betreffende element.
Alle velden uitgelegd
Ieder XML-bestand begint als volgt. Zorg ervoor dat je de juiste encoding invult.
<?xml version="1.0" encoding="UTF-8" ?>jobs verplicht
Dit hoofdelement bevat de lijst met alle vacatures. Het is erg belangrijk om de correcte versie in te vullen. Momenteel wordt alleen gebruik gemaakt van versie
1.0.
<jobs version="1.0">job verplicht
Dit subelement van jobs definieert één enkele vacature. jobs bevat net zoveel job-elementen als dat er vacatures zijn.
<jobs version="1.0">
<job>(...)</job>
<job>(...)</job>
</jobs>Hieronder staan de elementen die binnen job geplaatst dienen te worden.
jobId verplicht
Hier moet een uniek id voor iedere vacature worden ingevuld. Je kunt hier bijv. het id van de vacature in de database invullen of het vacaturenummer, zolang het maar uniek is. Voorkom dat id's in de toekomst worden hergebruikt.
<jobId>
<![CDATA[
6489
]]>
</jobId>alternativeJobId
Soms zijn er voor een vacature meerdere id's (meestal voor verschillende systemen), of heb je een apart referentienummer. Dan kun je dat hier invullen.
<alternativeJobId>
<![CDATA[
TECH-076
]]>
</alternativeJobId>jobAddedDate verplicht
De datum waarop de vacature is toegevoegd in jullie systeem. Gebruik het formaat YYYY-MM-DD.
<jobAddedDate>
<![CDATA[
2008-04-23
]]>
</jobAddedDate>hotJob
Je kunt hotJob gebruiken als je een overeenkomst hebt met Uitzendbureau.nl voor topvacatures. Voor meer informatie over de mogelijkheden van topvacatures
kun je contact opnemen met sales@uitzendbureau.nl, of bellen naar 085-4019579.
<hotJob>
<![CDATA[
false
]]>
</hotJob>jobTitle verplicht
De titel van de vacature.
<jobTitle>
<![CDATA[
Automonteur
]]>
</jobTitle>jobDescription verplicht xhtml
Een algemene beschrijving van de vacature. Informatie over bijv. de ervaring of het salaris kan bij andere velden worden ondergebracht.
<jobDescription>
<![CDATA[
1e automonteur met APK ervaring die zelfstandig kan werken.
]]>
</jobDescription>jobLocation verplicht
<jobLocation>
<locationPlace></locationPlace>
<locationProvince></locationProvince>
<locationZipCode></locationZipCode>
</jobLocation>locationPlace verplicht
De standplaats van de vacature.
<jobLocation>
<locationPlace>
<![CDATA[
Nijmegen
]]>
</locationPlace>
</jobLocation>locationProvince
De provincie van de vacature.
<jobLocation>
<locationProvince>
<![CDATA[
Gelderland
]]>
</locationProvince>
</jobLocation>locationZipCode
(Optioneel, maar zeer aanbevolen)
De postcode van de vacature.
<jobLocation>
<locationZipCode>
<![CDATA[
6538AB
]]>
</locationZipCode>
</jobLocation>jobCategory
De categorie waaronder deze vacature valt. Er kunnen meerdere categoriën worden ingevuld (gescheiden door willekeurige word boundaries), maar de vacature zal uiteindelijk maar aan één categorie worden toegewezen. Je kunt gewoon je eigen benamingen gebruiken voor de categoriën. Wij vertalen dit automatisch naar onze eigen categoriën.
Let op: dit veld is niet de branche. Een vacature voor een ICT'er bij een bank valt onder de categorie ICT, en niet onder financieel.
<jobCategory>
<![CDATA[
Techniek, productie
]]>
</jobCategory>jobEducation
De gewenste vooropleiding(en) voor de functie.
<jobEducation>
<![CDATA[
LTS Motorvoertuigentechniek
]]>
</jobEducation>jobUrl
De link naar de vacature op de website van het uitzendbureau.
<jobUrl>
<![CDATA[
https://www.mijnuitzendbureau.nl/vacature/6489-automonteur
]]>
</jobUrl>jobOffer
Hieronder een voorbeeld van hoe het totaalplaatje eruit kan zien.
<jobOffer>
<offerDescription>
<![CDATA[
Goede arbeidsvoorwaarden.
]]>
</offerDescription>
<offerContract>
<contractType>
<![CDATA[
vrijwilligerswerk
]]>
</contractType>
<contractHours>
<hoursType>
<![CDATA[
fulltime
]]>
</hoursType>
<hoursMin>
<![CDATA[
32
]]>
</hoursMin>
<hoursMax>
<![CDATA[
40
]]>
</hoursMax>
<hoursDescription>
<![CDATA[
32-40 uur
]]>
</hoursDescription>
</contractHours>
<contractSalaryDescription>
<![CDATA[
Marktconform.
]]>
</contractSalaryDescription>
<contractDescription>
<![CDATA[
Wij bieden:
<ul>
<li>
Een uitdagende baan;
</li>
<li>
Een marktconform salaris.
</li>
</ul>
]]>
</contractDescription>
</offerContract>
</jobOffer>offerDescription xhtml
Algemene informatie over wat de werkgever heeft te bieden.
offerContract
Feitelijk aanbod van de vacature.
contractType
Soort dienstverband. Kies hierbij uit de dienstverbanden op deze pagina. Je kunt er ook meerdere gebruiken, gescheiden door komma’s.
contractHours
Het aantal uren per week.
<contractHours>
<hoursType>
<![CDATA[
fulltime
]]>
</hoursType>
<hoursMin>
<![CDATA[
32
]]>
</hoursMin>
<hoursMax>
<![CDATA[
40
]]>
</hoursMax>
<hoursDescription>
<![CDATA[
32-40 uur
]]>
</hoursDescription>
</contractHours>hoursType
Kies hierbij uit: parttime of fulltime.
hoursMin
Minimaal aantal uren per week.
hoursMax
Maximaal aantal uren per week.
hoursDescription
Als het niet mogelijk is om het aantal uren onder te brengen bij hoursMin en hoursMax, vul dan hier een algemene beschrijving in.
contractSalaryDescription xhtml
Omschrijving van het salarisaanbod.
contractDescription xhtml
Algemene omschrijving van het contract.
jobRequirements
Specifiekere informatie over de vereisten.
<jobRequirements>
<requirementsDescription>
<![CDATA[
Je bent nauwkeurig, flexibel, en een echte
teamplayer.
]]>
</requirementsDescription>
<requirementsExperience>
<![CDATA[
2 jaar ervaring in de auto- en elektrotechniek.
]]>
</requirementsExperience>
<requirementsCourses>
<![CDATA[
Je hebt de opleiding MTS werktuigbouwkunde,
motorvoertuigentechniek of gelijkwaardig met
succes afgerond.
]]>
</requirementsCourses>
</jobRequirements>requirementsDescription xhtml
Algemene omschrijving van de vereisten.
requirementsExperience xhtml
Omschrijving van de ervaringen die gewenst zijn.
requirementsCourses xhtml
Omschrijving van de opleidingen/cursussen die gewenst zijn.
jobEmployerInfo xhtml
Algemene informatie over de werkgever.
<jobEmployerInfo>
<![CDATA[
Onze klant is heeft zich ontwikkeld tot een
gieterij met wereldwijd 1.000 projecten.
]]>
</jobEmployerInfo>jobContact
Contactgegevens betreffende de vacature.
<jobContact>
<contactName>
<![CDATA[
Jan Janssen
]]>
</contactName>
<contactAddress>
<addressStreet>
<![CDATA[
Dorpsstraat 14
]]>
</addressStreet>
<addressZipcode>
<![CDATA[
1234 AB
]]>
</addressZipcode>
<addressPlace>
<![CDATA[
Arnhem
]]>
</addressPlace>
</contactAddress>
<contactPhone>
<![CDATA[
0123-456789
]]>
</contactPhone>
<contactEmail>
<![CDATA[
jan.janssen@arnhemmail.nl
]]>
</contactEmail>
<contactUrl>
<![CDATA[
https://www.mijnuitzendbureau.nl/werknemers/jan.janssen
]]>
</contactUrl>
<applicationUrl>
<![CDATA[
https://www.mijnuitzendbureau.nl/vacature/123-automonteur/solliciteren
]]>
</applicationUrl>
<applicationUrlHotJob>
<![CDATA[
https://www.mijnuitzendbureau.nl/vacature/123-automonteur/solliciteren?topvacature=1
]]>
</applicationUrlHotJob>
<mandatoryMotivation>
<![CDATA[
true
]]>
</mandatoryMotivation>
</jobContact>De velden applicationUrl en applicationUrlHotJob worden alleen gebruikt bij overeenstemming met de accountmanager van Uitzendbureau.nl. Standaard worden
sollicitaties verzonden naar het e-mailadres in contactEmail. applicationUrlHotJob (indien beschikbaar) wordt alleen gebruikt bij sollicitaties op
topvacatures.
Het veld mandatoryMotivation geeft aan of gebruikers verplicht een motivatietekst moeten invullen bij een sollicitatie.
jobBranch
Beschrijving van de vestiging waar de vacature open staat.
<jobBranch>
<branchName>
<![CDATA[
Mijn Uitzendbureau Amsterdam
]]>
</branchName>
<branchPlace>
<![CDATA[
Amsterdam
]]>
</branchPlace>
</jobBranch>branchName
Naam van de vestiging.
branchPlace
Plaats van de vestiging.
video
Op dit moment worden alleen video's van YouTube ondersteund. Mogelijk worden er later nog andere formaten toegevoegd.
<video>
<jobDescription>
<youtube>
<![CDATA[
9bZkp7q19f0
]]>
</youtube>
</jobDescription>
</video>jobDescription
Binnen jobDescription plaats je een lijst met video's. Deze video's worden geplaatst bij de beschrijving van de vacature. Mogelijk worden er later
nog andere locaties toegevoegd.
youtube
Je video moet al zijn toegevoegd aan YouTube, om deze toe te voegen aan de XML-feed. Vul het id in van de YouTube-video. Het id kun je uit de url van de video
halen. https://www.youtube.com/watch?v=9bZkp7q19f0 heeft bijvoorbeeld id 9bZkp7q19f0.
applicationMethods
Momenteel is alleen WhatsApp beschikbaar. Andere formaten kunnen later worden toegevoegd. Let op: dit werkt als een extra sollicitatiemethode - de onsite en offsite sollicitatiemethodes blijven aanwezig, ongeacht mobiele sollicitaties.
<applicationMethods>
<whatsapp>
<phone>
<![CDATA[
+31613223245
]]>
</phone>
</whatsapp>
</applicationMethods>logo
Door de logolink te verstrekken, wordt dit logo ingesteld voor de recruiter. Als er meer dan één logo in vacatures wordt verstrekt, wordt alleen het eerste logo ingesteld voor de recruiter.
<logo>
<![CDATA[
https://symfony.com/logos/symfony_black_02.png
]]>
</logo>Hier kunt u informatie verstrekken voor whatsapply.
number
Whatsapp-contactnummer. Het telefoonnummer mag alleen in internationaal formaat worden opgegeven (wat betekent dat u ook de landcode +31 moet opgeven).
We accepteren alleen waarden in dit patroon \s*\+[0-9\-()\s]+.
trackingDataKey
If you want to use Data tracking api, you’ll need to provide your generated key (same key for all of your jobs). The key is something you can generate yourself. Just make sure it’s a bit lengthy and hard to guess. In addition to this, you also need to provide cpc tag if you want cpc to be present in tracking data.
<trackingDataKey>
<![CDATA[
66773934444496256022244206744121
]]>
</trackingDataKey>cpc
CPC price in cents
<cpc>
<![CDATA[
2300
]]>
</cpc>campaignId
Campaign Id; please insert the campaign ID provided by us in this field (only if you work campaign based)
<campaignId>
<![CDATA[
4238742737427838499
]]>
</campaignId>