Processing Applications

Processing Applications

Delivery Mechanisms

The Apply Plugin allows you to receive an application in two ways: e-mail and HTTP POST. Using e-mail is simple to configure, but limits your ability to programmatically process the application, such as putting it into a database. In those cases, use HTTP POST to get the application in XML or JSON.

For email, use the data-email parameter. A summary of the user's application -- as well as his or her full profile in PDF format -- will be sent to the email address you specify. This is a great choice for small groups who just have a few listed jobs, or companies who are just getting started.

data-email="resumes@mycompany.com"

For HTTP POST, use the data-url parameter, optionally with data-urlFormat. This is a powerful choice for companies who want to process the application information and store it in their database. The default URL format is JSON, but you can choose to ask for "xml" instead.

data-url="http://my.company.com/rest/jobPosting" data-url="http://my.company.com/rest/jobPostingXml" data-urlFormat="xml"

JavaScript Callbacks for Clicks and Success

If you have the plugin on a page with other Javascript, you can optionally set two callback handlers for the plugin. To be alerted when a person has clicked on the plugin, set the data-onclick parameter to the name of a Javascript function on the page. Likewise, use the data-callback parameter to be alerted after the application is successfully submitted.

Both callbacks receive an object that contains two attributes. The event attribute is set to click or success. This lets you identify what happened.

The job attibute contains the configuration options of the plugin being used. This lets you identify what was called.

data-onclick="myOnclickFunction" data-callback="myCallbackFunction"

For example:

<script> function myOnclickFunction(r) { alert("click"); console.log(r); // do something here } function myCallbackFunction(r) { alert("callback"); console.log(r); // do something else here } </script> <script type="IN/LIApply" data-email="apply-test@yourdomain.com" data-jobTitle="Chief Cat Herder" data-onclick=myOnclickFunction data-callback="myCallbackFunction" > </script>

In this case, here's what's passed to the data-onclick callback:

1
2
3
4
5
6
7
{
   "event":"success",
   "job":{
      "companyName":"XYZ Company",
      "jobTitle":"Chief Cat Herder"
   }
}

Note: These values should not be the URL of another page to redirect to or reference a JavaScript function not on the original page. These are local functions that are on the application page. If you want to send data back to your server from them, for tracking or other purposes, use AJAX to make a request.

Process Results on your Server

If you chose email as your delivery method, you’re pretty much done. You'll receive a nicely formatted email for each application sent to the e-mail address you specify. You are encouraged to test the plugin to make sure that the e-mail address is working correctly.

If you chose to receive data via HTTP POST, then you need to parse the data structure we send you and feed it into your data pipeline. You can receive results via JSON (the default) or XML.

The data we're sending you is not form POST data. So, if your language or framework has a built-in way of handling forms, it will not work. Instead, you need to consider yourself as a simple REST Web service server that accepts the POST verb.

Here's the full schema for application data. You will need to parse and map all the relevant fields to your system.