In this article

Use this template to document an account type ONLY IF there are more than three account types. Document each account type to be documented separately. Maintain them as child pages of the main Accounts page. Remove Prerequisites, Limitations, and Troubleshooting from the main Accounts page if using this template.

Overview

Provide an overview of the account type.

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

Prerequisites

Provide all prerequisites for configuring the account type or use 'None.' if there are no prerequisites.

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

List all account-based limitations as bullets. Use "None." if there are no limitations.

None.

Account Settings

Include a screenshot of the fully configured account. Do this for each account type. If the account type has fields that are auto-populated when you validate/authorize it, mention so before the screenshot. For example:  To create your REST OAuth2 account in SnapLogic, you must provide at least your Client ID, Client secret, OAuth2 endpoint, and OAuth2 token and click Authorize. SnapLogic sends your account details to the OAuth2 endpoint specified and populates the Access token, Refresh token, and Access token expiration fields using the details received from that endpoint. 

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


ParameterData TypeDescriptionDefault ValueExample 
LabelThe field's name in the UI. Ensure that it is captured accurately so as not to confuse the user. StringThe data type of the field. For example, string, numeric, alphanumeric, etc. Check box for check boxesRequired. Enter a unique name to identify the account instance.Any and all information that the user needs to configure the field correctly. This includes a description of the property and the expected entry. If the user needs to look at the endpoint's console to retrieve a certain property's configuration, add that information as well. Include links to official documentation as necessary. If the field has numeric inputs, list out maximum and minimum accepted values, if applicable.

Field Prefacing for Mandatory/Conditionally mandatory fields: ---------------------------------------------------------------------------------- If field is mandatory (has a * in the UI), add, "Required" in italics. See Label's description below. If a field becomes mandatory based on the configuration of another field then add, "Required if <field_name> is configured". If a field is applicable based on certain situations then add, "Applicable only to <situation>"; for example, "Applicable only when using SSL with KMS." These conditions must always be in italics and in the beginning of the description. These prefacing conditions must always be in italics and in the beginning of the field's description.

N/AN/A if there is no default value. Workday_Account_01Use italics for examples. Show multiple examples to show variations. If N/A then no italics.
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
Enter the error message that is displayed.

Failed to validate Account: Soap fault

Briefly describe why this error is triggered. An experienced user will be able to troubleshoot the error looking at the reason itself.

Either the user name and/or password entered is invalid.

List the steps that the user must take, if necessary, to rectify this error. If a procedure is extensive, add it as a separate section after this table and reference it with a link in this cell.

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

Release 

Snap Pack Version

Date

Type

  Updates

4.28

main14627

Feb 12, 2022

Stable

  • Enhanced the Workday Read Snap with the following:

    • Added the Pass-through on no lookup match checkbox that allows the input document to pass through to the output view when there are no records matching an input document.

    • Parameterization of the Page Number and Page Size fields using Pipeline parameters. You can define and use the parameters in these fields using the
      Expression Enabler  icon to pass values during runtime.

4.27

main12833

Nov 13, 2021

Stable

Enhanced the Workday Read Snap with the new field Pool Size that controls the maximum number of threads in the pool. This field is available only when you select the Multi-threaded checkbox.

4.26

426patches11525

Sep 6, 2021 

Latest

Enhanced the Workday Read Snap with the new field Pool Size that controls the maximum number of threads in the pool. This field is available only when you select the Multi-threaded checkbox.

4.26

main11181

Aug 14, 2021 

Stable

Upgraded with the latest SnapLogic Platform release.

4.25

main9554

May 8, 2021 

Stable

Upgraded with the latest SnapLogic Platform release.

4.24

main8556

Feb 13, 2021

Stable

Upgraded with the latest SnapLogic Platform release.

4.23

main7430

Nov 14, 2020 

Stable

Upgraded with the latest SnapLogic Platform release.

4.22

main6403

Sep 12, 2020 

Stable

Removes support for Workday WSDL Account. Pipelines and Snaps using this account type must switch to either Workday Account or Workday Dynamic Account.

4.21

snapsmrc542

May 9, 2020 

Stable

Upgraded with the latest SnapLogic Platform release.

4.20 Patch 

workday8817

Apr 27, 2020 

Latest

