Vakanzendaten in die Stellenplattformen der CH Media exportieren
Die Stellenplattformen der CH Media, bestehend aus den
Webseiten
ostjob.ch,
zentraljob.ch,
myjob.ch,
westjob.at,
nicejob.de,
jobmittelland.ch,
jobbern.ch,
jobbasel.ch und jobs.nzz.ch
unterstützt einen automatischen Import der Vakanzen ihrer Kunden.
Der Import erfolgt über eine Abfrage der vom Kunden bereitgestellten HTTP oder HTTPS URL,
welche die Daten der Vakanzen in einem speziellen XML-Format enthält.
Alle Datenquellen werden stündlich zwischen
05:00 morgens und 23:00 CET abends abgefragt.
Das XML mit den Vakanzendaten muss alle Vakanzen der Firma/Firmen enthalten, die zum aktuellen Zeitpunkt online sein sollen.
Dies bedeutet, dass alle Vakanzen, welche die Firma A in der XML-Datei bereitstellt, auf den gewählten Stellenplattformen veröffentlicht werden.
Diese werden auf der Seite der Firma (https://www.myjob.ch/firma/[Company A Name]/[Company A ID]) erscheinen.
Die Miniseite der Firma, falls diese existiert (https://www.myjob.ch/minisite/[Company A minisite ID]),
werden von der Suche erfasst und sind über
ihren Link (https://www.myjob.ch/job/[Vacancy Title]/[Vacancy ID]) erreichbar.
Wird eine Vakanz aus der XML-Datei entfernt, wird diese auch auf der Plattform deaktiviert und kann
im Plattform 'Front-End' nicht mehr aufgerufen werden. Sie ist jedoch immer noch im System vorhanden
und kann unter den anderen inaktiven Vakanzen im Manager-Interface der
Firma gefunden werden (https://www.myjob.ch/manager/[Company A ID]/vacancy/list).
Achtung: Wenn die XML-Datei ein leeres Root-Element enthält,
werden alle gegenwärtig aktiven Vakanzen der Firma/Firmen, welche sich in der
XML-Datei befinden, deaktiviert. Darum sollte bei einem Fehlerfall einer automatisch
Generierten XML-Datei eine leere Rückgabe der URL-Datenquelle oder eine schlichte Text/HTML
Error Nachricht zurückgegeben werden. Wichtig ist, dass es keine gültige, aber leere, XML-Datei ist.
The CH Media platform, consisting of
ostjob.ch,
zentraljob.ch,
myjob.ch,
westjob.at,
nicejob.de,
jobmittelland.ch,
jobbern.ch,
jobbasel.ch and jobs.nzz.ch
websites, 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://www.myjob.ch/company/[Company A ID]),
the company's minisite, if it exists (e.g. https://www.myjob.ch/minisite/[Company A minisite ID]),
will be found by the platform job search, and
are available via the direct link (e.g. https://www.myjob.ch/vacancy/[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://www.myjob.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-Struktur
Die exportierte XML-Datei muss folgende Struktur haben. Folgend wird jedes vorhandene Element beschrieben.
<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>
<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>
<jobs_nzz_ch>0</jobs_nzz_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
Konstant und erforderlich. Muss
1
sein.
/list/vacancy/id
Erforderlich. Identifiziert eine Vakanz einmalig innerhalb einer Firma. Maximale Länge: 200 Zeichen.
/list/vacancy/company
Identifiziert eine Firma einmalig.
Nur bei einer Multi-Firma XML-Datei erforderlich. Maximale Länge: 200 Zeichen.
Die Firma muss schon im Myjob System existieren. Die Importprozedur erstellt keine neue Firmen.
/list/vacancy/title
Erforderlich. Der Titel der Vakanz. Maximale Länge: 200 Zeichen.
/list/vacancy/workplace/*
Nur workplace_city (Arbeitsort) ist erforderlich. Die weiteren Elemente sind optional.
Im Feld city können zudem Regionen übermittelt werden,
falls Ihre Firma hierfür aufgeschaltet wurde. Für weitere Details hierzu richten Sie Ihre Fragen bitte an Myjob.
/list/vacancy/company_description
Vakanzenspezifische Unternehmensbeschreibung.
- Kann HTML beinhalten
-
Die erlaubten Tags sind:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/description
- Kann HTML beinhalten
-
Die erlaubten Tags sind:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/requirements
- Kann HTML beinhalten
-
Die erlaubten Tags sind:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/offer
- Kann HTML beinhalten
-
Die erlaubten Tags sind:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/contact
- Erforderlich
- Kann HTML beinhalten
-
Die erlaubten Tags sind:
<b> <i> <ul> <ol> <li> <a> <img> <br> <p>
/list/vacancy/links
Optional.
/list/vacancy/links/description_url
Der Inhalt dieser URL wird auf der Detailseite der Vakanz
(http://myjob.ch/vacancy/[Vacancy ID]) in einem
iframe
angezeigt.
Maximale Länge: 1024 Zeichen. Bitte beachten Sie dass Sie auch in diesem Fall die Beschreibung und Anforderungen ausfüllen.
/list/vacancy/links/application_url
Webseite mit dem Bewerbungsformular oder E-Mail Adresse (mit oder ohne
mailto:
) einer Kontaktperson.
Maximale Länge: 1024 Zeichen.
/list/vacancy/publication
Mindestens eines der Subelemente (
1 haben.
Definiert auf welcher Seite der Plattform die Vakanz veröffentlicht wird.
Der Standard Wert für
ostjob_ch
, westjob_at
, nicejob_de
,
minisite
, zentraljob_ch
, myjob_ch
) muss den Wert minisite
ist 1
; für alle anderen Seiten 0
.
/list/vacancy/type/key
Erforderlich. Der Defaultwert ist
5
.
Die folgenden Werte sind möglich:
2
für Lehrstelle3
für Praktikumsstelle5
für Festanstellung6
für Temporär7
für Freelance8
für Ferienjob
/list/vacancy/type/value_min
Defaultwert ist leer.
Der Wert muss kleiner oder gleich /list/vacancy/type/value_max sein.
/list/vacancy/type/value_max
Defaultwert ist leer.
Der Wert muss grösser oder gleich /list/vacancy/type/value_min sein.
/list/vacancy/positions/position
Optional. Der Defaultwert ist leer.
position
position 1
beschreibt eine "Führungsposition", d.h. mit Personalverantwortung.
2
beschreibt eine "Management / Kader" Position, d.h. mit Autorität für Managemententscheidungen im Unternehmen.
/list/vacancy/template
Optional. Mit diesem Feld können Sie die Vorlage auswählen die für dieses Inserat verwendet wird.
Die Vorlage muss erstellt und hinterlegt sein. Informieren Sie sich bitte bei Ihrem Ostjob Verantwortlichen welche
IDs für welche Templates verwendet werden können. Wird das Feld weggelassen wird das hinterlegte Standardtemplate verwendet.
Falls es kein Template hinterlegt hat das Ostjob Standardtemplate.
/list/vacancy/keywords
Optional. Soll Keywords enthalten, welche die Vakanz beschreiben. Die individuellen Keywords sollen mit Kommas unterteilt sein.
/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 Ostjob 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 Myjob 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
At least one of the subelements (
ostjob_ch
,
westjob_at
, nicejob_de
,
minisite
, zentraljob_ch
, myjob_ch
) must be present with the value 1
.
Defines on which sites of the platform the vacancy must be published.
The default value for minisite
is 1
; for all the other sites the default value is 0
.
/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 Ostjob 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 Ostjob default template is used.
/list/vacancy/keywords
Should contain keywords which describe the vacancy.
The individual keywords should be separated by commas.
Validierung
Es kann eine URL oder der Inhalt im obigen XML-Format eingefügt und validiert werden.
Aktueller Stand: 09.05.2022