Workday Dynamic Account

In this article

Overview

Use this Dynamic account type to connect Workday Snaps with data sources that use Workday Dynamic Accounts.

Dynamic Account types support Secrets Management, a SnapLogic add-on that allows you to store endpoint credentials in a third-party secrets manager. Orgs using Secrets Management provide the information necessary to retrieve the secrets in expression-enabled dynamic Account fields. During validation and execution, Pipelines obtain the credentials directly from the secrets manager. Learn more about Secrets Management.

Prerequisites

  • Write permissions for the Project for which you are creating the Account.
  • Valid Username, Password, Tenant, Host and Version received from Workday for using the Account.

Host, Version and Tenant can be found out by following any of these simple steps:

  1. You can first contact your Workday Security Administrator or your Implementation Partner.
  2. If you have access to your Workday Customer Portal, you can get information from there
  3. If you have access to the Workday Community, you can access the Workday Data Centers page from where its three data centers are listed. (AshburnPortland and Dublin). You need Workday Community access for this.
  4. Another easy way of finding this is through a RAAS (Report As A Service)
    1. Create an Advanced Report that is Web Service Enabled.
    2. From the Related Actions for the Report, click on Web Services > View URLs.
    3. Copy the Workday XML URL. It contains the host-prefix, tenant name, user name and follows the syntax: 
      https://<host-prefix>.workday.com/ccx/service/customreport2/<tenant_name>/<username>/CR_RAAS_SNAPLOGIC_READ_DEMO.
  5. Latest Version can be found from the Public Workday Web Services (WWS).

Limitations and Known Issues

None.

Account Settings


While creating a Workday Dynamic Account

For Workday Dynamic Accounts, we recommend passing authentication credentials through Pipeline parameters. Use the Pipeline Properties to define the required Pipeline parameters.


Field FieldTypeDescriptionDefault ValueExample 
LabelStringRequired. Enter a unique name to identify the account instance.N/AWorkday_Account_01
PasswordStringRequired. Provide the Pipeline parameter key (_Parameter) as an Expression in this field. This key must correspond to the password required for accessing the Workday instance.N/A_WDA_Pwd
HostString

Required. Provide the Pipeline parameter key (_Parameter) as an Expression in this field. This key must correspond to the host name required for accessing the Workday Implementation (Sandbox) or Production tenant.

The host supports the path in a non-HTTP format (for example, wd-imp-services.workday.com).

N/A_Workday_Host
TenantStringRequired. Provide the Pipeline parameter key (_Parameter) as an Expression in this field. This key must correspond to the Workday tenant.N/A_Tenant_name
VersionString

Required. Provide the version of the Workday instance.

 The Snap supports the versions from 21 through 29.

N/A29.2

Pipeline Parameters

Workday Dynamic Account Settings

Accounts Encryption

Standard Encryption

If you are using Standard Encryption, the account uses High sensitivity settings under Enhanced Encryption for transmitting information.

Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following describes which fields are encrypted for each sensitivity level selected per each account.

Account:

  • High:
  • Medium + High
  • Low + Medium + High

Troubleshooting

ErrorReasonResolution
Failed to validate Account: Soap faultEither the user name and/or password entered is invalid.

Recheck the user credentials and pass valid user name and/or password.

Failed to validate Account: Unable to read URL (500 Internal Server Error)Path validation failed. The value for Tenant does not resolve to a valid Workday instance.Ensure the value passed in the Tenant field forms a proper/valid URL that points to the Workday instance.
Failed to validate Account: Unable to read URLPath validation failed. The Host does not resolve to a valid destination.Ensure the values passed in the Host field forms a proper/valid URL that points to the Workday instance.
Failed to validate Account: Error parsing WSDL documentVersion does not follow the required pattern for Workday versions: XX.X.Update the Version values to follow the pattern XX.X. For example, 28.2, 34.0, 33.2.

Snap Pack History