<-- Go Back to the Jamit Job Board docs page.

Jamit XML Feed Spec for importing/exporting jobs

Feed Encoding

- Unicode characters, using UTF-8

- Data stored inside element is always XML Encoded, e.g. < is written as < and & is written as &amp;

Assumptions and Limitations

- The built-in importing tool in Jamit cannot read XML files with multiple sequence elements. It can only import files with one sequence elements. Sequence elements are elements that repeat in the feed and the parser loops through them. An example of a sequence element is a job element.

- The built-in importing tool in Jamit cannot import data from attributes, and discards this data. Data can be imported from in between elements.

Element Structure Overview

Jamit - element - This is the container of the Jamit XML Feed.

JobsFeed element - This contains information about the job source. It also contains a set of job elements, which is a sequence of job records. Each job element contains further sub-elements. (Similar to an RSS channel element)

Job element - This contains information about an individual job postings. It may also optionally contain job poster account information. If no account information is specified, the job will be imported under a default username. It also contains three sub-elements: location, category and salary

Account element - This optional element contains the poster's account information.

Some elements are marked as 'optional' in the feed, but the more given, the better.

Element Dictionary

Symbol key:

Ω255 - Indicates 255 character Limit
∞ - Indicates no limit

jamit Elements - a container of the feed

Element Description Example
jamitKey This is the feed API Key. Ω255 (optional) abgd7mc632nid8jabd
jobsFeed A sub-element which contains a feed of the jobs to be imported / deleted / updated  

Elements of jobsFeed, a sub-element of jamit

Element Description Example
title The title of the job board from where the feed was published, Ω255 Jamit Job Board Demo
link The link of the job board from where the feed was published, Ω255 http://www.jamit.com/jobs/
description The description of the job board from where the feed was published, Ω255 The largest job board in the world
pubDate Indicates when the feed was published. Date format must conform to RFC #733. (optional) Sun, 19 May 2002 15:21:36 GMT
lastBuildDate Indicates when the feed was generated. Date format must conform to RFC #733 (optional) Sun, 18 May 2002 15:21:36 GMT
generator A string used to indicated the software used to generate the jobsFeed. Ω255 (optional) Jamit Job Board
managingEditor Email address for person responsible for editorial content. Ω255 (optional) test@example.com (John Smith)
webMaster Email address for person responsible for technical issues relating to channel. Ω255(optional) webmaster@example.com (Jason Jones)
targetNiche The target niche of the job board from where the feed was published. This element contains further sub-elements Ω255 (optional)  
job job posting data sub-elements  

 

Elements of targetNiche, an optional sub-element of jobsFeed. The targetNiche is optional, and only useful for search engines or directories to categorize the feed

Element Description Example
industry The industry/ies which the job board is targeting. Leave blank for all industries, separate with comma for a list of industries. Ω255 (optional) entertainment
function The job function(s) which the job board is targeting. Leave blank for all industries, separate with comma for a list of industries. Ω255 (optional) accounting
jobs_type The job types for which the job board is targeting. Leave blank for all job types, separate with comma for a list of industries. Ω255 (optional) The largest job board in the world
skill The special skill(s) which the job board is targeting. Leave blank for all industries, separate with comma for a list of industries. Ω255 (optional) japanese language
region The region/country/county/etc which the job board is targeting. Leave blank for world-wide locations, separate with comma for a list of regions/locations. Ω255 (optional) United States
lang The job language which the job board is targeting. Leave blank for all industries, separate with comma for a list of industries. Ω255 (optional) English

 

Elements of job, a required sub-element of jobsFeed

