ATS v1: Data Model

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.

This article applies to ATS v1s using the ATS v1 data model only.

Overview

In the ATS v1 Data Model, every stage is represented by a separate Custom Object and records are generated in the background against that Object every time a candidateClosed A person looking for a job. A candidate can also be referred to as a Job Seeker, Applicant, or Provider. is moved. This article walks through the process of relating JobsClosed A job (vacancy, position, role) is an opening for which a customer's client needs a placement. and CandidatesClosed A person looking for a job. A candidate can also be referred to as a Job Seeker, Applicant, or Provider. to the various jobClosed A job (vacancy, position, role) is an opening for which a customer's client needs a placement. stages and tracking what stages a candidate goes through relies on a Custom Junction Object called Job Reporting.

If Job Reporting records are inaccurate or incomplete, moving a Candidate through the Bullhorn ATS may result in an error message.

Move To Stage Process

Available Stages:

Status in Stage:

  • C = Current
  • A = Accepted
  • R = Rejected

When a Candidate or Job CardClosed If in the context of ATS, a 'card' or 'tile' is the visual representation on the ATS board of a Candidate at various stages of the application process is moved to a stage, two actions occur:

When a stage record is created or updated, the Job Manager Stage Status of the Candidate will always be set or updated. For any Candidate, there should only be one record related to a single job with a status of Current at a given time and any other stage record should be Accepted or Rejected.

The Job Reporting Object

Job Reporting has a Master-Detail relationship to Job and Lookup relationships to Contact, Application, Submittal, Send Out, Offer and Closing Report. The Composite Key field stores the ContactID+JobID and is used to make the correct association of Candidate and Job.

A Job reporting record is created or updated in the background for every Move To Stage action. The Job Reporting Related List does not need to be on the page layout as end users do not need to interact with it, but System Administrator need to be aware of it as it is useful for reporting and troubleshooting purposes.

Troubleshooting

  • If any of the Job Stage records are deleted, the corresponding Job Reporting record(s) must be deleted manually. Not doing this will result in bad data in the system and cause errors or Candidates being associated to incorrect stages or visualized incorrectly in Bullhorn ATSKanban.
  • If any Candidate on a Job has a duplicate Job Reporting record it may prevent that or any other Candidate from being moved to a different stage on the Job.