Workday account details

To establish a connection to Workday, you must add an account that defines the account details to connect with. You can define these details by creating a configuration object in the App Connect Dashboard, the Red Hat® OpenShift® web console or CLI, or the Kubernetes CLI.

Account parameters
Locating the values for the account parameters
Example

Account parameters

You can define one or more accounts for Workday.

For each account that you require, you can specify a new set of account details in any of the following ways:

If you are using the App Connect Dashboard, either complete the Account details fields in the Create configuration panel, or specify the account parameters in an accounts.yaml file before importing it into the Create configuration panel. For more information, see Accounts type.
If you are using the Red Hat OpenShift web console or CLI, or the Kubernetes CLI, specify the account parameters in an accounts.yaml file, and then use this configuration file to create a configuration object. For more information, see Creating the file for a configuration object of type Accounts.

The set of required and optional Account fields or parameters are listed in the following table.

For information about locating the values for these account parameters, see Locating the values for the account parameters.

Field	Parameter	Values	Condition	Description
Account name	name	User defined	Required	The name of a Workday account that is used in the exported flow.
Authentication type	authType	`BASIC`	Optional	The mechanism that is used for user authorization.
Domain name	domainName	User defined	Required	The domain name of your Workday instance or sandbox.
Tenant name	tenantName	User defined	Required	The tenant ID of your Workday instance or sandbox.
User name and Password	username and password	User defined	Required	The user name and password of the Workday Integration System User that App Connect should use to connect to your Workday instance or sandbox.
API Version	version	`v31.0` `v31.1` `v31.2` `v32.0` `v32.1`	Optional	The version of the Workday Web Services (WWS) API to be used. The default version is `v32.1`, and App Connect supports all the web services and operations that are offered by this API version. The services and operations that are available to you will depend on the Workday instance that you connect to and the API version used. Contact your Workday administrator for information about the API version used.

Locating the values for the account parameters

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. 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 previous example:
  - Domain name: wd2-impl-services1.workday.com
  - Tenant name: my_company

Example

Remember: An accounts.yaml file that defines one or more accounts must always begin with the following line:
accounts:

workday:
  - name: "Account 1"
    credentials:
     authType: "BASIC"
     version: "v32.1"
     domainName: "wd2-impl-cc.workday.com"
     tenantName: "acme_air1"
     username: "jonsnow-impl"
     password: "TopSecret7788"
    endpoint: {}