ATS v2: Customizing Candidate Stages

Overview

There are several customizations available for Candidate A person looking for a job. A candidate can also be referred to as a Job Seeker, Applicant, or Provider. Stages within ATS v2 including adding, removing, and renaming stages. This article walks you through how to add, remove, and rename stages.

Add a New Stage

1. Add the new stage name as a picklist value in the TR1__Stage__c picklist field within the Application V2 A Bullhorn Recruitment Cloud custom object introduced when new data model ATSv2 was added to the core product object.

2. Enable the new picklist value for all relevant Record Types

   The package includes the following Record Types:

   Consulting

   Fixed Term BookingClosed

   Permanent

   Retained

   If any custom JobClosed Record Types have been added in your Org, ensure that you also add the same Record Type to the ApplicationClosed V2 object and the Closing ReportClosed object. Then, enable your new stage picklist value for the custom record type(s)

3. Run the following line of script in the Developer Console by clicking the Setup icon at the top right of screen, and then Developer Console. Go to Debug > Open Execute Anonymous Window and enter the following: TR1.RecordTypePicklistDescriber.refreshPicklistMetadata();
   

4. The stage sequence is defined in the following location: Setup > Custom Code > Custom Setting > ATS Job A job (vacancy, position, role) is an opening for which a customer's client needs a placement. AppV2 Picklist Mapping > Entry per Record Type (EX: Permanent) > Applicable Stages.

5. If the above setting is not configured for the Record Type, the sequence of the picklist values in the TR1_Stages_c field on the Application First stage of Job placement flow (Application> Submittal>Interview>Offer> Placement) V2 object is used.

6. Go to Application page layout in Application V2 object and create a new section with Stage Name Details. After doing this, add the related fields under this section.
7. Set up a data entry page for the newly created stage (if required):
   • Create a new Field Set in the Application V2 object and add the required fields to the Field Set for the data entry page.
   • Create a new ATS New Stage Config Custom Metadata Type entry with the following:
     • Label: Any Label name
     • FieldSetName: 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. Name of the new Field Set
     • StageName: Stage Name
8. Add the appropriate Job stage banner (stage icon) for the newly created stage in Setup > Static Resources.
   • Create a new static resource with the name ATSv2 In Bullhorn Recruitment Cloud, the newest version of the ATS tool (Application Tracking System)_ + your new stage name.
   • Upload the banner image for your new stage under the Static Resource.
   • If the stage name includes two words (such as Final Decision), then combine both words and add a prefix string in the Static Resource name (ATSv2_FinalDecision).

Remove an Existing Stage

1. Remove the Stage Name from the TR1__Stage__c picklist values in the Application V2 object.
2. Go to the Application page layout in the Application V2 object and remove the related section.
3. Run the following line of script in the Developer Console by clicking the Setup icon at the top right of screen, and then Developer Console. Go to Debug > Open Execute Anonymous Window and enter the following: TR1.RecordTypePicklistDescriber.refreshPicklistMetadata();

4. The stage sequence is defined in the following location: Setup > Custom Code > Custom Setting > ATS Job AppV2 Picklist Mapping > Entry per Record Type (EX: Permanent) > Applicable Stages.

   • If the above setting is not configured for the Record Type, the sequence of the picklist values in the TR1_Stages_c field on the Application V2 object is used.

5. After running the script, check the log for a success message.
6. Refresh the page to view the update.

Rename an Existing Stage

Via Translation Workbench

1. Go to Setup >Translation Workbench and click Translate:
   • Select the appropriate language.
   • In the Setup Component drop-down, select Picklist Value.
   • In the Object drop-down, select Application V2.
   • Click the plus icon (+) next to a stage to expand the view.
2. Add a new label for each stage in the Picklist Value Label Translation column.
3. Save the changes.
4. Update the relevant Custom Labels by going to Setup > Custom Labels to find the related custom label for the stage. Below are all the Custom Labels created for each stage.
   •  Custom Label Name Value:
     • ATS_Submittal The Second Stage of Job application flow. This is when the recruiter sends the Candidate CV to the client, a sort of first introduction._Stage Submittal
     • ATSv2_Offer The fourth Stage of Job application flow. This is when the candidate is offered the position (details about salary, locations etc are shared and candidate decides if he wants to take the job)_Stage Offer
     • ATSv2_Send_Out_Stage Send Out The third Stage of Job application flow. This is when the recruiter sets up a job interview between Candidate and Client.
     • ATSv2_Closing_Report_Stage Closing Report Fifth Stage of Job placement flow, a Candidate that reaches the Closing Report Placement stage has been assigned to a job. In Bullhorn Recruitment Cloud, a 'Closing Report' is a record that captures all the information related to the newly filled position (name of Candidate, position, salary, start date, which recruiter gets credit for the hire etc.)
     • ATSv2_Application_Stage Application
     • ATSv2_Internal_Interview The third Stage of Job application flow. This is when the recruiter sets up a job interview between Candidate and Client._Stage Internal Interview

Via Database

1. Go to the Application V2 object and search for the Stage__c field and click on it.
2. Every stage appears here so click Edit next to the desired stage name.
3. Add the new value for the stage.
4. Save the changes.
5. Update the relevant Custom Labels by going to Setup > Custom Labels to find the related custom label for the stage. Below are all the Custom Labels created for each stage.
   • Custom Label Name Value:
     • ATS_Submittal_Stage Submittal
     • ATSv2_Offer_Stage Offer
     • ATSv2_Send_Out_Stage Send Out
     • ATSv2_Closing_Report_Stage Closing Report
     • ATSv2_Application_Stage Application
     • ATSv2_Internal_Interview_Stage Internal Interview

Closing Report Stage

If you are renaming or translating the Closing Report stage, you will also need to add the new Closing Report stage name to the following Custom Labels:

Add Banner

1. Go to Setup > Static Resources.
2. Create a new static resource with the name ATSv2_ + your new stage name.
3. Upload the banner image for your new stage under the Static Resource.
4. If the stage name includes two words (such as Final Decision), then combine both words and add a prefix string in the Static Resource name (ATSv2_FinalDecision).