Workday Write

Snap type:

Description:

This Snap provides the ability to cancel objects in 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 service becomes suggestible once the account is defined. The object becomes suggestible once the service 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.
Workday provides documentation for their objects at https://community.workday.com/custom/developer/API/index.html (you must have access to the Workday Community).

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:

Ultra pipelines: May work in Ultra Pipelines.
Spark mode: Not supported in Spark mode.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See <account page> for information on setting up this type of account.

Views:

Input	This Snap has exactly one input view.
Output	This Snap has exactly one output view.
Error	This Snap has at most one error view and produces zero or more documents in the view.

Settings

Label

Error rendering macro 'excerpt-include' : No link could be created for 'Snap Label'.

Timeout

Defines the timeout value for each Workday SOAP request. A value of 0 means no timeout.
Example: 0

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 cancelations.
Example: Revenue_Management

Default value: [None]

Object

The Workday Object to cancel. The field is suggestible once the Workday account and the service is defined.
Example: Cancel_Customer_Invoice

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

We will provide two examples, the first one to cancel an object successfully, the second one to handle an error after an attempted cancelation.

Example #1

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.

Example #2

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.

Snap History

4.5.0

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