| Snap type: | Write | ||||||
|---|---|---|---|---|---|---|---|
| Description: | This Snap provides the ability to write objects into Workday based on the input document field values that match the Workday object schema field names as defined by the Workday Web Service Definition Language (WSDL). The object becomes suggestible once the account is defined. The fields that can be set on the object are provided on the input view of the Snap and can be mapped using an upstream Mapper Snap. Expected upstream Snaps: Field can be mapped using an upstream Mapper Snap which will allow the mapping of fields or values to the field that are available on the selected service object. Expected downstream Snaps: The Snap will output one document for every record written, hence any document processing Snap can be used downstream. Expected input: Document that conforms to the input view schema of the Snap. The input view schema is provided to an upstream Mapper Snap based on the selected service object. Expected output: Document which represents the record structure of the retrieved Workday service object. Each record is represented as one document on the output view. | ||||||
| Prerequisites: | |||||||
| Support and limitations: |
| ||||||
| Account: | This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Workday Account for information on setting up this type of account. | ||||||
| Views: |
| ||||||
Settings | |||||||
Label | Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. | ||||||
| Timeout | Defines the timeout value for each Workday SOAP request. A value of 0 means no timeout. Default value: 0 | ||||||
| Service | The service to be used. Current supported services are [Absence_Management, Benefits_Administration, Cash_Management, Financial_Management, Human_Resources, Integrations, Payroll, Payroll_Interface, Resource_Management, Revenue_Management, Staffing, Talent]. Even though all services above are selectable, only Resource_Management, Revenue_Management, Financial_Management, Integrations, Cash_Management will have objects that provide cancellations. Example: Revenue_Management Default value: [None] | ||||||
| Object | Required. The object to write. The field is suggestible once the account is defined. The objects will be suggested based on the selected service, such as selecting the service Payroll will retrieve all objects for Payroll that are retrievable from Workday. Example: Human_Resources-Get_Job_Profiles Default value: [None] | ||||||
| Import Synchronized | Enable this to make the all the import request Synchronized else it be an Asynchronous (This is only for Import_ objects and doesn't affect other objects) Default value: False | ||||||
| Import Batch size | Number of documents to be batched together as a single request. This also requires "Import Batch Node path" property.(This is only for Import_ objects and doesn't affect other objects) Default value: 1 | ||||||
| Import Batch Node path | The node path of the soap message under which the documents need to be batched under. The suggest option accessing schema on its input view or through an upstream reference. This is applicable to Import objects only and does not affect the other objects. Default value: [None] | ||||||
| Execute during preview | This property enables you to execute the Snap during the Save operation so that the output view can produce the preview data. Default value: Not selected | ||||||
Examples
In the first example we will cancel an Invoice using the Revenue_Management service.
Download example pipeline. Note that this pipeline does not work for any Workday tenant since they read by WID.
We will start with a Mapper Snap where we map the customer invoice type and its value (see above). The Workday Cancel Snap was configured to use the Revenue_Management service with the Cancel_Customer_Invoice object.
The response is shown below, returning the ID of the position that was created.
The second example will showcase error handling. Invoice cancelation can only happen once per invoice, here we catch that error in the error view. Download the example pipeline. Note that this pipeline does not work for any Workday tenant since they read by WID.
The mapping and the Workday Cancel Snap are configured as in the first example, with one difference: adding an error view to the Workday Cancel Snap.
The error view will show the following:
- The error key will provide the message returned from Workday. In this case mentioning that the Invoice is not cancelable.
- The envelope key carries the information of the SOAP envelope that populated by applying the variables from the input view into the generated SOAP envelope.
- The stripped envelope key carries the information of the SOAP envelope that will be send to Workday
- The original key carries the document that came in on the input view.
This pipeline shows how the Workday Write Snap supports the import objects.
In this pipeline, the Mapper Snap passes the values to be configured under various parameters for the Object, Import_Accounting_Journal.
The Workday Write Snap writes the data from the object, Import_Accounting_Journal. Note the Import Synchronized property is selected with an import batch size of 1. The import Batch node suggests the path under which the documents need to be batched under.
Successful execution of the pipeline displays the below output preview:
Release | Snap Pack Version | Date | Type | Updates |
|---|---|---|---|---|
November 2024 | main29029 | Stable | Updated and certified against the current Snaplogic Platform release. | |
August 2024 | main27765 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2024 | main26341 | Stable | Updated and certified against the current SnapLogic Platform release. | |
February 2024 | 436patches25953 |
| Latest | Upgraded Apache CXF from version 3.4.2 to 3.6.3 to prevent vulnerability issues. |
February 2024 | main25112 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
November 2023 | 435patches24944 |
| Latest | Fixed an issue with Workday REST Snap where the input schema of the Snap did not populate in the upstream Mapper Snap. |
November 2023 | 435patches24309 |
| Latest | Added the WorkdayQL Snap in the Workday Snap Pack, which connects with the Workday Query Language (WQL) endpoints. |
November 2023 | main23721 | 08 Nov 2023 | Stable | Updated and certified against the current SnapLogic Platform release. |
August 2023 | main22460 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2023 | main21015 |
| Stable | Upgraded with the latest SnapLogic platform release. |
February 2023 | 432patches20313 |
| Latest | Fixed an issue with the Workday REST Snap where it failed with a null pointer exception when the input document was null. |
February 2023 | main19844 |
| Stable |
|
January 2023 | 431patches19450 |
| Latest | Introduced the Workday REST Snap to connect to Workday REST APIs. This Snap supports the following new accounts: |
November 2022 | main18944 |
| Stable | Upgraded with the latest SnapLogic platform release. |
October 2022 | 430patches18358 |
| Latest | The Workday Read, Workday Write, and Workday Cancel Snaps are now showing the Services in the suggestions list using the Public Web Service API, which the Snaps failed to use previously. |
August 2022 | 430patches17587 |
| Latest | The performance of the Workday Read Snap is improved to reduce the execution time. |
August 2022 | main17386 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.29 | main15993 |
| Stable | Added support for the latest version of Workday APIs (certified to be compatible with version 37.0). |
4.28 Patch | 428patches14290 |
| Latest | Enhanced the Workday Cancel Snap with the retry mechanism fields.
|
4.28 | main14627 |
| Stable |
|
4.27 | main12833 | 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 Patch | 426patches11525 |
| 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 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.25 | main9554 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.24 | main8556 | Stable | Upgraded with the latest SnapLogic platform release. | |
4.23 | main7430 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.22 | main6403 |
| Stable | Removes support for Workday WSDL Account. Pipelines. You must switch these Snaps using either the Workday Account or Workday Dynamic Account type. |
4.21 | snapsmrc542 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.20 Patch | workday8817 |
| Latest | Fixes the Workday Write Snap that ignores the Import Synchronized checkbox selection when importing object data. The Snap now:
Existing Pipelines using this Snap to might experience longer exercution times because of |
4.20 Patch | workday8761 |
| Latest | Fixes the Workday Read Snap that fails to validate when configured in the New Form UI. |
4.20 | snapsmrc535 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.19 | snaprsmrc528 |
| Stable | The Workday Write Snap includes a Validate Only Load checkbox, which enables users to upload–and then manually validate–data before importing it into Workday. |
4.18 Patch | workday7837 |
| Latest | Fixed an issue with the Workday Read Snap wherein the Snap is unable to log SOAP calls. |
4.18 | snapsmrc523 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.17 | ALL7402 |
| Latest | Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers. |
4.17 | snapsmrc515 |
| Latest | Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview checkbox. |
4.16 Patch | workday6973 |
| Latest | Fixed an issue with paging variable toggle in Workday Read Snap to produce correct preview data. |
4.16 Patch | workday6862 |
| Latest | Fixed an issue with the Workday Read Snap not logging SOAP calls. |
4.16 | snapsmrc508 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.15 Patch | workday6727 |
| 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 |
| Latest | Fixed an issue with the Workday Read Snap giving inconsistent results. Reverting the multithreading update resolved the issue. |
4.15 | snapsmrc500 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.14 | snapsmrc490 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.13 Patch | workday5247 |
| Latest | Fixed the Workday Read Snap that took an extended time to read from the Workday application. |
4.13 | snapsmrc486 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.12 | snapsmrc480 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.11 | snapsmrc465 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.10 | snapsmrc414 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.9 | snapsmrc405 |
| Stable |
|
4.8 | snapsmrc398 |
| Stable |
|
4.7 | snapsmrc382 |
| Stable | Upgraded with the latest SnapLogic platform release. |
4.6 | snapsmrc362 |
| Stable |
|
4.5.1 | snapsmrc344 |
| Stable | Resolved issues in Workday Snaps to ensure appropriate errors are routed to the error views. |
4.4.1 |
|
| Stable | Upgraded with the latest SnapLogic Platform release. |
4.4 |
|
| Stable | Resolved an exception in Workday Read. |
4.3.2 |
|
| Stable |
|
icon to pass values during runtime.