Workday Web Service and Reports (Legacy Configuration)

Recruitment Marketing Public

Important:

This applies to Workday ATS integrations using API Version 43.1 and lower. We recommend updating your API version instead and selecting "Workday Web Services (recommended for API version 43.2 or above)" under How is candidate data retrieved?

A customer can provide Workday API credentials and a custom-made report, which will tell Recruitment Marketing which candidates have been recently updated. Without this custom report, Recruitment Marketing has to import all candidates from Workday every time a synchronisation is run.

For more information, refer to the Workday Candidate Report.

Configuring Workday API

Creating the Candidate RaaS Report

In Workday, you will need to create a custom report. The report should be published using the Workday "Reports as a Service" (RaaS) capability. The report provides Recruitment Marketing with a list of candidates who have been updated within Workday since the last time the integration was executed.

A sample definition for this report is available at Workday Candidate Report. The report must contain a column labelled "email" as this data point is used for subsequent processing of the candidate updates.

Once created, you will need the URL of the report, along with the credentials required to access the report.

Configuring Recruitment Marketing

Workday Reports

Refer to Creating the Candidate RaaS Report above for the definition of the RaaS report.

Candidates URL: The URL of the candidate status report created as per the definition above. This report is an XML file containing a list of email addresses of recently updated candidates. When entering the URL for the report, the prompt for the data and time parameter should be replaced with a variable:

%{last_sync_datetime}

Therefore, when entered, the URL will look something like this:

https://services1.myworkday.com/ccx/service/customreport2/customername/username/reportname?Prompt_-_Date_and_Time_1=%{last_sync_datetime}

Candidates Report Username: Provided by customer

Candidates Report Password: Provided by customer

XPath to emails: The XPath used to access the email node in the report  (e.g., wd:Report_Data/wd:Report_Entry/wd:email)

Comments

0 comments

Article is closed for comments.