Workday | Help Center

Overview

Authorizing an Account

Parameters:

User (text)
Password (password)
Base URL (text)
- In the Workday UI, search for “Public Web Services” in the search bar and load the “Public Web Services” report. On any of the web services, select the three dots to the right of the service name and take the action “Web Service” -> “View WSDL”
- In the WSDL, search for “soapbind:address” and find the value in the “location” property of that field, e.g. “https://wd5-impl-services1.workday.com/ccx/service/my_workfront_tenant/Absence_Management/v31.0". The value for “Base URL” should be this value up to the tenant name. In the example listed here, the correct value for “Base URL” would be “https://wd5-impl-services1.workday.com/ccx/service"
Tenant (text)
- This value can be found in the URL of your instance when you are in the Workday UI, e.g. wd5-impl.workday.com/my_workfront_tenant/…
- Only enter the name of the tenant, not anything else from the URL. In this case, “my_workfront_tenant” would be the correct value.

Workday authorization requires a user that has access to the “Get_Workers” endpoint of the “Human_Resources” service. Follow these steps to create an integration system user with the appropriate permissions to use the connector:

Create an integration system user by searching “Create Integration System User” in the Workday UI
Search “Active Security Groups,” and find the unconstrained Integration System Security Group for “Human Resource System.” Click the three dots to the right of the name of the group, and select “Integration System Security Group (Unconstrained)” -> “Edit”. Then add your integration system user to this security group.

Events

Employee Job Updated

Fire monitor when an employee job is updated in Workday

Employee Profile Updated

Fire monitor when an employee's personal information or contact information is updated in Workday

Employee Time Off Updated

Fire monitor when an employee’s time off is updated in Workday

Workday Report-as-a-Service (RaaS) is a feature that exposes reports as web services. Azuqua uses this web service to integrate data from Workday to other applications. In order to use the Employee Time Off Updated event, a custom report configured as Advanced type needs to be built first.

To use this card, you must complete the following steps:

Create advanced type custom report with Web Service enabled. Search for “create custom report” in Workday search bar, open the Create Custom Report task, select Advanced for Report Type, select “Enable As Web Service”, also fill in required fields.

Add the report columns that will be used in the integration between Workday and other applications. Note the Column Heading Override XML Alias needs to be the same as in the following image.

Add sorting for the custom report that ascends according to Entered On date.

Apply filter/logic to compare prompt values against report column values. Only records with Entered On date greater than or equal to the provided value will be included in the report. This helps us to get updated time off records from last checked date.

Add the default prompt that is required for the custom report (Entered On).

After setting up a successful connection with Workday in Designer, add the monitor Employee Time Off Updated. Note: the time stamps returned from the web service is in the format of “YYYY-MM-DD” without time. In order to minimize the duplicate records, the schedule needs to be configured as Check every Day, or Week, or Month, and it’s better to configure the check time to be at night (e.g. 1AM). Also after setting up the Flow, please manually pull it once. Or records will not return for the first scheduled time.

Parameters

Report Owner Username: the user who created the custom report
Report Name: the name of the custom report
Time Zone (e.g. US/Montain): the timezone of the user. E.g. US/Montain or US/Pacific (see full list on wikipedia https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

Output Data

Output
- Time Off Entry: a summary of the time off record
- Worker: the name of the employee
- Organization: the organization the employee belongs to
- Request or Correction: Time Off Request or Time Off Correction
- Time Off Type: the type of the time off (e.g. Floating Holiday, Jury Duty)
- Unit of Time: the unit of the time requested (e.g.Hours)
- Time Off Date: the requested time off date
- Entered On: the date the employee submitted the request
- Approval Date: the date the request got approved
- Units Approved: the number of units time got approved
- Units Pending: the number of units time pending
- Units Denied: the number of units time got denied

New Employee

Fire monitor when a new employee is added to Workday

Actions

Custom API Call

Make a custom API call to the Workday API

Request

Service (text): The service your request will go to. This will be a string like “Human_Resources” or “Absence_Management.” The full list of Workday API services can be found here. You will need to make sure that the user you are making the call as has the appropriate permissions to access that service through the API.
SOAP Body (text): This input takes an XML string. An example request to the “Get_Workers” endpoint that gets all workers updated between the timestamps “2018-05-01T18:17:58.016Z” and “2018-05-02T20:46:59.512Z” would look like this:

<bsvc:Get_Workers_Request><bsvc:Request_Criteria><bsvc:Transaction_Log_Criteria_Data><bsvc:Transaction_Date_Range_Data><bsvc:Updated_From>2018-05-01T18:17:58.016Z</bsvc:Updated_From><bsvc:Updated_Through>2018-05-02T20:46:59.512Z</bsvc:Updated_Through></bsvc:Transaction_Date_Range_Data></bsvc:Transaction_Log_Criteria_Data></bsvc:Request_Criteria></bsvc:Get_Workers_Request>

Response

Status Code (number)
Body (object)