Opbouw XML datafeed

[#1]

1. EasyCruit vacature XML-feed

Via de RESTful (webservice) maakt EasyCruit het mogelijk om verbinding te
maken met ons systeem en data te extraheren in een gestandaardiseerd XML
formaat. Dit is de meest populaire methode om verbinding te maken omdat het
een snelle en eenvoudige integratie met EasyCruit mogelijk maakt.
Type XML feed
De EasyCruit RESTful service biedt een live, real-time feed. Dit bekekent dat alle
plaatsingen in de XML blijven staan gedurende de plaatsingsperiode zoals
ingesteld door de gebruiker tijdens het plaatsen van de vacature.
Bijvoorbeeld: indien de gebruiker 2 januari als startdatum en 20 januari als
einddatum van de plaatsing heeft ingegeven, dan is de vacature zichtbaar in de
XML van 2 t/m 20 januari. Na de 20e is de vacature niet meer zichtbaar in de

feed.

De lijst van geplaatste vacatures in EasyCruit is tevens de lijst van weergegeven
vacatures in de XML. Zodra een gebruiker de plaatsing van een vacature stopt
dan is de vacature ook niet meer zichtbaar in de XML.

De klant dient zelf het XSLT bestand te configureren om hiermee de gegevens uit
de XML op te halen en te tonen op de eigen carrière website.

2. Links voor de vacature XML-feed
De XML bestaat uit de volgende onderdelen:
1. Data search: lijst met actieve zoekwaarden voor het bouwen van de
zoekfunctie
2. Joblist: lijst met alle vacatures voor het bouwen van de vacaturelijst
3. Vacancy: vacature-specifieke XML met alle details van de vacature.

Per publicatiekanaal is er een set van XML links beschikbaar (b.v. externe
website, intranet, stages, trainees etc.). De ‘Data search’ link is gelijk voor alle
kanalen.

Hieronder de XML links:

Kanaal	XML link
Algemeen	Data search: http://demo.easycruit.com/export/xml/search_options
Internet (extern)	Joblist: https://demo.easycruit.com/export/xml/vacancy/list.xml Vacancy: https://demo.easycruit.com/export/xml/vacancy/[vacancy_ID].xml *
Intranet (intern)	Joblist: https://demo.easycruit.com/intranet/01/export/xml/vacancy/list.xml Vacancy: https://demo.easycruit.com/intranet/01/export/xml/vacancy/[vacancy_ID].xml*

Additionele kanalen kunnen op verzoek toegevoegd worden (b.v. een intranet, stage of trainees
kanaal)
* De “vacancy_ID” uit de joblist XML wordt gebruikt om de vacaturespecifieke
XML te genereren. Voorbeeld: vacancy_ID in de joblist:

Id = 2216359, de vacaturespecifieke XML wordt dan:
https://demo.easycruit.com/export/xml/vacancy/2216359.xml

3. Variabelen in de XML feed
In de XML kunnen de volgende variabelen weergegeven worden.

3.1.1 Listing XML
<Vacancy id="xxxxxx" date_start="yyyy-mm-dd" date_end="yyyy-mm-dd"
reference_number="">
<Versions>
<Version language="en"> (Vacancy language, ex. da, sv, gb, etc.)
<Title>Mandatory title</Title>
<TitleHeading>Not mandatory sub title</TitleHeading>
<AlternativeCompanyName>Company name</AlternativeCompanyName>
<ApplicationDeadline>Free text field with application
deadline</ApplicationDeadline>
<Location>Free text field with job location</Location>
<Engagement>Free text field with engagement</Engagement>
<Region>
<Country id="xx" name="Sweden"> (Vacancy country)
<County id="xxx">Region in selected country</County>
</Country>
</Region>
<Categories>
<Item type="area-of-interest" id="xxx">Area of interest</Item>
<Item type="position-type" id="xxx">Position type</Item>
<Item type="job-level" id="xxx">Job level</Item>
<Item type="duration" id="xxx">Duration</Item>
<Item type="extent" id="xxx">Extent</Item>
<Item type="operating-time" id="xxx">Operation time</Item>
</Categories>
</Version>
</Versions>
<Departments>
<Department id="xxx">
<Name>Department name</Name>
<LogoURL>Full URL to uploaded logo</LogoURL>
<VacancyURL>URL to vacancy</VacancyURL>
<ApplicationURL>URL to application form</ApplicationURL>
</Department>
</Departments>

</Vacancy>

3.1.2 Vacancy XML
Besides the above variables these are the variables for the vacancy ad.
<Description>Vacancy text with html formatting included</Description>
<About>Department ingress with html formatting</About>
<PrivacyPolicy>Department Privacy Policy with html formatting</PrivacyPolicy>
<Address type="postal">(Department postal)
<Street>Street name / number</Street>
<Area>City</Area>
<AreaCode>Zip</AreaCode>
</Address>
<Address type="office">(Department visiting address)
<Street>Street name / number</Street>
<Area>City</Area>
<AreaCode>Zip</AreaCode>
</Address>
<Telephone type="office">Phone</Telephone>
<Telephone type="telefax">Fax</Telephone>
<ContactPersons>
<ContactPerson>
<CommonName>Contact person name</CommonName>
<Email>Contact person e-mail if published</Email>
<Telephone type="office">Contact person phone number</Telephone>
<Telephone type="cellular">Contact person cellular</Telephone>
</ContactPerson>
</ContactPersons>
<HomepageURL>Department web site address</HomepageURL>
<ImageURL>Full URL to uploaded image</ImageURL>

3.1.3 Meerdere waarden
Het is mogelijk dat er in één vacature meerdere waarden van de volgende
variabelen in de XML zitten: <Country>, <County>, <ContactPersons>, <Item
type="area-of-interest">, <Item type="position-type">, <Item type="job-level">,
<Item type="duration">,<Item type="extent">, <Item type="operating-time">
Er is één verplichte waarde en dat is <Title>, overige velden kunnen leeg zijn.

3.1.4 Meerdere afdelingen in de vacature
Een belangrijke functionaliteit van EasyCruit is de mogelijkheid om meerdere
afdelingen aan een vacature te koppelen. Indien dit het geval is dient de
kandidaat eerst een afdeling te selecteren alvorens hij/zij daadwerkelijk kan
solliciteren.

3.1.5 Cache
De cache-tijd voor de XML feed van EasyCruit is één uur. De informatie
(wijzigingen in een bestaande vacature) welke is ingevuld in EasyCruit zal dan één
uur later beschikbaar zijn, tenzij de gebruiker de vacature direct opnieuw
publiceert.

3.1.6 Additionele informatie
Vacaturelijst: https://www.easycruit.com/dtd/vacancy-list.xsd
Vacature: https://www.easycruit.com/dtd/vacancy.xsd

[Sita Wennekes]

@Ingrid Russchen 

Hoi Ingrid,

Enkele demo linkjes werken niet in dit document.

Ik zie alleen jouw naam staan bij dit onderwerp. Kan jij er voor zorgdragen dat het bij de juiste persoon komt?

Alvast bedankt.

Met vriendelijke groet,

Sita Wennekes

[Ingrid Russchen]

@Sita Wennekes Ik heb de link aangepast. De voorbeeldvacature werd niet meer gepubliceerd.

In dit voorbeeld werkt de link ook niet  https://demo.easycruit.com/export/xml/vacancy/[vacancy_ID].xml

Dat komt omdat er nog geen specifieke vacatureselectie is gedaan. Dat kun je doen door vanuit deze feed https://demo.easycruit.com/export/xml/vacancy/list.xml

een vacancy_ID te plakken op de plek van de blokhaken in de vorige feed [vacancy_ID].