Knowledge Center

Introduction

In addition to the web-based job posting process, Dice offers an email-based batch posting system to allow automated job posting and avoid redundant data entry.

In order to allow clients to easily add, delete and update their job postings the batch posting system implements a "total replace" processing mode. Under that mode, batch files are assumed to include all jobs that the client intends to post, including those jobs that have been previously submitted. Any jobs not present in the batch posting file will be removed.

Also available is an "incremental" batch posting mode, where batches are comprised of one or more jobs a client wishes to add to their existing set of jobs. There is no way to delete jobs with an incremental batch. A client must submit a "total replace" batch or manually delete jobs to remove them.

Please note that your Dice ID is your Group ID.

Email Format

Batch posting requests must be submitted via email to dicejobs@dice.com. That email must include a plain-text batch file, as described below, and must contain only your batch posting username and password in the body. If you do not have a batch posting username and password contact support@dice.com to obtain one.
 

Example Batch Posting Message

Batch File Format

The batch posting file is a plain-text SGML file that defines the jobs you wish to post. The requirements for this file, a complete list of the required and optional tags and an example batch file, are provided below.
 

File Format Requirements

Type: .txt or compressed .txt files into .gz
Size Limit: 10mb

• Batch files must be submitted as an email attachment
• Batch files must be plain-text files (i.e. not MS Word documents)
• Batch file names must contain only standard characters and must not contain any spaces
• Each batch file must contain jobs for only one Dice ID
• Each batch file must contain at least one job
• Each tag must appear on a line by itself
• Each tag must start on the first column of a line
• There must be no space between the tag name and its bracket (e.g.<title> not < title >)
• Except for the <comment> tag, no tag may contain a line break and the field contents and closing tag must be on the same line as the opening tag
• The first line of the file must read exactly: <!doctype batch totalreplace> for total replace batches
• For incremental batches <batch> for incremental
• Each job definition begins with a <doc> tag and ends with a </doc> tag, and all other tags related to that job must appear between those tags
• The order of tags within the <doc> and </doc> tags is not important
• The characters < and > must be expressed as &lt; and &gt; respectively if used within a tag value
   

Required and Optional Tags

<basecompensationcurrency>USD</basecompensationcurrency>

<positionid>1234</positionid>

<diceid>yourgroupid</diceid>

<email>hr@dice.com</email>

<jobtitle>Integration Engineer</jobtitle>

<comments>
Combines software development and solutions
architecture with sales &lt;BR&gt;
engineering to solve related data sharing
challenges while supporting both the internal
and &lt;BR&gt;
external customers in the integration and
expansion of the Company's product offerings.
</comments>

<taxterm>CON_W2</taxterm>
<taxterm>TEMP</taxterm>

<allowrecruiterapplies>Y</allowrecruiterapplies>

<country>US</country>
    or:
<country>CA</country>

<state>IA</state>
    or:
<state>AB</state>

<postalcode>50322</postalcode>

<location>Urbandale</location>

<remote>Y</remote>

<areacode>515</areacode>

<telecommute>N</telecommute>

<travel>0</travel>

<company>Dice, Inc.</company>

<companystate>IA</companystate>

<companycity>Urbandale</companycity>

<companyzip>50322</companyzip>

<addr1>4101 NE Urbandale Dr.</addr1>

<addr2>PO BOX 1234</addr2>

<url>http://www.dice.com/</url>

<recruiter>Rolan D. Dice</recruiter>

<recruiteremail>roland@dice.com</recruiteremail>

<applylink>http://example.com/job?ID=1</applylink>

<joblength>Full Time</joblength>

<payrate>$75,000 - $95,000</payrate>

<basecompensationmin>50000</basecompensationmin>

<basecompensationmax>100000</basecompensationmax>

<basecompensationunit>HOUR</basecompensationunit>

<skillsreq>Perl, HTML, JavaScript</skillsreq>

<trackingpixel>&lt;img style="display: none;" src="tracking url here" /&gt;</trackingpixel>

<screenerid>1990</screenerid>

File Format Notes

• Each total replace batch file must contain all jobs you wish to post. Any jobs currently posted but not in the batch posting file will be removed. Incremental batch files will not remove jobs already posted.
• Leading and trailing white space is removed from all fields before processing. However, linebreaks within the <comment> tag will be respected after leading and trailing white space is removed.
• Position IDs must be unique. If a position ID is duplicated within the batch only one of the jobs with that ID will be posted.
• The characters < and > must be expressed as &lt; and &gt; respectively. Failure to escape these characters will prevent the batch from processing.
• A batch file must contain jobs for only one Dice ID, and that Dice ID must be associated with the batch posting username.

Example Batch File

<!doctype batch totalreplace>
<doc>
<positionid>1234</positionid>
<diceid>yourdiceid</diceid>
<taxterm>FULLTIME</taxterm>
<allowrecruiterapplies>Y</allowrecruiterapplies>
<country>US</country>
<state>IA</state>
<postalcode>50322</postalcode>
<location>Urbandale</location>
<remote>Y</remote>
<areacode>515</areacode>
<telecommute>N</telecommute>
<travel>0</travel>
<company>Dice, Inc.</company>
<companystate>IA</companystate>
<companycity>Urbandale</companycity>
<companyzip>50322</companyzip>
<addr1>4101 NE Urbandale Dr.</addr1>
<url>http://www.dice.com/</url>
<recruiter>Rolan D. Dice</recruiter>
<recruiteremail>roland@dice.com</recruiteremail>
<phone>(515) 280-1144</phone>
<ext>1234</ext>
<fax>(515) 280-1452</fax>
<altphone>(877) 386-3323</altphone>
<email>hr@dice.com</email>
<joblength>Full Time</joblength>
<payrate>$75,000 - $95,000</payrate>
<basecompensationmin>50000</basecompensationmin>
<basecompensationmax>100000</basecompensationmax>
<basecompensationunit>HOUR</basecompensationunit>
<jobtitle>Integration Engineer</jobtitle>
<skillsreq>Perl, HTML, JavaScript</skillsreq>
<comments>
Combines software development and solutions architecture with sales
&lt;BR&gt;engineering to solve related data sharing challenges while supporting both the internal and
&lt;BR&gt;external customers in the integration and expansion of the Company's product offerings.
</comments>
<trackingpixel>&lt;img style="display: none;" src="tracking url here" /&gt;</trackingpixel>
<screenerid>1990</screenerid>
</doc>
<doc>
...Another job for yourdiceid...
</doc>

Batch Posting Report

Each time a batch posting is processed a report that details the number of jobs processed and any errors that may have occurred will be returned to the email address that submitted the batch. This report can be used to confirm that your jobs are being posted as you intended.

Sample Batch Posting Report