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 &
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.
|