Job Board Applications Rater
The Job Board Application Rater is a tool that allows for the quick and easy review of job board applications, allowing for them to be rated and potentially converted into applications in a streamlined manner. It is highly customisable, allowing custom actions to be performed on the job board applications.
Access
The rater component is a URL addressable Lightning Component and as such, simply requires a hyperlink to be navigated to. The URL for the rater component is as follows:
/lightning/cmp/seven20__JobBoardApplications?seven20__job=JOB_RECORD_ID
By default, there is a quick action on the Job (seven20__Job) object that links to the rater component, called Rate_Job_Board_Applications, which can be added to the Job page layout as required.
Additionally, an individual Job Board Application record can be linked to, which defaults to having it selected in the rater on load, this is achieved by adding a second URL parameter, as follows:
/lightning/cmp/seven20__JobBoardApplications?seven20__job=JOB_RECORD_ID&seven20__application=JOB_BOARD_APPLICATION_RECORD_ID
By default, there is a hyperlinked field on the Job Board Application (seven20__Job_Board_Application__c) object that links to the rater component, called View Rater (seven20__View_Rater__c), which can be added to the Job Board Application page layouts and related lists as required.
When building custom navigation links, always use the 18 character Job record Id
Usage
The rater component is a split view which functions in a similar manner to the Search and Match split views, with the left hand panel showing a link to the job and all the job board application records against it. The right hand shows the details of the currently selected application record.
Selecting multiple application records at once is not supported.
Each application in the left hand panel is displayed with the following fields:
- seven20__Candidate__r.Name
- CreatedDate - Displayed as Submitted Date
- seven20__Score__c - Displayed as a star rating, with the number of stars representing the score out of 5
These fields are not configurable.
The right hand panel displays similar to the split views found within Search, Match, and Hotlists, with a few notable exceptions:
- CV viewer only displays CVs which are attached to the currently viewed job board application record, not the candidate
- Above the candidate codes section, there is a section which displays the compact layout of the currently selected job board application record
- The actions section includes a Star Rating component, which allows for the score of the currently selected job board application record to be updated by clicking on the appropriate star. See below for details
- Only one standard action is available, labeled + ATS, this action creates a new Application (seven20__Application__c) record for this job board application record. This action will be disabled if the seven20__Application__c field is populated. Supports lookup customisation for the Job lookup
Star Rating
The star rating functionality of the rater can be customised, allowing for the number of stars to be changed. This is achieved by editing a Seven20 Configuration setting metadata record with developer name Job_Board_Rater_Max_Rating, and changing the value to be the number of stars displayed. This affects both the left hand panel display and the star rating selector component in the right hand panel.
While there is no maximum value, consider the impact of having a large number of stars on the user experience.
Additionally, the right hand panel star rater can be disabled, removing its ability to update the score, but still displaying the current value. This is achieved by editing a Seven20 Configuration setting metadata record with developer name Job_Board_Rater_Disable_Star_Selection, and changing it to be active. Combined with the custom actions functionality, this can be used to provide custom processes for grading an application.
Custom Actions
Custom flow modal actions can be configured to be displayed as buttons on the top right of the rater component, to the left of the standard actions. These actions can be used to perform custom actions on the currently selected job board application record. These should use the following settings:
| Detail | Value |
|---|---|
| Process | Job Board Application Rater - Single |
| Templated Flow | seven20_Job_Board_Application_Rater_Template |
The following input variables are required:
| Variable Name | Type | Description |
|---|---|---|
| jobBoardApplicationId | Id | The Id of the job board application record |
| contactId | Id | The Id of the contact related to the job board application record |
| jobId | Id | The job the application is for |
Don't forget to follow the standard flow modal action configuration steps