: External Search User Guide
This guide is specific to Candidate A person looking for a job. A candidate can also be referred to as a Job Seeker, Applicant, or Provider. and Job A job (vacancy, position, role) is an opening for which a customer's client needs a placement. Search see the Textkernel Search + Match: Candidate and Job Search User Guide.
External Search. For internalOverview
The External Job Board A website where open jobs are advertised Search tabs give users access to search all External Job Boards that has partnered with that the user also has credentials for. For external job boards that allow candidate data to be downloaded, the Import Candidates 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 via .
This article shows you how to use the external search in
.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 Credentials In BH4SF, normally used in the context of a login page or access to some feature Management tab within the Org.
- Navigate to the External Job Board Credentials Tab in Salesforce.
- Click Enter credentials to the right of the desired job board.
- Enter the requested credentials.
- 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.
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
for candidates appearing in results.- Select one or more candidates from the search results.
- Click the Actions button and choose Import Profile.
- The import status can be monitored using the widget in the lower right corner or in the TK An abbreviation for Textkernel Candidate Import Request object records.
When an import is started, XML 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 uses the resume and XML document to create the Contact record, along with corresponding Employment History, Education History, Skill, and Contact Document related records.
returns the candidate’s resume from the selected external job board, along with anThe 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
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
. 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 API 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 Parsing 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 jobs 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.
search environment has a limit of 10 concurrentSupported External Job Boards
has partnered with to make a number of Job Boards available in but there is a cost involved with enabling them since adding any job boards requires additional licenses. The job boards are not included in the standard configuration. These job boards have an Integration Type of 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
.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 SSO 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, client A Company is the organization where the contact works. This can also be called the Client. ID and client secret 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.) |
|
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 |
|
DE |
Direct |
No login |
No credentials, search via Google |
No |