Fixes the Workday Write Snap that ignores the Import Synchronized check box selection while importing object data. The Snap now:

  • Waits for the current import request to complete, whether successfully or with error, before initiating the next import request.

  • Provides accurate real-time status of the request to downstream Snaps.   

Existing Pipelines using this Snap may experience longer execution times due to the synchronous behavior. However, you no longer need to use an additional Snap to capture and pass on the request status to downstream Snaps.

4.20 Patch 

workday8761

Mar 6, 2020 

Latest

Fixes the Workday Read Snap that fails to validate when configured in the New Form UI.  

4.20

snapsmrc535

Feb 8, 2020 

Stable

Upgraded with the latest SnapLogic Platform release.

4.19

snaprsmrc528

Nov 14, 2019 

Stable

The Workday Write Snap includes a Validate Only Load check box, which enables users to upload–and then manually validate–data before importing it into Workday.

4.18 Patch 

workday7837

Sep 11, 2019 

Latest

Fixed an issue with the Workday Read Snap wherein the Snap is unable to log SOAP calls.

4.18

snapsmrc523

Aug 10, 2019 

Stable

Upgraded with the latest SnapLogic Platform release.

4.17

ALL7402

Jun 11, 2019 

Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17

snapsmrc515

Jun 11, 2019 

Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16 Patch

 workday6973

Mar 20, 2019 

Latest

Fixed an issue with paging variable toggle in Workday Read Snap to produce correct preview data.

4.16 Patch 

workday6862

Feb 22, 2019 

Latest

Fixed an issue with the Workday Read Snap not logging SOAP calls.

4.16

snapsmrc508

Feb 16, 2019 

Stable

Upgraded with the latest SnapLogic Platform release.

4.15 Patch

workday6727

Jan 28, 2019 

Latest

Fixed an issue with the Soap Execute Snap failing for Workday when the Trust All certificate is enabled while using SSL authentication.

4.15 Patch

workday6292

Dec 13, 2018 

Latest

Fixed an issue with the Workday Read Snap giving inconsistent results. Reverting the multithreading update resolved the issue. 

4.15

snapsmrc500

Dec 15, 2018 

Stable

Upgraded with the latest SnapLogic Platform release.

4.14

snapsmrc490

Aug 11, 2018 

Stable

Upgraded with the latest SnapLogic Platform release.

4.13 Patch 

workday5247

Jun 19, 2018 


Latest

Fixed the Workday Read Snap that took an extended time to read from the Workday application. 

4.13

snapsmrc486

May 12, 2018 

Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

Feb 17, 2018 

Stable

Upgraded with the latest SnapLogic Platform release.

4.11

snapsmrc465

Nov 11, 2017 

Stable

Upgraded with the latest SnapLogic Platform release.

4.10

snapsmrc414

Aug 12, 2017 

Stable

Upgraded with the latest SnapLogic Platform release.

4.9

snapsmrc405

May 13, 2017 

Stable

  • Updated the Snap with Import Synchronized, Import Batch Size and Import Batch Node to enhance the performance for Import objects supporting bulk operations. 

  • Updated the Workday Read Snap with the Page Number and the Page Size properties.

4.8

snapsmrc398

Feb 11, 2017 

Stable

  • Updated the Read Snap with the Simplified output property.

  • Info tab added to accounts.

4.7

snapsmrc382

Nov 23, 2016 

Stable

Upgraded with the latest SnapLogic Platform release.

4.6

snapsmrc362

Aug 13, 2016 

Stable

  • Resolved an issue in Workday Read Snap that caused errors when the timeout field was set.

  • Resolved an issue in Snaps with Workday Dynamic account that caused an error when a pipeline parameter provided an empty value to the password field.

4.5.1

snapsmrc344

May 18, 2016 

Stable

Resolved issues in Workday Snaps to ensure appropriate errors are routed to the error views.

4.4.1


Mar 18, 2016 

Stable

Upgraded with the latest SnapLogic Platform release.

4.4


Feb 13, 2016 

Stable

Resolved an exception in Workday Read.

4.3.2


Jan 15, 2016 

Stable

  • Addressed the following issues:

    • Defect: Workday Read Input Using As Of Date/Time in Response_Filter

    • Defect: Workday Snap Does Not Show All Services



See Also

Provide links to the endpoint's official documentation, any relevant or related internal documentation, and any other links you have referred to on this page. Care should be taken when referencing external sites/documentation that it is an official site/documentation. Do not refer to forums such as stackoverflow.