Textkernel Search + Match: External Search User Guide

Note: To take advantage of the features mentioned in this documentation, your Org needs to be using (Undefined variable: bh4SFVersions.Latest Package Version) or newer. See Release Notes for more details about which features were introduced in each release. If you would like to upgrade to the current release, contact Bullhorn for Salesforce Support.

Overview

The External Job BoardClosed A website where open jobs are advertised Search tabs give users access to search all External Job Boards that Textkernel has partnered with that the user also has credentials for. For external job boards that allow candidate data to be downloaded, the Import CandidatesClosed A person looking for a job. A candidate can also be referred to as a Job Seeker, Applicant, or Provider. functionality allows users to import a candidate from an external search into Bullhorn for Salesforce via Search and Match.

This article shows you how to use the external search in Textkernel.

User Credentials

System Administrators need to configure each External Job Board before users are able to search. In most cases, Administrators will enter credentials as part of configuration. For full configuration information see Textkernel Search + Match: External Searches and Import Candidates Configuration Guide.

For some job boards each user will need to enter their personal credentials in the Job Board CredentialsClosed In BH4SF, normally used in the context of a login page or access to some feature Management tab within the Org.

  1. Navigate to the External Job Board Credentials Tab in Salesforce.
  2. Click Enter credentials to the right of the desired job board.
  3. Enter the requested credentials.
  4. Click Save.

External Job Board Credentials shows all the external job boards the user has been enabled to use and provides the following statuses:

Scenario

Credentials Message

Status

The admin has entered credentials, the recruiter doesn’t have to

Available

Entered by Admin

The admin has not entered credentials, the recruiter can’t do anything

Credentials needed

Contact your Admin

The recruiter has to enter credential

Credentials needed

Enter credentials

The recruiter has entered credentials

Available 

Enter credentials

The credentials give an error or are expired, the recruiter has to update them

Invalid credentials

Enter credentials

The job board doesn’t require credentials

Available 

Not required

Performing a Search

Searching is performed the same way as Candidate Searches within the Org, by entering a keyword into the search bar and further fine tuning the search using breadcrumbs and facets. See theTextkernel Search + Match: Candidate and Job Search User Guide for more details about searching.

Search results are displayed as a separate tab for each configured Job Board, showing the board logo and a count of how many results have been returned.

There are several actions available after candidates have been selected on the search results page of external job boards:

  • The Actions button allows a user to Import Profiles or Export to Excel. If a job board doesn’t allow resumes to be downloaded then View Profiles will be displayed instead.
  • Save to Project is used to save candidates to a new or existing project. This functionality is the same as an internal Candidate Search.
  • Compare Candidates can be used to view multiple candidates side-by-side. This functionality is the same as an internal Candidate Search.

Import Candidates

Be aware that some job boards charge for resume downloads. Bullhorn for Salesforce is not responsible for any extra cost incurred by users.

For external job boards that allow candidate data to be downloaded, the Import Candidates functionality lets users create a Contact record in Bullhorn for Salesforce for candidates appearing in Textkernel Search + Match results.

  1. Select one or more candidates from the search results.
  2. Click the Actions button and choose Import Profile.
  3. The import status can be monitored using the widget in the lower right corner or in the TKClosed An abbreviation for Textkernel Candidate Import Request object records.

When an import is started, Textkernel returns the candidate’s resume from the selected external job board, along with an XMLClosed Used to create custom markup languages in order to display information on the Internet. We use XML when sending jobs to Indeed for syndication. document that is used to create a Contact in the Org. The resume parser built into Bullhorn for Salesforce uses the resume and XML document to create the Contact record, along with corresponding Employment History, Education History, Skill, and Contact Document related records.

The import uses the resume parsing logic to create a Contact and related records. If a duplicate Contact is found, the existing record will be updated with the values from the resume, otherwise a new Contact will be created.

Import Status

When an import is started, a record for the request is created on the TK Candidate Import Request object for each candidate being imported.. The progress of the Import Candidate process can be checked on both the widget within Search and Match and on the TK Candidate Import Request record Status field.

  • Queued: Only one candidate is selected for import and the queueable job is not yet running.
  • Scheduled: Multiple candidates are selected for import and they will be imported via Apex batch job which runs every 10 minutes.
  • Completed: The import has finished and a Contact record has been created.
  • Failed: The import failed and an error message is displayed.

Admin Note:

If only one candidate is selected, a queueable job will process that single record, while if multiple candidates are selected a batch job will process multiple records one after the other. The Apex batch job is called BHTK_CandidateImportBatch and runs every 10 minutes.

Import Limitations

There is a delay from when the Import Profile button is clicked and when the Candidate record is created in the Org. The amount of time needed depends on the number of records requested for import. Records are processed one by one, so a record at the end of the queue will take longer than those near the front. The expected pace is 200-250 imports per hour. The average size of resumes being requested and response time from the external job board being used are also factors in the delay.

