Job Feed

Job Feed

XML-Jobfeed

The XML-Feed is used to publish jobs to 3rd-Party applications, where the feed contains a list of jobs.
<jobs>
    <job>
        <id>12345</id>
        <name>recruiter</name>
        <subTitle>with professional experience</subTitle>
        <companyDescription><![CDATA[description of the company]]></companyDescription>
        <location>Vienna</location>
        <description><![CDATA[description of the job]]></description>
        <requirements><![CDATA[job requierements]]></requirements>
        <additionalText><![CDATA[addtional jobtext]]></additionalText>
        <responsibleUser>epunkt admin</responsibleUser>
        <responsibleEmail> support@erecruiter.net </responsibleEmail>
        <responsibleGender>1</responsibleGender>
        <jobProfile>Accounting</jobProfile>
        <content><![CDATA[CSS & HTML of the job]]></content>
        <dateSinceOnline>2016-03-25T00:00:00</dateSinceOnline>
    </job>
    <!-- More jobs -->
</jobs> 

XML-Jobfeed Tags

Find a description of the available XML-tags in the next table<tag_name>

<tag_name>

description

example

job ad metadata

id

The ID of the job

12345

name

The name of the job

Software Developer

subTitle

The subtitle of the job

for Online Gaming Solutions

companyDescription

The description of the company

Our client is an international Software Development Center, newly established …

description

The job description

The software developer is a hands-on technical person who will be responsible for …

requirements

The job requirements

The ideal candidate is a professional with experience in …

additionalText

Addtional jobtext

Our client offers the possibility to …

footer
Optional footer job text
 
content
The full css and html markup of the jobad
<style type="text/css"> #jobAd { font-family: Univers…
contact information for the recruiter

responsibleUser

The person, who is responsible for the job (i.e. the Recruiter)

John Smith

responsibleEmail

Email address of the responsible person

john.smith@email.com

responsibleGender

Gender of the responsible person

0 or 1 [0=female][1=male]

jobProfile

The job profile (just one entry possible)

IT

callback URLs for applications

url

The URL of this job

http://jobs.webpage.com/Jobs/Job?Job=12345&Referrer=www.webpage.com

applyUrl

Application link

http://jobs.webpage.com/?Job=12345&Referrer=www.webpage.com

job ad time information

dateOfCreation

The creation date of the job

2016-06-11T14:43:09.883

dateOfUpdate

The date of the latest job update

2016-06-11T14:52:21.077

dateSinceOnline

The date since the job is online available

2016-06-11T14:52:20.937

dateSinceOnlineCorrected

Corrected date since the job is online

2016-06-11T00:00:00

job ad additional information

occupationType

Type of employment

Part time / Full time / …

careerLevel

Career level

Experienced (Non-Manager)

job ad general location information
region
The region just like states or counties
Germany
location
The city of employment
Berlin
geoKoordinate
The location of the job as geo coordinates
 
job tags
tag
Tag (free text, multiple tags possible)
IT, Gaming,…
job ad publication channels
publishedOn
A list of portals and channels where the job is published on
Stepstone,  Karriere.at ,..
multi-posting providers channel information
multiChannelProviders
A list of multi-channel provider configured channels
 
extended job location information for multi-posting providers
jobCountry
The country of the job
Austria
jobZipCode
The zip code of the job
4020 Linz

XML-Jobfeed Request URL's

There are some routes available on the applicant-portal to generate different kind of feeds. These routes follows the following pattern 
Find next a description of the routes with their specific parameters

Syndication/Xml

Generates a XML with a list of jobs of the specified publication channel. If no publication channel is specified but a referrer, then the referrer is taken as channel, if it is a valid channel. If neither of both is specified, the current URL is used as channel. Optionally it's possible to filter the list of jobs by applying filters in parameters 'filter', 'jobProfiles' and 'regions'.
A XML with all jobs of the specified publication channel and filtered by the optional filter parameters is returned.
Find a description of the URL-parameters next.

parameter
description
channel
The publication channel or portal URL, if no channel is supplied, the default publication channel is used
filter
A string with a filter to filter the published jobs of the specified channel parameter
format
Specifies the format how the job ad should be displayed. If "html" is supplied the job ad html of the job is used, else a default job ad is generated
jobProfiles
A list of job profiles splitted by the character '|' to filter the published jobs
multiPostingPartner
Filter for a specific multi-posting partner
referrer
The referrer is appended to each job URL in the resulting XML. It was used as channel in earlier times where the channel didn't exist
regions
A list of regions splitted by the character '|' to filter the published jobs
culture
The culture the jobs should be rendered for

