Skip to Content

Workday Connector

Overview

The Workday connector is accessed from the design component palette's Project endpoints and connectors tab (see Design Component Palette).

Connections tab

This connector is used to first configure a Workday connection, establishing access to an account on the Workday server, and then used to configure one or more Workday activities associated with that connection as either a source or target within an operation.

Operations in the Workday Web Services (WWS) API versions 32.0 through 42.0 are categorized into these activities:

  • Add
  • Adjust
  • Assign
  • Cancel
  • Change
  • Close
  • Contract
  • Create
  • Edit
  • Enter
  • Get
  • Import
  • Manage
  • Put
  • Remove
  • Request
  • Set
  • Submit
  • Other

The operations of each web service are categorized under these activities on the basis of the starting token of the operation. Examples:

Operations that aren't covered by the above categorization (operations whose starting token is not listed above) such as the Start_International_Assignment or the Switch_Primary_Job operations, from the Staffing web service, are available in the Other activity.

Activities

In this documentation, only a generic Workday activity is documented, as each activity has a similar design.

  • Workday activity: A Workday activity retrieves data from and/or sends data to a selected Workday web service and is used as a source or target in an operation.

Together, a specific Workday connection and its activities are referred to as a Workday endpoint. Once a connection is configured, activities associated with the endpoint are available from the Endpoints filter:

Connections tab

Note

This connector is a Connector SDK-based connector, which may be referred to by Jitterbit when communicating changes made to connectors built with the Connector SDK.

Prerequisites and Supported API Versions

To connect with the Workday server, contact the Workday administrator for the required information:

  • Workday host (this will be a URL such as https://example.workday.com/)
  • Workday tenant
  • Workday username
  • Workday password

The Workday connector uses the Workday Web Services (WWS) API WSDL versions 32.0 through 42.0, depending on the version selected in a Workday connection. Refer to the API documentation for information on the schema fields.

The Workday connector requires the use of an agent version 10.1 or later. These agent versions automatically download the latest version of the connector when required.

Limitations

When the version of the Workday WSDL selected in a Workday connection is v42.0, data cannot be fetched for the Human_Resources and Resource_Management services. Instead, during activity configuration, the following error is returned by the connector:

Unable to fetch data
TypeError: Cannot read properties of undefined (reading 'input')

The inability to fetch data for these services is due to an issue in the WSDL definition provided by Workday. If you need to use these services, Jitterbit's recommendation is to use a Workday WSDL version earlier than v42.0, such as v41.2, where the issue does not exist.

Troubleshooting

If you experience issues with the Workday connector, these troubleshooting steps are recommended:

  1. Click the Test button in the connection configuration to ensure the connection is successful and to ensure the latest version of the connector is downloaded to the agent (unless using the Disable Auto Connector Update organization policy).

  2. Check the operation logs for any information written during execution of the operation.

  3. Enable operation debug logging (for Cloud Agents or for Private Agents) to generate additional log files and data.

  4. If using Private Agents, you can enable connector verbose logging for this connector using this specific configuration entry of logger name and level:

    <logger name="org.jitterbit.connector.workday" level="DEBUG"/>
    
  5. If using Private Agents, you can check the agent logs for more information.

Additional Resources

A Jitterbit Microlearning Tutorial for Workday to FTP is available through our Jitterbit Basics video series, created by Jitterbit University.