Skip to main content
SmartRecruiters

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/#/