Jump to a Section

Overview

 Parameters:

  • User (text)
  • Password (password)
  • Base URL (text)
  •  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:

  1. Create an integration system user by searching “Create Integration System User” in the Workday UI
  2. 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 FLO, please manually pull it once. Or records will not return for the first scheduled time.

      Parameters

      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)