1. Implementation
HR-ON Recruit is a web service, or a software-as-a-service (SaaS) solution, operated in the “cloud” by HR-ON. Therefore, no software installation is required on your side. Your specific version of HR-ON Recruit is implemented by inserting a script on your website (see example below).<!--HER STARTER SCRIPT / SCRIPT BEGINS HERE v1-->
<script src="https://recruit.hr-on.com/frame-api/hr.js" type="text/javascript"></script> <div id="hr-on"><noscript>This page requires javascript<br /></noscript></div>
<script src="https://recruit.hr-on.com/frame-api/customers/virksomhedsnavnjs"
type="text/javascript"></script>
<!--HER SLUTTER SCRIPT / SCRIPT ENDS HERE-->
The div with id=”hr-on” is the container that HR-ON Recruit dynamically fills with content. When you insert scriptname.js, it automatically fetches the required scripts and data for display from our servers.
The principle is the same as the one used by Google Maps. The major advantage is that you don’t need to implement anything on your own servers, and this system is entirely independent of the platform you use for your website. For the end user, it looks as if HR-ON Recruit is running as an integrated part of your website.
The visual appearance of the career page can be customized directly in HR-ON Recruit under Settings > Career page. Here, you can configure your career page so it matches the look and feel of your website.
We generally recommend that you start by implementing the script on a test page, so you can preview how it will look on your website before going live. For example, this test page could be:
https://www.companywebsite.com/job-test
Once everything has been tested and is working properly, switch to your public job page:
http://www.companywebsite.com/job
2. Alternative implementation solutions
The above is our recommended standard solution, used by the vast majority of our customers. The technical implementation of this solution is typically completed within a single day by inserting the script on your website.
It is also possible to pull content onto your site via a JSON feed. This solution takes a little longer and requires adjustments from both parties. If such a solution is necessary or desired, this will be agreed upon between HR-ON and your IT department.
2.1 JSON feed
HR-ON Recruit offers the option of implementing the system via our JSON feed. To access the feed, you need to have a key created in our system.
2.1.1 Job list with all jobs
The feed is available at the following URL:
https://recruit.hr-on.com/api/jobs/KEY
Where KEY is replaced with the unique key provided to you.
The above URL returns a JSON object containing a “JOBID” object for each job in the job list as follows:{
"JOBID": {integer -The job posting’s ID in HR-ON Recruit – always unique,
"locale":language and country code - e.g. da_DK or en_US,
"locationwork":string - city name, e.g. Odense C,
"applybefore":string - application deadline,
"title":string - job title,
"shortdescription":string - short description to use on frontpage,
"description":html - actual job description in html,
"contacts": [array - list of contacts attached to the jobt
{
"image":string - url for image of person. Can be used directly in img-tag,
"name":string - contact name,
"email":string - contact e-mail",
"phone":string - contact phone no,
"mobile":string - contact mobile no,
"title":string - contact title
}
],
"applyform":html - actual code for the apply button that creates the application form in iframe
} ,
}
If you specify the GET parameter locale, the job list will be filtered to only display postings matching that language.
For example:
https://recruit.hr-on.com/api/jobs/KEY?locale=da_DK
will only return job postings in Danish.
Other GET parameters can also be set, depending on your needs. These are unique for each customer, so please let us know if you want a specific configuration. Additional information on job postings can also be added to the feed upon agreement.
2.1.2 Individual jobs
An individual job can be retrieved at the following URL:
https://recruit.hr-on.com/api/jobs/KEY/JOBID
Where KEY is replaced with your unique key and JOBID with the id of a specific job.
This URL returns a JSON object like this: {
"locale":language and country code - e.g. da_DK or en_US,
"locationwork":string - city name, e.g. Odense C,
"applybefore":string - application deadline,
"title":string - job title,
"shortdescription":string - short description to use on frontpage,
"description":html - actual job description in html,
"contacts": [array - list of contacts attached to the jobt
{
"image":string - url for image of person. Can be used directly in img-tag,
"name":string - contact name,
"email":string - contact e-mail",
"phone":string - contact phone no,
"mobile":string - contact mobile no,
"title":string - contact title
}
],
"applyform":html - actual code for the apply button that creates the application form in iframe
} ,
2.1.3 Application form
For each job in the feed, the key applyform is available. The output loads an iframe showing the application form from HR-ON’s servers.
If special styling of the application form is desired, this can be achieved in two ways:
- Call the feed with a GET parameter
cssfile, which contains a link to a CSS file on your server, e.g.:
https://recruit.hr-on.com/api/jobs/KEY?cssfile=https://customerwebsite.com/style.css
The styling from this file will automatically apply to the application form. - Specific styling requests can be forwarded to HR-ON Support, and our developers will set it up as requested.
2.1.4 Caching
If you set up caching of HR-ON’s content, please inform us of the update interval. Kindly write to [email protected] regarding this.
2.1.5 Be aware if there is no content
We recommend that you implement a fallback for situations where there is no output from HR-ON – for example, if there are no vacancies, or if HR-ON is unexpectedly unavailable when you attempt to fetch content.
2.2 API
It is also possible to fetch content onto your site via an API. If such a solution is desired, this will be agreed upon between HR-ON and your IT department.
2.2.1 API access
HR-ON Recruit allows you to create API keys directly in Recruit. This is available under Settings > API, where you can create a Client ID and secret.
2.2.2 Documentation
Available at the following URL:
https://recruit.hr-on.com/json/api/docs/
Here, you will also find information on authentication and creation of access tokens.
3. Browser and platform compatibility
HR-ON Recruit is tested and works in all browsers – the latest version and three versions back.
HR-ON uses object-oriented JavaScript and codes according to standards. Where a browser does not comply with the standards, fallback code is applied – meaning the script first attempts to use the standard code, and if that does not work, it falls back to browser-specific code.
This ensures that as browsers become standards-compliant, they will automatically use the standard code – which is especially relevant for older versions of Internet Explorer.
4. Data and security
HR-ON’s data is hosted in one of the largest and most secure data centers in the EU. Additionally, daily audited backups are taken on a server physically located in another EU country.
All traffic between you and HR-ON is encrypted via SSL. HR-ON runs in your browser, and it is your responsibility to always keep your own installation up-to-date and secure.
No software needs to be installed on your side in connection with the use of HR-ON. HR-ON therefore has no access to your other IT systems.
← Previous Next →
General Design: Buttons and links Company Account and departments