Handleiding: XML Vacature Interface voor webbeheerders
INHOUDSOPGAVE 1
INLEIDING........................................................................................................................................................ 3 1.1
2
FEEDBACK.......................................................................................................................................... 3
BASISPRINCIPES........................................................................................................................................... 4 2.1 2.2
CRITERIA............................................................................................................................................ 4 FILTEREN ........................................................................................................................................... 5
1 Inleiding Via de XML-interface kunnen de volledige vacaturegegevens zoals aanwezig in Connexys door de website van de klant naar eigen inzicht worden verwerkt en geïntegreerd. Het grote voordeel van XML is de flexibiliteit. Alle benodigde gegevens worden aangeleverd en je hebt zelf de vrijheid om deze te tonen zoals gewenst. Indien er binnen de applicatie van Connexys een aanpassing wordt gedaan bij een vacature of gegevens met relatie tot deze vacature is deze wijziging direct zichtbaar wanneer de XML wordt opgevraagd. De XML bevat altijd de meest recente gegevens wanneer deze wordt opgevraagd. Dit document heeft als doel het voor voor webbeheerders duidelijk maken welke mogelijkheden en eisen er zijn bij het uitlezen van het XML-bestand. Op de laatste twee pagina's van dit document vindt u het overzicht met de verschillende velden die voorkomen in de XML.
1.1
Feedback
Heeft u een fout gevonden in, of een aanvulling op één van de handleidingen? U kunt dit per e-mail kenbaar maken aan de Connexys Servicedesk:
[email protected]
2 Basisprincipes Het is zelf te bepalen hoe vaak de XML uitgelezen wordt en er zitten geen beperkingen aan de hoeveelheid opvragingen. Er kan gekozen worden de XML eerst in een CMS in te laden alvorens de vacatures te publiceren.
2.1
Criteria
Om een vacature te tonen in de XML moet aan een aantal criteria worden voldaan. • • • • • • • •
De vacature moet de status 'open' hebben Datum vanaf moet een startdatum hebben van vandaag of in het verleden Sluitingsdatum moet een datum hebben in de toekomst, of moet leeg zijn De vacature moet zijn gepubliceerd De publicatie moet een startdatum hebben van vandaag of in het verleden De publicatie moet een einddatum hebben in de toekomst, of moet leeg zijn Er moet een advertentietekst bestaan Advertentietekst moet goedgekeurd zijn
De publicatie_id geeft met een nummer aan waarheen een vacature moet worden gepubliceerd. Verschillende publicatiekanalen worden geïdentificeerd met ID nummers (dit geldt voor alle items). Een vacature kan meerdere publicaties bevatten. Het is niet altijd zo dat de nieuwste publicaties onderaan verschijnen. Let daarom goed op de publicatiedatums bij het uitlezen van de XML. Datums binnen de XML worden weergegeven op deze wijze: dd-mm-yyyy. Zo kan er bijvoorbeeld gekozen worden een advertentie te tonen wanneer de publicatiedatum van een publicatie (datum_van) in het verleden staat en de sluitingsdatum (datum_tot) in de toekomst. Wanneer men wil dat de laatst bewerkte vacatures zichtbaar worden, kijk dan naar de adv-mutation-time. Op het moment dat een wijziging plaatsvindt binnen de advertentie wordt dit veld – dat een datum bevat – geupdate naar het moment van de wijziging.
2.2
Filteren
Als alternatief voor het via een CMS filteren kan er ook worden gekozen voor het opvragen van de XML met behulp van parameters, zo kan bijvoorbeeld een overzicht worden gemaakt met alleen vacatures van het hoofdkantoor. De website-beheerder kan in overleg met Connexys de juiste informatie binnen halen om op de site te tonen. In dit geval kan dit op de hand van het
. In sommige gevallen wordt er gekozen om dit te doen op de naam van een specifiek onderdeel. Deze is terug te vinden in <weergave_organisatie>. Hier zit echter een gevaar in. Vanaf het moment dat een Superuser binnen het systeem deze gebruikte naam aanpast zal de website niet meer werken. Dit komt door het feit dat er puur naar de naam wordt gekeken en niet naar een ID. Het filteren op naam is echter wel eenvoudiger om af te stellen. Deze oplossing is op alle velden toe te passen. Per situatie moet er goed worden bekeken wat er bereikt moet worden. Connexys heeft namelijk ook een aantal XML feeds achter de hand die niet direct worden uitgegeven. Deze XML feeds worden gebruikt om gegevens direct uit de database uit te lezen. Bijvoorbeeld organisatienamen of functies. Deze gegevens worden direct uit de database gehaald om drop downs te vullen met altijd de juiste informatie. Het mogelijk te filteren door een parameter toe te passen in de URL. In een publicatie worden een aantal automatisch gegenereerde links meegestuurd, namelijk de sollicitatie_link, vacature_link en mail_a_friend_link. In deze links wordt gebruik gemaakt van een aantal parameters, welke ook gebruikt kunnen worden om te bepalen wat er getoond wordt bij het opvragen van de pagina. Een voorbeeld van een dergelijke link is die naar het sollicitatieformulier: http://www.connexys.nl/klantpublic/run/XML_feed.startup?p_laatste=4&p_pub_id=2&p_taal=2
Onderstaande parameters kunnen op bovenstaande wijze worden gebruikt bij het oproepen van een pagina. Filter / Parameters
Omschrijving
p_taal=1
Geeft met een nummer de taal aan waarin de headers moeten worden weergegeven
adv_taal=1 p_pub_id=1
p_laatste=4
1 = Nederlands 2 = Engels Geeft met een nummer de taal aan waarin de advertentie moet worden weergegeven Te gebruiken wanneer vacatures moeten worde opgeroepen voor een andere publicatie. Handig voor intranet of stage-publicaties. Default geldt (tenzij Andes ingericht): 1 = Eigen website 2 = Intranet Geeft aan hoeveel van de laatste vacatures moeten worden getoond. Hier wordt gekeken naar de nieuwste publicatiedatums.
TAG
OPTIES
sitegegevens vacatures vacature id="1" titel
OMSCHRIJVING begin van het XML bestand
begin van de vacatures begin van een vacature vacaturenaam
ondertitel locatie afdeling afdeling_id divisie divisie_id organisatie
naam van de organisatie
organisatie_unit name weergave_organisatie
naam van de organisatie
salaris
salarisindicatie
logo
bedrijfslogo dat bij de vacature kan worden getoond minimum aantal uren per week Tussen 0 en 50
maximum aantal uren per week
vacaturenr
vacaturenummer
taal bedrijfsinfo
taal van de vacaturetekst omschrijving van het bedrijf in advertentietekst omschrijving van de functie in advertentietekst eisen voor de functie in advertentietekst arbeidsvoorwaarden in advertentietekst contactinformatie in advertentietekst
functieomschrijving functieeisen arbeidsvoorwaarden contactinfo
Vacatures / Vacature / Basisgegevens / Vacaturenaam korte omschrijving van de vacature locatie van de vestiging waarvoor de vacature bestemd is afdeling waaronder de functie valt divisie waaronder de afdeling valt
min_uren max_uren
LOKATIE BINNEN CONNEXYS
Vrij veld Lijst Lijst
Organisaties / Organisatie / Onderdeel gegevens / Naam naam van de organisatie Organisaties / Organisatie / Onderdeel gegevens / Naam Vacatures / Vacature / Overige gegevens / Minimum salaris
Vacatures / Vacature / Profiel / Minimum aantal uur per week Vacatures / Vacature / Profiel / Maximaal aantal uur per week Vacatures / Vacature / Basisgegevens / Vacaturenummer Vacatures / Advertentieteksten / Taal Vacatures / Advertentietekst / Bedrijfsinformatie Vacatures / Advertentietekst / Functieomschrijving Vacatures / Advertentietekst / Functie-eisen Vacatures / Advertentietekst / Arbeidsvoorwaarden Vacatures / Advertentietekst / Contactinfo
Lijst
TAG
OPTIES
OMSCHRIJVING
LOKATIE BINNEN CONNEXYS
naam van de recruiter naam van de functie niveau van de functie
Vacatures / Vacature / Basisgegevens / Recruiter Vacatures / Vacature / Profiel / Functie Vacatures / Vacature / Profiel / Functieniveau
groep waaronder de functie valt
Vacatures / Vacature / Profiel / Functiegroep
eventuele 2e groep waaronder de functie valt
Vacatures / Vacature / Profiel / Tweede functiegroep
eventuele 3e groep waaronder de functie valt
Vacatures / Vacature / Profiel / Derde functiegroep
functiegroep_id3 branche
branche
Vacatures / Vacature / Overige gegevens / Branche
contracttype
type van het contract
Vacatures / Vacature / Basisgegevens / Soort contract
duur van het contract geeft aan of het een fulltime functie betreft geef aan of de functie internationaal is wordt van de kandidaat geëist dat deze bereid is te reizen wordt van de kandidaat geëist dat deze bereid is rijbewijs vereist aantal jaren ervaring
Vacatures / Vacature / Basisgegevens / Contractduur Vacatures / Vacature / Profiel / Fulltime
recruiter_id recruiternaam functie functienivo functienivo_id functiegroep_1 functiegroep_id1 functiegroep_2 functiegroep_id2 functiegroep_3
contractduur fulltime
True / False
internationaal bereid_te_reizen
True / False True / False
bereid_werk_buitenland
True / False
rijbewijs jaren_ervaring
True / False
gewenst_opleidingsniveau_1
gewenst opleidingsniveau
gewenst_opleidingsniveau_2 gewenste_oplrichting_1
eventueel tweede gewenste opleidingsniveau gewenste opleidingsrichting
gewenste_oplrichting_2
eventueel tweede gewenste richting
gewenste_oplrichting_3
eventueel derde gewenste richting
postcode datum_vanaf sluitingsdatum
dd-mm-yyyy dd-mm-yyyy
postcode van de locatie startdatum van de vacature sluitdatum van de vacature
Vacatures / Vacature / Eisen kandidaat / Bereid om te reizen Vacatures / Vacature / Eisen kandidaat / Bereid om in het Vacatures / Vacature / Eisen kandidaat / Rijbewijs Vacatures / Vacature / Eisen kandidaat / Jaren ervaring Vacatures / Vacature / Eisen kandidaat / Opleidingsniveau Vacatures / Vacature / Eisen kandidaat / Tweede opleidingsniveau Vacatures / Vacature / Eisen kandidaat / Opleidingsrichting Vacatures / Vacature / Eisen kandidaat / Tweede opleidingsrichting Vacatures / Vacature / Eisen kandidaat / Derde opleidingsrichting Vacatures / Vacature / Basisgegevens / Postcode Vacatures / Vacature / Status informatie / Datum vanaf Vacatures / Vacature / Status informatie / Sluitingsdatum
Lijst Lijst Lijst Lijst Lijst Lijst Lijst Lijst Lijst Lijst Lijst Lijst Vrij veld Datum Datum
TAG level regios regio id="6" stat-mutation-time stat-mutation-text adv-mutation-time adv-mutation-text publicaties publicatie id="2" medium datum_van datum_tot
sollicitatie_link vacature_link mail_a_friend_link
OPTIES
OMSCHRIJVING
LOKATIE BINNEN CONNEXYS Vacatures / Vacature / Profiel / Level
begin van de regio's regio waarop de vacature zich richt tijdstip waarop de vacaturestatus voor het laatst is gewijzigd omschrijving van wijziging en naam gebruiker tijdstip waarop de advertentietekst voor het laatst is bijgewerkt omschrijving van wijziging en naam gebruiker begin van de publicaties uniek nummer ter identificatie van de publicatie medium waar de publicatie getoond moet worden startdatum publicatie, vanaf deze datum mag PAS getoond worden op de site einddatum publicatie; na deze datum mag de NIET meer getoond worden op de site url van het sollicitatieformulier url van de vacature mogelijkheid de vacature per e-mail door te sturen
Vacatures / Vacature / Regio's / Regio
Lijst Lijst Nummer Text Text Text Text
Vacatures / Advertenties / Publicatie
Lijst Nummer
Vacatures / Advertentie / Publicatie Vacatures / Advertentie / Startdatum
Datum
Vacatures / Advertentie / Einddatum
Datum
(deeplink mogelijk)
URL URL URL
Mocht u meer informatie willen hebben over de XML-Feed, laat het ons weten via uw Accountmanager, de Consultant die het project begeleidt of de Connexys Servicedesk.
© Copyright, Connexys Niets uit dit document mag worden verveelvoudigd en/of openbaar worden gemaakt door middel van druk, fotokopie, microfilm of anderszins, zonder voorafgaande schriftelijke toestemming van onderstaande instantie. Voor nadere inlichtingen en/of verzoeken om exemplaren van dit rapport kunt u zich wenden tot Connexys B.V. te Rotterdam.
