Quickstart - Invoke Workday Operation

Overview

The purpose of this guide is to help you create a working sample that uses the Workday Invoke Workday Operation activity.

This working sample enables you to quickly verify the connection to your Workday tenant and get familiar with the activity's input/output datatypes.

After completing the steps in this guide, you'll have an automation sequence that does the following:

1. Establishes a connection to your Workday tenant ( and Workday Scope).
2. Invokes an API operation that will retrieve a list of workers from your Workday tenant (Invoke Workday Operation).

Prerequisites

Before you begin:

1. Complete the Workday Setup steps.
2. Ensure the account you use will be able to access the Get Workers API.

Steps

Build your project

1. Add a activity.
2. Enter the AssetName for the credential asset you created (during the Setup) for the application Client Secret (e.g., "WorkdayUsernamePassword").
3. Create and enter a SecureString variable for the Password property (e.g., password).
4. Create and enter a String variable for the Username property (e.g, username).
5. Add the Workday Scope activity after the Get Credential activity.

6. Click the Configure button (this opens the Connection Wizard), enter your Workday credentials, and click the Connect button. For more information about the purpose and behavior of this wizard, see the section.

   • This step is for design time purposes only. To populate the Workday Scope properties, continue to complete the steps below.
7. In the Username property, enter the String variable you created for the Get Credential activity or substep above (e.g., username).
8. In the Password property, enter the SecureString variable you created for the Get Credential activity (e.g., password).
9. In the Tenant property, create and enter a String variable for your tenant (e.g., tenant).
10. In the TenantURL property, create and enter a String variable for the URL (e.g._tenantURL).

11. Add the Invoke Workday Operation activity inside the Workday Scope activity.

    1. Click the Configure button (this opens the Object Wizard).
    2. In the Search Operations text input, type in 'Get_Workers'. Select the Get_Workers (Human Resources) operation. The parameter list will populate based on this selection.
    3. Create and enter a variable to capture the output from the Get_Workers_ResponseRootType property, e.g. getWorkersResponse
    4. Click the Done button.
    5. In the ResponseStatus property, create and enter a ResponseStatus variable (e.g., responseStatus).

12. Add an If activity after the Invoke Workday Operation activity.

    1. In the Condition property, enter the following responseStatus.Success.ToString()="True".
    2. In the Then statement box, add aWrite Line activity and enter the variable you created for the Get_Workers_ResponseRootType property and then append ".Response_Data.length" (e.g., getWorkersResponse.Response_Data.Length).
    3. In the Else statement box, add aWrite Line activity and enter the following Text: "Failed:\nErrorCode:"+responseStatus.ErrorCode+"\nError Message:"+responseStatus.Message.

13. Click Run and verify the Output window includes the expected write line values.

    
    

    

    
    

You're done!

To learn more about the Workday activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.