Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Field Name

Field Type

Description

Label*

Default ValueWorkday REST
ExampleOnboarding newhires

String

Specify a unique name for the Snap.

 

Service*

Default Value: N/A
ExampleCompensation

String/Expression/Suggestion

Specify or select the Workday Service to connect to Workday.

Version*

Default Value: N/A
Examplev2

String/Expression/Suggestion

Select the version corresponding to the service.

OpenAPI Path*

Default Value:N/A
Example: /workers

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
Example: get

String/Expression/Suggestion

Specify the operation to perform on the selected OpenAPI path or select from the suggestions list. The available options are

  • GET: Reads and retrieves content and data.

  • POST: Creates a new resource withe with new ID.

  • PUT: Updates and replaces the existing resources.

  • PATCH: Updates and modifies the resources. PATCH operation only modifies the content of the resources, but does not replace the resources entirely.

  • DELETE: Deletes the resources entirely.

Number of Retries

Default Value:0
Example:3

Integer/Expression

Specify the number of attempts the Snap must make to perform the selected operation in case of connection failure or timeout.

The Snap retries the request if the value is greater than zero or retries only if it encounters 401 or 500 error.

Retry Interval (seconds)

Default Value: 1
Example: 2

Integer/Expression

Specify the time interval in seconds between retry attempts.

HTTP Headers

Use this field set to add additional headers to the HTTP request defined in the Workday OpenAPI specification. 

Header

Default Value: N/A
Examplecontent-type

String/Expression

Specify a name for the HTTP header.

Values

Default Value: N/A
Exampleapplication/json

String/Expression

Specify a value to assign to the HTTP header.

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 limit and offset query parameters.

  • The maximum limit value of the page size is 100—that is, the Snap fetches all records until the last page with 100 records on each page.

  • If the limit field is blank, the default limit value is 20 and the Snap displays only one page of records.

When you deselect this checkbox, the Snap limits the number of output documents to 100, with only one page of records.

Snap Execution

Default ValueExecute only
Example: Validate & Execute

Dropdown list

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

...