Handleiding: XML Vacature Interface voor webbeheerders
INHOUDSOPGAVE 1 INLEIDING...3 1.1 FEEDBACK... 3 2 BASISPRINCIPES...4 2.1 CRITERIA... 4 2.2 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: servicedesk@connexys.com
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 <organisatie_id>. 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 p_taal=1 adv_taal=1 p_pub_id=1 p_laatste=4 Omschrijving Geeft met een nummer de taal aan waarin de headers moeten worden weergegeven 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 OMSCHRIJVING LOKATIE BINNEN CONNEXYS sitegegevens begin van het XML bestand vacatures begin van de vacatures vacature id="1" begin van een vacature titel vacaturenaam Vacatures / Vacature / Basisgegevens / Vacaturenaam ondertitel korte omschrijving van de vacature locatie locatie van de vestiging waarvoor de vacature Vrij veld bestemd is afdeling afdeling waaronder de functie valt afdeling_id divisie divisie waaronder de afdeling valt divisie_id organisatie naam van de organisatie Organisaties / Organisatie / Onderdeel gegevens / Naam organisatie_unit name naam van de organisatie weergave_organisatie naam van de organisatie Organisaties / Organisatie / Onderdeel gegevens / Naam salaris salarisindicatie Vacatures / Vacature / Overige gegevens / Minimum salaris logo bedrijfslogo dat bij de vacature kan worden getoond min_uren minimum aantal uren per week Vacatures / Vacature / Profiel / Minimum aantal uur per week max_uren Tussen 0 en 50 maximum aantal uren per week Vacatures / Vacature / Profiel / Maximaal aantal uur per week vacaturenr vacaturenummer Vacatures / Vacature / Basisgegevens / Vacaturenummer taal taal van de vacaturetekst Vacatures / Advertentieteksten / Taal bedrijfsinfo omschrijving van het bedrijf in Vacatures / Advertentietekst / Bedrijfsinformatie advertentietekst functieomschrijving omschrijving van de functie in Vacatures / Advertentietekst / Functieomschrijving advertentietekst functieeisen eisen voor de functie in advertentietekst Vacatures / Advertentietekst / Functie-eisen arbeidsvoorwaarden arbeidsvoorwaarden in advertentietekst Vacatures / Advertentietekst / Arbeidsvoorwaarden contactinfo contactinformatie in advertentietekst Vacatures / Advertentietekst / Contactinfo
TAG OPTIES OMSCHRIJVING LOKATIE BINNEN CONNEXYS recruiter_id recruiternaam naam van de recruiter Vacatures / Vacature / Basisgegevens / Recruiter functie naam van de functie Vacatures / Vacature / Profiel / Functie functienivo niveau van de functie Vacatures / Vacature / Profiel / Functieniveau functienivo_id functiegroep_1 groep waaronder de functie valt Vacatures / Vacature / Profiel / Functiegroep functiegroep_id1 functiegroep_2 eventuele 2e groep waaronder de Vacatures / Vacature / Profiel / Tweede functiegroep functie valt functiegroep_id2 functiegroep_3 eventuele 3e groep waaronder de Vacatures / Vacature / Profiel / Derde functiegroep functie valt functiegroep_id3 branche branche Vacatures / Vacature / Overige gegevens / Branche contracttype type van het contract Vacatures / Vacature / Basisgegevens / Soort contract contractduur duur van het contract Vacatures / Vacature / Basisgegevens / Contractduur fulltime True / False geeft aan of het een fulltime functie Vacatures / Vacature / Profiel / Fulltime betreft internationaal True / False geef aan of de functie internationaal is bereid_te_reizen True / False wordt van de kandidaat geëist dat deze bereid is te reizen Vacatures / Vacature / Eisen kandidaat / Bereid om te reizen bereid_werk_buitenland True / False wordt van de kandidaat geëist dat deze bereid is Vacatures / Vacature / Eisen kandidaat / Bereid om in het rijbewijs True / False rijbewijs vereist Vacatures / Vacature / Eisen kandidaat / Rijbewijs jaren_ervaring aantal jaren ervaring Vacatures / Vacature / Eisen kandidaat / Jaren ervaring gewenst_opleidingsniveau_1 gewenst opleidingsniveau Vacatures / Vacature / Eisen kandidaat / Opleidingsniveau gewenst_opleidingsniveau_2 eventueel tweede gewenste Vacatures / Vacature / Eisen kandidaat / Tweede opleidingsniveau opleidingsniveau gewenste_oplrichting_1 gewenste opleidingsrichting Vacatures / Vacature / Eisen kandidaat / Opleidingsrichting gewenste_oplrichting_2 eventueel tweede gewenste richting Vacatures / Vacature / Eisen kandidaat / Tweede opleidingsrichting gewenste_oplrichting_3 eventueel derde gewenste richting Vacatures / Vacature / Eisen kandidaat / Derde opleidingsrichting postcode postcode van de locatie Vacatures / Vacature / Basisgegevens / Postcode Vrij veld datum_vanaf dd-mm-yyyy startdatum van de vacature Vacatures / Vacature / Status informatie / Datum vanaf Datum sluitingsdatum dd-mm-yyyy sluitdatum van de vacature Vacatures / Vacature / Status informatie / Sluitingsdatum Datum
TAG OPTIES OMSCHRIJVING LOKATIE BINNEN CONNEXYS level Vacatures / Vacature / Profiel / Level regios begin van de regio's regio id="6" regio waarop de vacature zich richt Vacatures / Vacature / Regio's / Regio Nummer stat-mutation-time tijdstip waarop de vacaturestatus voor Text het laatst is gewijzigd stat-mutation-text omschrijving van wijziging en naam Text gebruiker adv-mutation-time tijdstip waarop de advertentietekst voor Text het laatst is bijgewerkt adv-mutation-text omschrijving van wijziging en naam Text gebruiker publicaties begin van de publicaties publicatie id="2" uniek nummer ter identificatie van de Vacatures / Advertenties / Publicatie Nummer publicatie medium medium waar de publicatie getoond Vacatures / Advertentie / Publicatie moet worden datum_van startdatum publicatie, vanaf deze datum Vacatures / Advertentie / Startdatum Datum mag PAS getoond worden op de site datum_tot einddatum publicatie; na deze datum Vacatures / Advertentie / Einddatum Datum mag de NIET meer getoond worden op de site sollicitatie_link url van het sollicitatieformulier URL vacature_link url van de vacature (deeplink mogelijk) URL mail_a_friend_link mogelijkheid de vacature per e-mail door te sturen 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.