In this article
Overview
You can use this Snap to connect with Workday Query Language (WQL) endpoints. WQL is a query language used in the Workday system for retrieving and manipulating data. WQL endpoints refer to the specific API endpoints that allow you to execute WQL queries against the Workday system programmatically. These endpoints enable you to interact with the Workday system, fetch data, and perform various operations.
Snap Type
The WorkdayQL Snap is a Read-type Snap that reads data from the WQL endpoints.
Prerequisites
None.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations
To make WQL API calls, you need:
Access to the Workday Query Language security domain.
To create an API client or repurpose an existing one.
Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| The OpenAPI path, operation and query parameters of the endpoint. |
Output | Document |
|
| The data fetched from the WQL endpoint. |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:
Learn more about Error handling in Pipelines. |
Snap Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon ( ): Indicates that you can add fields in the field set.
Remove icon ( ): Indicates that you can remove fields from the field set.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Description | |
---|---|---|---|
Label* Default Value: WorkdayQL | String | 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. | |
OpenAPI Path* Default Value: N/A | String/Expression/Suggestion | Enter the path for the REST endpoint. Based on the service and version, the Snap downloads the open API specification and populates the list. | |
Operation* Default Value: N/A | String/Expression/Suggestion | Specify the operation to perform on the selected OpenAPI path or select from the suggestions list. The available options are:
| |
Query Parameters | You can use this fieldset to define the name and value for query parameters on request. | ||
Name Default Value: None. | String/Expression | Specify the name of the query parameter for retrieving assets. | |
Field 2 Default Value: None. | String | Specify the value for the query parameter for retrieving assets. | |
Number of Retries | Integer | Enter the integer value to specify the number of attempts the snap should make to perform the selected operation in case of connection failure or timeout. Minimum value: 0 Default Value: 0 | |
Retry Interval (seconds) | Integer | Enter the time interval in seconds between retry attempts. Minimum value: 1 Default Value: 1 | |
Pass through
Default Value: Deselected | Checkbox | Select this checkbox to enable the Snap to pass the input data to the downstream Snap and display in the output document. | |
Enable Pagination
Default Value: Selected | Checkbox | Select this checkbox to enable the Snap to return the response in multiple pages when the input document contains the
When you deselect this checkbox, the Snap limits the number of output documents to 100, with only one page of records. | |
Snap Execution Default Value: Execute only | Dropdown list | Select one of the three modes in which the Snap executes. Available options are:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Account validation failed. | The Pipeline ended before the batch could complete execution due to a connection error. | Verify that the Refresh token field is configured to handle the inputs properly. If you are not sure when the input data is available, configure this field as zero to keep the connection always open. |
Examples
Excluding Fields from the Input Data Stream
Downloads
Download and import the Pipeline into SnapLogic.
Configure Snap accounts, as applicable.
Provide Pipeline parameters, as applicable.
Snap Pack History
Related Content
Endpoint Doc Link 1
Endpoint Doc Link 2
Endpoint Doc Link 3