Delightful Enhancements: May 7, 2020
[Report Builder] Filter by Hiring team
Users will be able to filter their report data using two new filters:
-
Hiring team role
-
Hiring team member
Users can select hiring team roles including: Hiring Manager, Interviewer, Recruiter, Executive, Coordinator and any Custom hiring team roles. Then users can can choose hiring team member name using the standard user picker that includes first name, last name and email address.
[Report Builder] Include historical offers data in reports
We are updating the Offer data model in Report Builder to better reflect how offers are exposed in SmartRecruiters app and in the Customer API. Previously users could only select offers data fields for the most recent offer version. Now they will be able to create reports that show the entire history of different offer versions.
Additionally, when retrieving offers through the Customer API, users encountered a different unique identifier to pull offers data than what was available in Report Builder. The new data model change also aligns the unique identifier for Offers data in Report Builder and in the GET:/offers endpoint in the Customer API.
The new data model includes 2 new row entities to better model the complex nature of Offers data. These are:
-
Offer Process - this entity includes data fields that represent the entire offer history when multiple offers are created for an application.
-
Latest Offer - this entity is the new name for the current Offer entity. It includes data fields that reflect the latest offer version.
The Offer entity now includes data fields that are specific to each offer version created on an application. Existing data fields for the Offer entity will be mapped to the two new entities:
(OLD) Entity |
(OLD) Data Point |
Mapping |
(NEW) Entity |
(NEW) Data point |
OFFER |
Offer ID |
---------> |
OFFER PROCESS |
Offer process ID |
OFFER |
Offer creation date |
---------> |
OFFER PROCESS |
Offer process start date |
OFFER |
Offer accepted date |
---------> |
LATEST OFFER |
Latest Offer accepted date |
OFFER |
Offer extended date |
---------> |
LATEST OFFER |
Latest Offer extended date |
OFFER |
Offer creator ID |
---------> |
OFFER PROCESS |
Offer process creator ID |
OFFER |
Offer creator first and last name |
---------> |
OFFER PROCESS |
Offer process creator first and last name |
OFFER |
Offer creator email |
---------> |
OFFER PROCESS |
Offer process creator email |
OFFER |
Offer status |
---------> |
LATEST OFFER |
Latest Offer status |
OFFER |
Offer Approval Status Change Date |
---------> |
LATEST OFFER |
Latest Offer Approval Status Change Date |
OFFER |
Number of offer approvers |
---------> |
LATEST OFFER |
Number of latest offer approvers |
OFFER |
List of offer approvers |
---------> |
LATEST OFFER |
List of latest offer approvers |
OFFER |
Offer approval ID |
---------> |
LATEST OFFER |
Latest Offer Approval ID |
OFFER |
Offer approval status |
---------> |
LATEST OFFER |
Latest Offer approval status |
OFFER |
Offer approval creation date |
---------> |
LATEST OFFER |
Latest Offer approval creation date |
OFFER |
Offer approval pending days |
---------> |
LATEST OFFER |
Latest Offer approval pending days |
Users with existing Offer reports should take note
-
There will be no automatic migration to new data fields based on mapping specified above. Instead, existing Offer reports containing current offer data fields will have the names of those data fields, also known as selected columns, automatically updated to the new naming.
-
Users who have created a report with Approver as their reporting area should also be aware that any offer data fields that are included in this report will now be mapped to latest offer data fields.
-
We will not change the column names on any existing report files that have already been generated. The change only applies to report files generated in the future.
-
“Offer Accepted Date” or “Offer Extended Date” fields will now map to ”Latest Offer Accepted Date” and “Latest Offer Extended Date.” However, when the latest offer is not accepted or extended, the dates for these fields can be empty in the report. This is a change from the previous logic, as data for that date was taken from whichever offer version had been last accepted or last extended.
-
The change in column naming may impact your data workflows when new report files are generated if you are relying on the column names to drive that logic,
If you would like to report on the new offer version data and capture the full offer history, please edit your Offer reports.
[Mobile Hiring App] New Candidate Search
Users are able to find candidates by searching for their email address. Candidate search results are now better aligned between the web app & mobile apps.
Available in iOS version 2.32.0 and Android version 2.35.0.
[Job Ad] Webhook Events
We have added 3 additional webhook events that users will be able to subscribe to:
-
job.ad.created - Event callback will trigger when a new job ad is created on a job.
-
job.ad.updated - Event callback will trigger when a job ad is edited or otherwise updated
-
job.ad.postings.updated - Event callback will trigger when a posting of a job ad is edited
For more information on these new additional webhook events, visit the developer documents at: https://dev.smartrecruiters.com/customer-api/live-docs/webhooks-subscriptions-api/#/