Element Description Example
command How to deal with the job element. Command can be INSERT, UPDATE or DELETE. If not specified, then INSERT is assumed. Ω32 (optional) INSERT
days_to_advertise Indicates how many days to advertise, starting from pubDate. If blank or invalid, 30 is assumed. Ω32 (optional) 30
refID Recruiter's / Employers reference ID of the job. (optional) Ω255 590
guid GUID = Global Unique Identifier. A unique identifier of the job which is unique for all job board across the internet. It can be anything, but it is best to set this as the URL to the original posting Ω255 http://www.example.com/jobs/job/590
post_mode Indicates what kind of posting it is; can be premium or normal. normal is assumed if not specified. Ω16 (optional) normal
application_url The application url for the job posting. Ω255(optional) http://www.example.com/jobs/job/590?apply=true
pubDate Indicates the date of the job's publication. Date format must conform to RFC #733 Thu, 14 Aug 2008 19:19:28 +0000
link The link to the original job posting for the user Ω255 http://www.example.com/jobs/job/590
account This element contains employer account elements (optional)  
title Indicates the Title of the job posting Ω255 Software Engineer (Senior)
email Indicates the email address of the job posting Ω255 apply@example.com
location location elements  
categories category elements  
start Indicates the date of commencement. Can be a RFC #733 Date, or ASAP (optional) Thu, 14 Aug 2008 19:19:28 +0000
duration Indicates the duration of the job. Free-text, e.g. permanent, 6 weeks, 1 month, etc (optional)Ω32 6 months
skills Indicates the skills needed for the job. Comma delimited. (optional) php, mysql, javascript
postalcode The postal code (ZIP) of the job.Ω255 90210
posted_by Name of employer/recruiter/company who posted the job Ω255 Jamit Software Limited
salary salary elements (optional)  
immigration_status Immigration status required for the job. Multiple values comma delimited. Ω255(optional)  
experience Experience required for the job. Free-text. Ω255 (optional)  
description Job description Our place is a great place to work. We hire talented, motivated people and hand them big problems to solve. We have a great new space, an army of passionate users, and a very bright future. Our team is small but growing a lot in the near future -- maybe you should join us.
image_link The link to an image found in the job Ω255 http://www.example.com/images/some-image.gif

Elements of account, an optional sub-element of job. The account is optional, and only useful for importing jobs which are associated with an employer's account. If account is not specified, the job should be imported under a default account. At least the username must be present, all other fields are optional.

Element Description Example
username username of the job poster account. Valid characters are A-Z, a-z, 0-9, dash, underscore, dot, @ Ω64 tester
password password of the job poster account. The password can either be in plain-text or encrypted using and md5 hash. (optional, but required for creating new accounts) Ω255 secret#pass53
accountEmail Email address of the account holder (optional, but required for creating a new account) Ω255 test@example.com
contact This element contains further contact sub-elements  

 

Elements of contact, a sub-element of account. The contact is required if the account element is included in the field

Element Description Example
firstName First name of the job posting account, free-text Ω255 John
lastName Last name of the job posting account, free-text Ω255 Smith
company Company name of the job poster (optional) Ω255 Berkeley Softworks
address The contact address (optional) Ω255 3082/12F Broadway, NY
place can be city, cbd, town, suburb, etc (optional) Ω255 Manhattan
region can be state, province, shire, oblast, etc (optional) Ω255 New York
country country of the poster. Not abbreviated (optional) Ω255 United States
tel Telephone number. Prefix with + and include country code, area code and number without any spaces, dashes or other characters (optional) Ω255 +177788825653

 

Elements of location, a sub-element of job. At least one location element is required

Element Description Example
place can be city, cbd, town, suburb, etc (optional, at least 1 from this table is required) Ω255 Manhattan
region can be state, province, shire, oblast, etc (optional, at least 1 from this table is required) Ω255 New York
country country of the poster. Not abbreviated (optional, at least 1 from this table is required) Ω255 United States
latitude geographic coordinates (optional) Ω32
30.27127
longitude geographic coordinates (optional) Ω32
-97.74103

 

Elements of categories, a sub-element of job. At least one categories element is required

Element Description Example
function The job's function category. Only 1 category can be listed, does not accept multiple categories Ω255 accounting
industry The job's industry category. Only 1 category can be listed, does not accept multiple categories Ω255 entertainment
type The job type category, e.g. part-time, full time, casual. Free text Ω255 part-time
location The job's location category. Only 1 category can be listed, does not accept multiple categories Ω255 New York

 

