Spécifications de l’interface
L’interface “ letempsemploi.ch” permet l’importation automatique des offres d’emploi des clients. L’importation se fait en interrogeant l’URL HTTP ou HTTPS fournie par le client, qui contient les données des offres d’emploi dans un format XML spécial. Les sources de données sont mises à jour toutes les heures entre 05h00 le matin et 23h00 CET le soir.
Le fichier XML avec les données des offres d’emploi doit contenir toutes les offres d’emploi de l’entreprise ou des entreprises qui sont censées être en ligne. Cela signifie que toutes les offres d’emploi fournies par l’entreprise A dans le fichier XML seront publiées sur les plateformes d’emploi sélectionnées.
Celles-ci apparaîtront sur la page de l’entreprise (https://letempsemploi.ch/entreprise/[Nom de l’entreprise A]/[ID de l’entreprise A]).
Le minisite de l’entreprise, s’il existe (https://letempsemploi.ch/minisite/[ID du minisite de l’entreprise A]), est capturé par la recherche et peut être consulté via son lien (https://letempsemploi.ch/emploi/[Titre de l’offre d’emploi]/[ID de l’offre d’emploi]).
Si une offre d’emploi est supprimée du fichier XML, elle sera également désactivée sur la plateforme et ne sera plus accessible sur la plateforme (front-end). Cependant, elle est toujours présente dans le système et se trouve parmi les autres postes vacants inactifs dans l’interface de gestion de l’entreprise (https://letempsemploi.ch/manager/[ID de l’entreprise A]/poste vacant/liste).
Attention : Si le fichier XML contient un élément racine vide, toutes les offres d’emploi actuellement actives de la ou des sociétés qui se trouvent dans le fichier XML seront désactivées. Par conséquent, en cas d’erreur d’un fichier XML généré automatiquement, un retour vide de la source de données URL ou un message d’erreur texte/HTML brut doit être renvoyé. Il est important de noter qu’il ne s’agit pas d’un fichier XML valide, mais vide.
letempsemploi.ch supports an automatic import of jobs for its subscription customers.
The import is implemented via regular polling of a customer-provided HTTP or HTTPS URL,
containing the jobs' data in a special XML format.
All the data sources are polled every hour between the following times:
from 05:00am until 23:00pm CET.
The job data XML must contain all the jobs of a company (or a set of companies) that should be online at the given time.
This means that all the jobs listed
in the XML for company A will be published on the selected platforms: they'll appear
on the company page (e.g. https://letempsemploi.ch/entreprise/[Company A ID]),
the company's minisite, if it exists (e.g. https://letempsemploi.ch/minisite/[Company A minisite ID]),
will be found by the platform job search, and
are available via the direct link (e.g. https://letempsemploi.ch/emploi/[Vacancy ID]).
When vacancy is removed from the exported XML,
it's deactivated on the platform, and is no longer available in the platform front-end.
However, it still persists in the system, and can be found among all the other inactive vacancies
in the company manager's area (https://letempsemploi.ch/manager/[Company A ID]/vacancy/list).
Attention: if the XML contains only an empty root element, the import procedure
will deactivate all the currently active vacancies of all the companies whose
jobs were previously found in the XML. Thus, for an automatically generated XML, in case of error,
please return an empty response (or any plain text/HTML error message).
What's important is that it's not a valid XML with no vacancies.
XML Structure
Le fichier XML exporté doit avoir la structure suivante. Chaque élément existant est décrit ci-dessous.
<list version="1">
<vacancy>
<id>REF-123456</id>
<company>XIAG AG</company>
<title>Programmer</title>
<workplace>
<country>CH</country>
<zip>8057</zip>
<city>Zürich</city>
<home_office>0</home_office>
</workplace>
<company_description>
<![CDATA[
XIAG AG, Internet Solutions Zürich, is an international software developing company specialised on web and
mobile applications.<br />
Founded in 2000, XIAG AG now employs more than 30 specialists in software development, design and system
administration offering to our demanding international clients sophisticated and individual solutions. With
more than a decade of experience and over 200 successfully completed projects, XIAG has built up long term
partnerships with its clients and stands for stability and strong growth.
]]>
</company_description>
<description>
<![CDATA[
Challenging well-paid job in a successful international software development company,<br />
which will boost your professional and personal growth. Development of Internet software
solutions with PHP (Linux, Apache, Postgres).
]]>
</description>
<requirements>
<![CDATA[
<ul>
<li>Minimum 2 years of industry experience with PHP</li>
<li>Object-oriented programming, and relational data modeling skills</li>
<li>Test-driven development experience is a plus</li>
<li>Written English</li>
</ul>
]]>
</requirements>
<offer>
<![CDATA[
Development of Internet software solutions with PHP (Linux, Apache, Postgres)
]]>
</offer>
<contact>
<![CDATA[
You are welcome to send your resume in English, stating the job your are applying for to
the following contact: <br />
John Smith
<a href="mailto:jobs@xiag.ch">jobs@xiag.ch</a>
Telephone: +7 (383) 335 65 66
Your data will be treated strictly confidential!
]]>
</contact>
<links>
<description_url>http://www.xiag.ch/jobs/php_developer/</description_url>
<application_url>http://www.xiag.ch/jobs/php_developer/apply</application_url>
</links>
<publication>
<letempsemploi_ch>0</letempsemploi_ch>
<ostjob_ch>1</ostjob_ch>
<westjob_at>1</westjob_at>
<nicejob_de>0</nicejob_de>
<myjob_ch>0</myjob_ch>
<zentraljob_ch>0</zentraljob_ch>
<jobmittelland_ch>0</jobmittelland_ch>
<jobbern_ch>0</jobbern_ch>
<jobbasel_ch>0</jobbasel_ch>
<jobzueri_ch>0</jobzueri_ch>
<jobs_nzz_ch>0</jobs_nzz_ch>
<suedostschweizjobs_ch>0</suedostschweizjobs_ch>
<liechtensteinjobs_li>0</liechtensteinjobs_li>
<lehrstellencheck_ch>0</lehrstellencheck_ch>
<minisite>0</minisite>
</publication>
<type>
<key>5</key>
<value_min>60</value_min>
<value_max>100</value_max>
</type>
<positions>
<position>1</position>
<position>2</position>
</positions>
<template>34</template>
<keywords>Manager, Project Leader</keywords>
</vacancy>
<vacancy>
...
</vacancy>
...
</list>
/list/@version
Constant et requis. Doit être
égal à 1
.
/list/vacancy/id
Obligatoire. Identifie un emploi unique au sein d’une entreprise. Longueur maximale : 200 caractères.
/list/vacancy/company
Identifie l'entreprise.
Seul un fichier XML multi-sociétés est requis. Longueur maximale : 200 caractères.
L’entreprise doit déjà exister dans le système letempsemploi.ch. La procédure d’importation ne crée pas de nouvelles entreprises.
/list/vacancy/title
Obligatoire. Titre de l’offre d’emploi. Longueur maximale : 200 caractères.
/list/vacancy/workplace/*
Seul workplace_city (lieu de travail) est requis. Les autres éléments sont facultatifs.
Dans le domaine de la ville, les régions peuvent également être transmises,
si votre entreprise a été créée à cet effet. Pour plus de détails, veuillez adresser vos questions à letempsemploi.ch.
/list/vacancy/company_description
Description de l’entreprise spécifique à l’annonce
- Peut inclure du code HTML
-
Les balises autorisées sont les suivantes :
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/description
- Peut inclure du code HTML
-
Les balises autorisées sont les suivantes :
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/requirements
- Peut inclure du code HTML
-
Les balises autorisées sont les suivantes :
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/offer
- Peut inclure du code HTML
-
Les balises autorisées sont les suivantes :
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/contact
- Obligatoire
- Peut inclure du code HTML
-
Les balises autorisées sont les suivantes :
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/links
Optionnel.
/list/vacancy/links/description_url
Le contenu de cette URL sera affiché sur la page de détail de l’offre d’emploi.
(https://letempsemploi.ch/emploi/[Vacancy ID]) dans un
iframe
.
Longueur maximale : 1024 caractères. Veuillez noter que dans ce cas également, vous remplirez la description et les conditions requises.
/list/vacancy/links/application_url
Site web avec le formulaire de candidature ou l’adresse e-mail (avec ou sans
mailto:
) d’une personne de contact.
Longueur maximale : 1024 caractères.
/list/vacancy/publication
Définit sur quelle page de la plateforme l’offre d’emploi sera publiée (valeur
1
).
/list/vacancy/type/key
Obligatoire. La valeur par défaut est
5
.
Les valeurs suivantes sont possibles :
2
pour l’apprentissage3
pour le stage5
pour l’emploi permanent6
pour Temporaire7
pour Freelance8
pour emploi saisonnier
/list/vacancy/type/value_min
La valeur par défaut est vide.
La valeur doit être inférieure ou égale à /list/vacancy/type/value_max.
/list/vacancy/type/value_max
La valeur par défaut est vide.
La valeur doit être supérieure ou égale à /list/vacancy/type/value_min.
/list/vacancy/positions/position
Optionnel. La valeur par défaut est vide.
Le poste
Le poste 1
décrit un « poste de direction », c’est-à-dire avec des responsabilités en matière de personnel.
2
décrit un poste de « gestion / cadre », c’est-à-dire avec autorité pour les décisions de gestion dans l’entreprise.
/list/vacancy/template
Optionnel. Ce champ vous permet de sélectionner le modèle qui sera utilisé pour cette annonce.
Le modèle doit être créé et stocké. N’hésitez pas à contacter votre responsable Ostjob pour savoir quel
ID pour lesquels des modèles peuvent être utilisés. Si le champ est omis, le modèle par défaut sera utilisé.
S’il n’y a pas de modèle, utilisez le modèle par défaut.
/list/vacancy/keywords
Optionnel. Doit contenir des mots-clés décrivant le poste vacant. Les mots-clés individuels doivent être séparés par des virgules.
/list/@version
Required. Must be
1
.
/list/vacancy/id
Required. Consistently and uniquely identifies a vacancy within a company. Maximum length: 200 characters.
/list/vacancy/company
Consistently and uniquely identifies a company. Required only for a multi-company XML, otherwise can be omitted.
Maximum length: 200 characters.
The company must already exist in the system. The import procedure doesn't create new companies.
/list/vacancy/title
Required. The job title. Maximum length: 200 characters.
/list/vacancy/workplace/*
Only the city is required. Other elements can be omitted.
The field can also be used to transmit regions,
if your company has been authorized for this - for further questions, please contact letempsemploi.ch directly.
/list/vacancy/company_description
Vacancy specific company description.
- Can contain HTML
-
Allowed tags are:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/description
- Can contain HTML
-
Allowed tags are:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/requirements
- Can contain HTML
-
Allowed tags are:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/offer
- Can contain HTML
-
Allowed tags are:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/contact
- Required
- Can contain HTML
-
Allowed tags are:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/links
Optional.
/list/vacancy/links/description_url
When present, the content from this URL will be displayed on the vacancy details page (
http://ostjob.ch/vacancy/[Vacancy ID]) in an
<iframe>
.
Maximum length: 1024 characters. Please note, that in this case the description and requirements should be present.
/list/vacancy/links/application_url
Web page containing this job's application form or e-mail address (with or without
mailto:
) of a contact person.
Maximum length: 1024 characters.
/list/vacancy/publication
Defines on which sites of the platform the vacancy must be published (if value
1
is passed).
/list/vacancy/type/key
Required. The default value is
5
.
The following values are available:
2
for Lehrstelle (apprenticeship)3
for Praktikumsstelle (internship)5
for Festanstellung (fixed employment)6
for Temporär (temporary)7
for Freelance (freelance)8
for Ferienjob (vacation job)
/list/vacancy/type/value_min
Default value is empty.
If given, should be less or equal to /list/vacancy/type/value_max
/list/vacancy/type/value_max
Default value is empty.
If given, should be greater or equal to /list/vacancy/type/value_min
/list/vacancy/positions/position
Optional. The default value is empty.
position
position 1
describes a "leadership position", meaning personnel responsibility.
2
describes a "management / executive position", meaning a responsibility with authority for executive decisions in the company.
/list/vacancy/template
With this field you can select the template which is assigned to the vacancy.
Please ask your letempsemploi.ch representative to get the IDs of the templates which are assigned to your company.
If no Template-ID is passed then the assigned default template is used.
If there is no template assigned then the default template is used.
/list/vacancy/keywords
Should contain keywords which describe the vacancy.
The individual keywords should be separated by commas.
Validation
Une URL ou un contenu peut être inséré et validé au format XML ci-dessus.