Skip to content

Downloading and Configuring

Jump to bottom
Kameron Sween edited this page Feb 23, 2016 · 29 revisions

The first step in the deployment process is to download and configure a Bullhorn Career Portal release package, as described below:

1. Download the latest release of Bullhorn Career Portal

The latest stable version of Bullhorn Career Portal can be found under the Releases topic at the Bullhorn Career Portal GitHub Home Page. Click on the Latest Release link:

releases topic

The Release Page will display. Click the career-portal-v[x.y.z].zip link and your browser will download and save a Zip archive onto your hard drive. Make note of where the archive was saved:

release page

2. Extract Bullhorn Career Portal files from the Zip Archive

Locate the downloaded Zip Archive from step (1) in Windows File Explorer or other file system viewer. Extract its contents to the same location on your hard drive. On Microsoft Windows, this can be done by right-clicking on the saved Zip file and selecting Extract All... from the context menu:

extract a zip archive

3. Configure settings in the application configuration file

Navigate to the extracted folder and open the app.json file up in a text editor such as Microsoft Notepad:

open the app config file

The file contents will look like this:

app.json configuration template

Locate and update the following values:

  • [ COMPANY NAME HERE ] - A string representing the name of your company, or another identifier which will appear in the masthead of list and card view.*
  • [ CORP TOKEN HERE ] - A string which identifies your company when accessing the Bullhorn REST API. This information can be provided by a Bullhorn Customer Specialist.*
  • [ SWIMLANE HERE ] - A quoted number which identifies the production environment for your company's ATS/CRM instance. This information can be provided by a Bullhorn Customer Specialist.*

*This information must be obtained from Bullhorn Customer Support by creating a support ticket using the Bullhorn Resource Center. To create a support ticket, log into Bullhorn and navigate to Menu --> Support --> Bullhorn Resource Center.

By default, your Bullhorn Career Portal is configured with a display language and date format in accordance with the en-US (English - United States) locale. To localize your Bullhorn Career Portal to a language and date format matching your region, change the value of the defaultLocale configuration key to one of the following:

  • en-GB - English (United Kingdom)
  • en-EU - English (European Union)
  • fr-FR - French (France)

If you require support for a locale not listed here, please submit a GitHub issue.

###Apply with LinkedIn

Bullhorn Career Portal supports Apply with LinkedIn. This feature allows users to apply to jobs with their LinkedIn profile instead of manually uploading a resume. To enable this feature, you need to register as a LinkedIn integration partner, create and configure a new LinkedIn partner application and configure an additional value in app.json:

  • [ CLIENTID HERE ] - A string representing the LinkedIn Authentication Client Id for a given LinkedIn partner application

Registering as a LinkedIn integration partner can take up to 15 days. When configuring your newly created LinkedIn partner application, select r_fullprofile, r_contactinfo and r_emailaddress default application permissions (located on the Authentication page) for best results. Additionally, you will need to whitelist the domain(s) where your Bullhorn Career Portal is hosted by adding one or more values to the Valid SDK Domains input located on the JavaScript Settings page.

Apply with LinkedIn is an optional feature and may be activated at any time. Activating this feature does not preclude users from applying via resume upload if they so choose. If you do not provide a value for the [ CLIENTID HERE ] configuration token, the Apply with LinkedIn feature will not be activated, and users may still apply via resume upload.

iOS 5+ Incompatibility

Unfortunately, LinkedIn's JS SDK is incompatible with iOS 5+ due to the way that Javascript is paused during cross-window communication processes. Therefore, the Apply with LinkedIn feature is not supported in that runtime environment. Users will experience an apply workflow that simply excludes the Apply with LinkedIn feature.

Unable to register as a partner with LinkedIn?

Our platform is still compatible without the partner registration; however, the data a partner can request is far more robust than the information that a non-partner can request. For example: as a partner LinkedIn will grant you access to all previous positions for a user that applies with their LinkedIn. As a non-partner, you will only be granted access to their last position. There are dozens of other data fields omitted, so it's advantageous to become a LinkedIn Partner by following the steps above.

To obtain a Client ID from LinkedIn without becoming a partner, sign up for a developer account in their developer portal. Note: You will need to be signed in with your account to get to this section. From there, click on the Create Application button. Once all the information for an application has been filled out, you will be given a developer Client ID. Make sure to check the boxes to get the r_basicprofile and r_emailaddress permissions and save your new Application. Take that Client ID and add it to your app.json.

Once configured, your 'app.json' file will look similar to the following:

app.json configuration example

Save the file.

That's it! Your configured Bullhorn Career Portal package is ready to be uploaded to your site host. See the Uploading pages for more information on completing the hosting process.

Clone this wiki locally