Contact Free trial Login

Workday - Studio Configuration - Mule 4

To configure Anypoint Connector for Workday:

  1. Add the connector to your project from either Exchange or from within Anypoint Studio.

  2. Configure the connector.

  3. Configure an input source for the connector.

Add the Connector to Your Project

Anypoint Studio provides two ways to add the connector to your Studio project: from the Exchange button in the taskbar or from the Mule Palette.

Add the Connector Using Exchange

  1. In Studio, create a Mule Project.

  2. Click the Exchange (X) icon in the upper left of the Studio task bar.

  3. In Exchange, click Login and supply your Anypoint Platform username and password.

  4. In Exchange, search for "Workday".

  5. Select Workday Connector, click Add to project.

  6. Follow the prompts to install the connector.

Add the Connector in Studio

  1. In Studio, create a Mule Project.

  2. In the Mule Palette, click (X) Search in Exchange.

  3. In Add Modules to Project, type "Workday" in the search field.

  4. Click the connector name in Available modules.

  5. Click Add.

  6. Click Finish.

Configure an Input Source

Configure an input source for the connector. Possible input source operations are:

  • On New Objects
    Start your app when an object is created in Workday.

  • HTTP Listener
    Start your app using a browser or a command such as curl.

  • Scheduler
    Start your app at timed intervals.

In Studio, drag the input operation you choose from the Mule Palette to the Source panel in the canvas.

The required fields for the On New Objects input source are:

Studio Field Description

Connector configuration

Global Element Properties configuration name

Object type

One of: ABSENCE_INPUTS, ACADEMIC_CONTACTS, ALL_CURRENCIES, APPLICANTS, BASIC_CUSTOMERS, CANDIDATES, CERTIFICATION_ISSUERS, CERTIFICATIONS, COMPETENCIES, DEGREES, DONORS, EDUCATION_TEST_RESULTS, EDUCATIONAL_INSTITUTION_COURSE, HEALTH_CARE_RATES, INVESTORS, ORGANIZATIONS, PAYMENTS, PROGRAMS_OF_STUDY, STUDENTS, STUDENTS_APPLICATIONS, WORKERS

Scheduling Strategy

Configures the scheduler that triggers polling

Username

The username to log in with

Password

The corresponding password

Tenant Name

The Workday tenant ID, which usually has the suffix _pt1 appended to it, such as acme_pt1

Scheduling Strategy tells the source how it can poll the data. This field accepts two options:

  • Fixed Frequency

    Polls for data at a specified number of milliseconds, seconds, minutes, hours, or days. The default is 1000 milliseconds.

  • Cron

    Accepts an expression that polls for data based on a filter, such as, every Monday in a month at a given time. See Cron Expressions for examples.

To validate connectivity using the Test Connection button, the Workday connector uses an Identity_Management WSDL service with the Get_Workday_Account_Signons_Request operation. Ensure that your service account has permissions to operate on that service. If not, use of Test Connection fails.

Configure Other Operations

Each Workday operation has its own required fields in Anypoint Studio. For more information, see the Connector Reference.

Increase Timeout in Studio

Depending on connectivity conditions while using Studio, there can be a timeout while obtaining metadata from the Workday connector.

Symptoms

There can be two types of errors for this condition:

org.mule.runtime.api.exception.MuleRuntimeException: Error while retrieving soap client id [Absence_Management]
  org.mule.runtime.api.exception.MuleRuntimeException: Error while retrieving soap client id [Absence_Management]
  Caused by: java.util.concurrent.ExecutionException:
  org.mule.wsdl.parser.exception.WsdlParsingException: Error processing
  WSDL file [https://wd3-impl-services1.workday.com/ccx/service/deakin_amu1/Absence_Management/v29.1?wsdl]:
  Unable to locate document at 'https://wd3-impl-services1.workday.com/ccx/service/deakin_amu1/Absence_Management/v29.1?wsdl'.

Or:

org.mule.tooling.client.api.exception.TimeoutException: Mule Agent REST service timed out
  org.mule.tooling.client.api.exception.TimeoutException: Mule Agent REST service timed out
  javax.ws.rs.ProcessingException: java.net.SocketTimeoutException: Read timed out
  	at org.glassfish.jersey.client.HttpUrlConnector.apply(HttpUrlConnector.java:244)
  	at org.glassfish.jersey.client.ClientRuntime.invoke(ClientRuntime.java:245)
  	at org.glassfish.jersey.client.JerseyInvocation$1.call(JerseyInvocation.java:671)
  	at org.glassfish.jersey.client.JerseyInvocation$1.call(JerseyInvocation.java:668)
  	at org.glassfish.jersey.internal.Errors.process(Errors.java:315)
  	at org.glassfish.jersey.internal.Errors.process(Errors.java:297)
  	at org.glassfish.jersey.internal.Errors.process(Errors.java:228)
  	at org.glassfish.jersey.process.internal.RequestScope.runInScope(RequestScope.java:444)
  	at org.glassfish.jersey.client.JerseyInvocation.invoke(JerseyInvocation.java:668)
  	at

Solution

When one of these conditions occurs:

  1. In Anypoint Studio, navigate to Preferences > Anypoint Studio > Tooling.

  2. Double the values for Default Connection Timeout and Default Read Timeout.

  3. Click Apply, and restart Studio.

Next Step

After configuring Workday Connector in Studio, see the Examples for financial management use cases that demonstrate the use of this connector.