For some external searches the data provided is valid for only a limited time. If a candidate is scheduled for import but the processing of that candidate doesn’t start for several hours the candidate may not be imported. For example, if there are 600 candidates scheduled for import and a user schedules several more candidates it is likely those candidates will have a processing time of more than 2 hours and the import will fail.

Admin Note:

Each Textkernel search environment has a limit of 10 concurrent APIClosed API, or Application Programming Interface, is used by customers to create custom career portals or to take advantage of Data Mirror/DataMart. Bullhorn prefers to use REST API. requests. Any indexing, Resume ParsingClosed A process which converts an unstructured form of resume data into the structured format., or Candidate Import requests count toward the limit. If more than 10 requests are sent simultaneously some requests will fail. The Candidate Import functionality uses 2 out of the 10 concurrent requests, one each for the BHTK_CandidateImportBatch and the BHTK_CandidateImportQueueable Apex jobsClosed A job (vacancy, position, role) is an opening for which a customer's client needs a placement.. This means that only one queueable job can be running at any given time. For example, if a user selects Candidate A for import but the queueable job is already processing Candidate B, then Candidate A will be processed by the batch job instead, which will take longer.

Supported External Job Boards

Textkernel has partnered with Broadbean to make a number of Job Boards available in Search and Match but there is a cost involved with enabling them since adding any Broadbean job boards requires additional licenses. The Broadbean job boards are not included in the Search and Match standard configuration. These job boards have an Integration Type of Broadbean in the chart below.

Job Boards that use Google API for search require customers with over 100 users to have their own Google API to access those sources through Search and Match.

Important: Textkernel has total control of which external job boards are available in the Portal integration. While every effort is made to keep our documentation up to date, it is possible that some changes go unrecorded. Please always confirm directly with Textkernel the availability of the external job board(s) you are interested in.

Source / Board

Country

Integration type

Authentication Type

Credentials

Allow CV Export?

CareerBuilder

US, UK, SE

Direct

User

CareerBuilder credentials

Yes (Only via the Search UI due to CB SSOClosed Single Sign On is an authentication process that allows a user to access multiple applications with one set of login credentials.. Not via the API.)

CareerStructure

UK

Broadbean

User

Username, password

Yes

CV Library

UK

Broadbean

User

Registered_email, Username, password

Yes

CWJobs (Computer Weekly)

UK

Broadbean

User

Username, password

Yes

Dice

US

Direct

User

Username, password, clientClosed A Company is the organization where the contact works. This can also be called the Client. ID and client secretClosed Similar to a username, a client secret is sed in conjunction with the client ID to gain REST API access.

No

EfinancialCareers

UK

Broadbean

User

xml_apikey

Yes

GitHub

BE, DE, FR, NL, PL, UK, US, SE, CH

Direct

No login

No credentials, search via Google

No

Jobs.de (CareerBuilder)

DE

Direct

User

CareerBuilder credentials

Yes (Only via the Search UI due to CB SSO. Not via the API.)

Jobserve

UK

Broadbean

User

Account nr and authorisation code

Yes

Jobsite

UK

Broadbean

User

Agency_id, email

Yes

Les Jeudis

FR

Direct

User

CareerBuilder credentials

Yes (Only via the Search UI due to CB SSO. Not via the API.)

LinkedIn

AE, AU, AT, BE, CH, CA, DE, FR, HU, NL, NZ, US, UK, PL, PT, SA, SG, SE

Direct

No login

No credentials, search via Google

No

Monster

AU, CH, DE, FR, NL, UK, US

Direct

account or User

CAT code

Yes

Nationale Vacaturebank

NL

Direct

account or User

Not needed

Yes

Intermediair

NL

Direct

account or User

Not needed

Yes

Oil and Gas Job Search

MULTI

Broadbean

User

Username, password

Yes

Recruitment Edge 

US

Direct

User

CareerBuilder credentials

Yes (Only via the Search UI due to CB SSO. Not via the API.)

Reed

UK

Broadbean

User

Username, posting_key

Yes

Resume-Library 

US

Broadbean

User

Account ID and account key

Yes

StackOverflow

BE, DE, FR, NL, PL, SE, US, UK, CH

Direct

No login

No credentials, search via Google

No

Staff Nurse / Jobmedic 

UK

Broadbean

User

Email, password

yes (Only via the Search UI due to CB SSO. Not via the API.)

TotalJobs

UK

Broadbean

User

Username, password

Yes

VDAB

BE

Direct

account or User

Client ID

No

Viadeo

FR

Direct

No login

No credentials, search via Google

No

Xing

DE

Direct

No login

No credentials, search via Google

No