How to use IBM App Connect with Workday

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Workday

Creating an Integration System User in Workday

Connections to Workday use a Workday Integration System User. If you do not already have an Integration System User ready, work with your company’s Workday administrator to create and configure an Integration System User; for example, as outlined in this section. For more detailed information, see the Workday documentation or ask your company’s Workday administrator.

1. Login to Workday as an administration user
2. Create an Integration System User then add the user to an unconstrained user group by completing the following steps in the Workday UI for the administration user:
   1. 1. Search for and open the Create Integration System User task.
      2. Configure and save an Integration System User. If you do not want the userid to be used with the Workday UI, select the Do Not Allow UI Sessions option.
      3. Save a copy of the user name and password values for use when connecting App Connect to Workday
      4. Search for and open the Create Security Group task
      5. In the Type of Tenanted Security Group field, choose Integration System Security Group (Unconstrained).
      6. Enter a group name and then click OK.
      7. Select the user you created from the Integration System Users choice list, click OK, and then click Done.
3. If the security policy changes aren't applied automatically, select the Activate Pending Security Policy Changes action, add the required comment, then click OK. On the next page, select the Confirm checkbox then click OK.

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

If you do not already know the domain and tenant names for your Workday instance, you can find the values from the WSDL URL of one of your Workday public web services; for example, as outlined in this section. For more detailed information, see the Workday documentation or ask your company’s Workday administrator.

1. Login to Workday as an administration user
2. Search for Public Web Services, then select the Public Web Services to view a list of all public web services.
3. Select the menu (...) for one of the web services; for example, Absence Management (Public), then select Web Service > View WSDL
4. Scroll to the bottom of the page to find the WSDL URL, which has the format: https://domain_name/ccx/service/tenant_name/service_name/version

   For example: https://wd2-impl-services1.workday.com/ccx/service/my_company/Absence_Management/v37.0

5. Save a copy of the domain_name and tenant_name values for use when connecting App Connect to Workday; from the example above:
   • Domain name: wd2-impl-services1.workday.com
   • Tenant name: my_company

General considerations

Before you use App Connect Designer with Workday, take note of the following considerations:

• (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

  For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

• (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

Workday events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Workday actions

Your flow completes these actions on this application.

Absence Management

Get Time Off Plan Balances

Cash Management

Get Payments

Get Bank Statements

Financial Management

Get Statistics

Get Business Plan Details

Human Resources

Find Organization

Integrations

Get Subscriptions

Put Sequence Generator

Integrations

Get Subscriptions

Put Sequence Generator

Learning

Get Learning Enrollments

Payroll Interface

Get Period Schedules

Get Worker Costing Allocations

Performance Management

Get Degrees

Put Degree

Recruiting

Get Candidates

Resource Management

Get Timesheets

Get Projects

Student Records

Get Change Licenses

Talent

Get Job History Companies

Put Job History Company

Time Tracking

Put Time Clock Events

Import Time Clock Events

More items are available when you have connected App Connect to Workday.