Syndication/Rss

Generates an Rss-Feed result from the parameters specified.

parameter
description
channel

The publication channel or portal URL, if no channel is supplied, the default publication channel is used

referrer
The referrer is appended to each job URL in the resulting XML. It was used as channel in earlier times where the channel didn't exist
filter
A string with a filter to filter the published jobs of the specified channel parameter
jobProfiles
A list of job profiles splitted by the character '|' to filter the published jobs
regions
A list of regions splitted by the character '|' to filter the published jobs
format
A string with a filter to filter the published jobs of the specified channel parameter
culture
The culture the jobs should be rendered for

Syndication/Xml/All

Load all published jobs in a chronological descending order from the specified channel, if specified. If no channel is supplied, jobs are loaded from the current portal. Optionally it's possible to filter the list of jobs by applying filters in parameters 'filter', 'jobProfiles' and 'regions'.
A list of jobs of the specified publication channel and filtered by the optional filter parameters is returned.
Find a description of the URL-parameters next.

parameter
description
referrer
The referrer is appended to each job URL in the resulting XML
filter
A string with a filter to filter the published jobs
jobProfiles
A list of job profiles splitted by the character '|' to filter the published jobs
regions
A list of regions splitted by the character '|' to filter the published jobs
format
Specifies the format how the job ad should be displayed. If "html" is supplied the job ad html of the job is used, else a default job ad is generated
multiPostingPartner
Filter for a specific multi-posting partner
culture
The culture the jobs should be rendered for

XML-Schema

erecruiter-job-feed.xsd can be downloaded at the end of this article.

FAQ

There are 4 different ways for each language to send a XML-Feed

Request Method
Request Feed
RSS without HTML
https://preview05.kandidatenportal.eu/Syndication/Rss?referrer=Betsy&culture=de
RSS with HTML
https://preview05.kandidatenportal.eu/Syndication/Rss?referrer=Betsy&format=html&culture=de
XML without HTML
https://preview05.kandidatenportal.eu/Syndication/Xml?referrer=Betsy&culture=de

XML with HTML

https://preview05.kandidatenportal.eu/Syndication/Xml?referrer=Betsy&format=html&culture=de
Settings in eRecruiter which influences the feed
  1. CUSTOM-Fields
    1. Public custom fields for jobs and customers are published via the XML feed to the applicant portal.
  2. Portal Settings - You can choose:
    1. include Advanced Data
    2. include tags
    3. include 4th job text block 


    • Related Articles

    • Job abschließen

      Nachdem ein Job besetzt wurde, muss dieser im eRecruiter wieder abgeschlossen werden. Dies bewirkt Folgendes: Der Job erscheint nicht mehr am Bewerberportal oder auf anderen Kanälen. Die Statistiken werden korrekt geführt. Allen anderen Bewerbern, ...
    • Job anlegen

      Jobs über die Jobübersicht anlegen 1 Über die Hauptnavigation öffnet sich die Jobübersicht. 2 Durch Klick auf das grüne Plus wird ein neuer Job angelegt. Jobs über den Kunden anlegen  1 Durch Klick auf den Kundennamen öffnet sich die Übersichtsseite ...
    • Job Request Document

      Before using the job-import, it has to be enabled in the mandator settings (Administration → Miscellaneous → Mandator settings → Request job from document → Request job from document). Furthermore, due to the document being linked to the imported ...
    • Job-Bewerber-Bewertung

      Um Bewerber, die sich für denselben Job beworben haben, einfacher vergleichen zu können gibt kann die Job-Bewerber-Bewertung genutzt werden. 1 Die Bewertungskriterien für die Job-Bewerber-Bewertung sind in der Jobübersicht zu finden. Mit dem ...
    • Änderung des Kunden beim Job

      Beim Anlegen eines neuen Jobs muss sowohl ein Kunde als auch ein Ansprechpartner ausgewählt werden. Der Kunde kann jedoch auch im Nachhinein angepasst werden, sodass kein neuer Job angelegt werden muss. Die Funktion Kunden ändern wird über das ...