Workday

Workday delivers cloud-based solutions that incorporate human capital management, financial management, financial performance management, analytics, and other services. This document describes how to connect IBM watsonx Orchestrate to Workday and use its skills on Orchestrate.

Note: The Workday app on Orchestrate includes talent transformation skills that are created in the App Connect Designer and then imported as a skill on IBM watsonx Orchestrate. Hence, it is difficult to modify the Workday skills according to custom requirements. Consequently, access to the Workday app is restricted only to specific tenants based on customer requests. In contrast, the Workday HCM app is accessible to all customers, and like any other skills on Orchestrate, builders can use the Workday HCM skills to construct skill flows or automation workflows.

Connecting to Workday

An app can be connected either through the skill catalog or through the Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the Orchestrate chat when you use the skill:

  1. Open the Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection

To connect Orchestrate to your Workday account, complete the following steps:

  1. Click Connect app. You are prompted to enter the following connection details:

  2. Specify the Domain name and Tenant name.

    Domain name: The domain name of your Workday instance or sandbox, for example, wd2-impl-services1.workday.com.

    Tenant name: The tenant name of your Workday instance or sandbox for example: my_company.

  3. Enter your User name and Password.

    • User name: The name of the Workday Integration system user that Orchestrate can use to connect to your Workday instance or sandbox.

    • Password: The password of the Workday Integration system user.

    • API version: The current supported version is v35.1.

  4. Click Connect app.

Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Creating an Integration system user in Workday

Connections to Workday use a Workday Integration System User. To create and configure an Integration System User, complete the following steps:

  1. Log in to Workday as an administrator.

  2. Add the user to an unconstrained user group by completing the following steps:

    2.a. Search and select the Create Integration System User task.

    2.b. Configure and save an Integration System User. If you do not want the user ID to be used with the Workday UI, select the Do Not Allow UI Sessions option.

    2.c. Save a copy of the user name and password values to use when you connect Orchestrate to Workday.

  3. Open the Create Security Group task.

    3.a. In the Type of Tenant Security Group field, choose Integration System Security Group (Unconstrained).

    3.b. Enter a group name and click OK.

    3.c. Select the user that you created from the Integration System Users choice list.

    3.d. Click OK.

  4. Select the Activate Pending Security Policy Changes action, if the security policy changes aren't applied automatically.

  5. Add the required comment, then click OK.

  6. Select Confirm.

Finding your domain and tenant names (from your Workday WSDL URL)

You can find the domain and tenant names of the Workday instance from the WSDL URL. To get the domain and tenant names:

  1. Log in to Workday as an administrator.
  2. Search and select Public Web Services to view all the public web services.
  3. Select the menu next to the web service; for example, Absence Management (Public).
  4. Click Web Service > View WSDL.
  5. Scroll through the page to find the WSDL URL.

The format of the WSDL URL must be similar to - "https://<domain_name>/ccx/service/<tenant_name>/<service_name>/<version>". In the example WSDL URL "https://wd2-impl-services1.workday.com/ccx/service/my_company/Absence_Management/v37.0", the domain name is "wd2-impl-services1.workday.com" and the tenant name is "my_company".

Note: The domain name and tenant name values are case-sensitive.

What to do next

After you connect to the app, you can use the app’s skills. For more information see, Using skills. To know what skill you can use, see the skills and skill flow column of List of prebuilt apps, skills and skill flows.

Parent topic:

→ Prebuilt apps