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
... View more