Skip to content

Downloading and Configuring

Jump to bottom
kbushkoBH edited this page Nov 14, 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.

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.

  1. To enable this feature, navigate to https://developer.linkedin.com/ and select My Apps. If you are not already logged into LinkedIn, you will need to enter your credentials to proceed. Once you are logged in, select Create Application to begin your Apply with LinkedIn setup.

  2. From the Create a New Application page, enter your Company Name and Name - these fields can contain the same value, but the Name field represents what applicants will see when using the App on your portal: “[Name] would like to access some of your LinkedIn info.”

  3. Enter the Description of your application as “Apply with LinkedIn for Bullhorn Career Portal.” Supply a square logo meeting the requested specifications, and enter the Website URL for your career portal in the format of https://www.domain.com/directory or https://directory.domain.com, referencing the directory to which you will upload the portal.

  4. Select “Jobs and Recruiting” for Application Use and “Browser Locale Setting” for Legal Agreement Language, then specify contact information for your company in the Business Phone and Business Email fields. Click Update to save and proceed.

  5. Once the initial application information has been updated, you will be directed to the Authentication page, where you will see the Client ID at the top. Copy this Client ID into your app.json file in place of [ CLIENTID HERE ] under the “integrations > linkedin” section. Default Application Permissions on the Authentication page should include r_basicprofile and r_emailaddress, but if these items are not checked, check them and click Update at the bottom of the page.

  6. Finally, before you leave the LinkedIn developer site, select the JavaScript option in the left side menu to add the Website URL for your career portal to the Valid SDK Domains list. Ensure that you click Add and then Update to save your URL and whitelist it for use.

To request access to more complete LinkedIn information from your applicants, such as r_fullprofile and r_contactinfo, send an email as outlined below, replacing the sample values in the message body with your own information. These additional application permissions provide more complete work history and contact information for the applicant when available.

To: [email protected]

Subject: Please enable my Client ID for Apply with LinkedIn with Bullhorn

Company Name - ACME Staffing

Contact Full Name - Jane Acme

Contact E-Mail - [email protected]

LinkedIn Client ID (API key) - abcd1234

iOS 5+ Incompatibility

Please note that 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. iOS users will experience an apply workflow that simply excludes the Apply with LinkedIn feature. Android and desktop users are unaffected by this limitation.

###Check your app.json file

Once configured, your app.json file will look similar to the following. Please note that the brackets in the default file should be removed where you have added values for corpToken, swimlane, and clientId.

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. Directions are not provided for every possible site host, but Uploading via Site Host FTP is the easiest and most commonly accessible option.

Clone this wiki locally