Elements of salary, an optional sub-element of job. At least one location element is required

Element Description Example
currency The currency for the salary offered, ISO code for currency Ω8 USD
from minimum value (floating point number) 1500.00
to maximum value (floating point number) 3000.00
benefits additional benefits offered. Free text, comma delimited list for multiple items Ω255 medical insurance, 4 week vacation

 

Example Feed

 


<jamit version="1.1" encoding="utf-8">
	<jamitKey></jamitKey>
	<jobsFeed>
		<title>Jamit Job Board Demo</title>
		<link>http://www.jamit.com/jobs/</link>
		<description>A demonstration of the Jamit Job Board</description>
		<pubDate>Thu, 14 Aug 2008 19:19:28 +0000</pubDate>
		<lastBuildDate>Thu, 14 Aug 2008 19:19:28 +0000</lastBuildDate>
		<generator>Jamit Job Board</generator>
		<managingEditor>test@example.com</managingEditor>
		<webMaster>webmaster@example.com</webMaster>
		<targetNiche>
			<industry>entertainment</industry>
			<function>accounting</function>
			<jobs_type>fill time</jobs_type>
			<skill></skill>
			<country>United States</country>
			<region></region>
			<lang>English</lang>
		</targetNiche>
		<job>
			<command>INSERT</command>
			<days_to_advertise>30</days_to_advertise>
			<refID>590</refID>
			<guid>http://www.example.com/jobs/job/590</guid>
			<post_mode>premium</post_mode>
			<application_url>http://www.example.com/jobs/job/590?apply=true</application_url>
			<pubDate>Thu, 14 Aug 2008 19:19:28 +0000</pubDate>
			<link>http://www.example.com/jobs/job/590</link> 
			<account>
				<username>test</username>
				<password>test</password>
				<accountEmail>account@jamit.com</accountEmail>
				<contact>
					<firstName>John</firstName>
					<lastName>Smith</lastName>
					<company>Jamit Software Limited</company>
					<address></address>
					<place></place>
					<region></region>
					<country></country>
					<tel></tel>
					<www_url>http://www.jamit.com</www_url>
				</contact> 
			</account>
			<title>Software Engineer (Senior)</title>
			<email>apply@example.com</email>
			<location>
				<latitude>30.27127</latitude>
				<longitude>-97.74103</longitude>
				<place>Manhattan</place>
				<region>New York</region>
				<country>United States</country>
			</location>
			<categories>
				<function>accounting</function>
				<industry>entertainment</industry>
				<type>part-time</type>
				<location>New York</location>
			</categories>
			<start>Thu, 14 Aug 2008 19:19:28 +0000</start>
			<duration>6 months</duration>
			<skills>php,mysql,javascript,html</skills>
			<postalcode>90210</postalcode>
			<posted_by>Jamit Software Limited</posted_by>
			<salary>
				<currency>USD</currency>
				<from>1500.00</from>
				<to>3000.00</to>
				<benefits>medical insurance, 4 week vacation</benefits>
			</salary>
			<immigration_status>citizen, permanent resident</immigration_status>
			<experience></experience>
			<description></description>
			<image_link></image_link>
		</job>
	</jobsFeed>
</jamit>



      

 

XML Export: Setting up the Jamit job board to export a feed in this schema

The jamit job board exporting feature can be used to export

To set one up,

1. Go to Admin->XML Export, and click the XML Schemas tab.

2. Click on the create 'Create New Schema' button.

3. Enter in the schema settings and save. (eg. For the name, enter 'Jamit XML 1.1)

4. Click in the 'Configure XML Structure' link, next to the schema setting that you just added

5. Click on the 'Import structure from CSV' link

6. Paste in the following CSV content from below and click save

 

 

 

(c) 2009 Jamit Software

------------------------

Go Back to the Jamit Job Board home page.