Integrate Workday 编辑

Integrate with Workday to make it easy to submit requests, receive notifications about request status, and act on notifications. After you complete this process, your existing level of audit logging persists, including any actions carried out by the use of Citrix Microapps. Use the following process to enable the Workday Integration. For a comprehensive list of out-of-the-box Workday microapps, see Use Workday microapps.

Note

We provide two Workday integration templates for your use. We recommend using the newer HTTP integration for most use-cases as it provides more power to configure the cached data structure. For full details of the microapps available in each integration, see Use Workday microapps.

These instructions describe how to set up the new HTTP template integration. If you need information about the legacy template, see Add the legacy integration. A quick overview of the process:

1. Before setting up the integration in Microapps, ensure you meet the prerequisites and then complete the following procedures that are described in detail below:

   • Enable API access by registering an API Client and generating and collecting the Client ID and Client Secret.
   • Create custom reports.
   • Generate custom report endpoint path.
   • Filter PTO Types to restrict PTO microapps to specific time-off types.
   • Set up deep linking in Workspace.
   • Edit business process for time-off requests.
   • Manage security group permissions.
   • Identify your URL, Instance URL, and Tenant.
2. Set up the Workday integration. For more information, see Add the Workday integration to Citrix Workspace Microapps.
3. Configure Service action parameters. For more information, see Replace Data Loading and Service Action variables.

If you need help, have a look at our Troubleshoot common Workday integration errors article.

Review prerequisites

This set up process requires you to have an admin account and the following service account privileges for the Workday connector.

• Access to the creation of non-temporary custom reports.
• Access to HumanResources, Integrations, PerformanceManagement, ResourcesManagement, and custom reports APIs.
• For downloading milestone data, part of the deep link set-up process, you need the following security groups assigned to the admin:
  • HR Administrator
  • Information Administrator
• Configure Citrix Gateway to support single sign-on for Workday so that once users log in they are automatically logged in again without having to enter their credentials a second time. Follow the instructions in Workday Single Sign-on Configuration. For more information about configuring SSO, see Citrix Gateway Service.

After you set up this integration in Workday, you need these artifacts to enter these account credentials when you set up the integration in Microapps:

• URL
• Username (Workday username)
• Password (Workday password)
• Workday tenant
• Client ID
• Client Secret
• Workday REST API Endpoint
• Token Endpoint
• Authorization Endpoint
• Custom report URLs collected

Register Workday API Client

Register an API client to generate a Client ID and Client Secret for each environment. If you have multiple environments, you must register an API Client for each individual environment. For the Workday integration, you must add two different callback URLs. This means you need to register two API clients; one for user actions and the other for synchronization. Perform this procedure twice. Once for Service Authentication and then for Service Action Authentication. They have different callback URLs. For the Legacy integration template, only perform the second operation to register the client.

Configure OAuth server

Configure the OAuth server to read data through the integration. You use these details for Service Authentication while configuring the integration. This is only performed for the HTTP integration.

1. Log in to Workday as an admin, and search for Register API Client. Complete the required fields:

   • Enter your Client Name.
   • Select Authorization Code Grant for Client Grant Type.
   • Select Bearer for Access Token Type.
   • Enter the Redirection URI: https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext. The callback depends on the target application, and can be found in your URL address bar when creating the integration. The section {yourmicroappserverurl} is composed of a tenant part, a region part, and an environment part: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
   • Enter the value 300 for Refresh Token Timeout (in days).
   • Select the following Scope (Functional Areas):
     • Organizations and Roles
     • Staffing
     • Tenant Non-Configurable
2. Select OK. The Client ID and Client Secret are generated. Collect and save for later use during the set-up process. You use these details for Service Authentication while configuring the integration.
3. Select Done to complete and exit.

Configure OAuth client

Configure the OAuth client for writing back data through the integration. You use these details for Service Action Authentication while configuring the integration.

1. Log in to Workday as an admin, and search for Register API Client. Complete the required fields:

   • Enter your Client Name.
   • Select Authorization Code Grant for Client Grant Type.
   • Select Bearer for Access Token Type.
   • Enter the Redirection URI: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback. The callback depends on the target application, and can be found in your URL address bar when creating the integration. The section {yourmicroappserverurl} is composed of a tenant part, a region part, and an environment part: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
   • Enter the value 300 for Refresh Token Timeout (in days).
   • Select the following Scope (Functional Areas):
     • Organizations and Roles
     • Staffing
     • Tenant Non-Configurable
2. Select OK. The Client ID and Client Secret are generated. Collect and save for later use during the set-up process. You use these details for Service Action Authentication while configuring the integration.
3. Select Done to complete and exit.

Test API calls

This article lists all Workday API calls and provides a detailed description of how to test whether your Workday instance has all endpoints ready for these calls. For more information, see Test Workday API calls.

Create custom reports

You create custom reports in Workday for each of the following reports. Download the attached spreadsheets and complete the details precisely as described in the spreadsheet. If any detail you enter differs from the provided report, the process does not work. For example, if you use an incorrect name, the report is generated, but no data is downloaded.

The following reports are the current reports. When we add new end-points to this integration, they are added here in the product documentation.

1. Open one of the following custom report spreadsheets:

   • All time offs and balance

     • Calculated field: cf lkp time off balance year
     • Calculated field: cf lkp time off plan default quantity
     • Calculated field: cf lkp time off plan id
     • Calculated field: cf lkp time off type id
     • Calculated field: cf time off balance year
     • Calculated field: cf yearend for reporting effective years

   • Absence requests

     • Calculated field: cf lkp time off event id

   • Event records for change job

     • Calculated field: cf esi worker
     • Calculated field: cf lkp worker id

   • Staffing activities

     • Calculated field: cf esi event record
     • Calculated field: cf lkp event record

   • Event records for time off requests

     • Calculated field: cf esi event records awaiting action
     • Calculated field: cf esi assigned to worker of event records of awaiting action
     • Calculated field: cf lrv assigned to worker email of event records awaiting action
     • Calculated field: cf lrv assigned to worker event records of awaiting action
     • Calculated field: cf lrv wid of assigned to worker email of event records awaiting action
     • Calculated field: cf lrv wid of event record awaiting action

   • Worker

     Note:

     Do not add self-referencing objects to the Time off types per plan report.

2. In Workday, search for Create Custom Report.
3. Enter a Report Name. This name must be identical to the spreadsheet of the report that you want to create a URL for.
4. Select Advanced as Report Type.
5. Enter the Data Source. This value must be identical to the spreadsheet of the report that you want to create a URL for.
6. Do not select the Optimized for Performance check box.
7. Do not select the Temporary Report check box.
8. Select the Enable As Web Service check box.

9. Select OK.

   The custom report opens unpopulated except for the three fields you entered.

10. Complete the details exactly as described in the spreadsheet. Pay attention to the headings. The headings match the tabs in the Workday UI.
11. The field Column Heading Override XML Alias is auto-generated as you are populating the columns. Verify that the value in Column Heading Override XML Alias matches the spreadsheet instructions. This value often varies.
12. Select OK. The custom report is created.

Generate custom report endpoint path

You collect the custom report path by using the generated WSDL from the previous procedure. Use this when you enter the custom report URL for Time off types per plan report path and Event records for milestone path in the set-up procedure.

1. Open the generated WSDL link in your browser.
2. Scroll to the bottom and locate two URLs. The second one has the name ReportREST. This is the one we want to use.
3. Copy the path from this URL and use it when setting up the Workday integration. (Example path: </ccx/service/customreport2/company_tenant/user_name/report_name>.

Filter PTO Types

Restrict PTO microapps to specific time-off types, such as vacation, or sick leave. If you created the following custom reports in Workday, you need to create calculated fields in Workday and filter custom reports using the following procedures.

• Event records for time off requests
• Absence requests
• All time offs and balance

Create calculated fields for Time Off Requests microapp

You need to create two calculated fields. The first calculated field is intended to retrieve the Absence Type from the Time Off Event so it is available in the second calculated field. The second calculated field is used as the filter in the custom report.

1. Log in to your Workday instance and search for create calculated field.
2. Complete all fields:
   • Field Name Enter a name for the calculated field. For example, SANDOVAL CF LKP Absence Type from this format: {(report creator)(CF=calculated field)(LKP=lookup related value)(values this field returns)}.
   • Business Object Find and select Time Off Event. We want our calculated field to be part of this business object.
   • Function Find and select Lookup Related Value.
3. Select OK at bottom left.
4. Under the Calculation tab, complete these fields:
   • Lookup field Find and select Time Off Event.
   • Return Value Find and select Time Off Types for Time Off Event
5. Select OK and then Done.

You created a calculated field. Now, let’s create the second field that retrieves the Time Off Event and will be used as the filter.

1. Again, from your Workday instance search for create calculated field.
2. Complete all fields:
   • Field Name Enter a name for the calculated field. For example, SANDOVAL CF LKP Time Off Event for Business Process from this format: {(report creator)(CF=calculated field)(LKP=lookup related value)(values this field returns)}.
   • Business Object Find and select Action Event. We want our calculated field to be part of this business object.
   • Function Find and select Lookup Related Value.
3. Select OK at bottom left.
4. Under the Calculation tab, complete these fields:
   • Lookup field Find and select Time Off Event.
   • Return Value Find and select the first calculated field you created. In our example, SANDOVAL CF LKP Absence Type.
5. Select OK and then Done.

Filter a custom report using calculated field for Time Off Requests microapp

Add a filter to the custom report related to time off approval using the new calculated field that you just created to whitelist PTO Types, which will allow you to get all time off types you select.

1. From your Workday instance search for Edit Custom Report and select a custom report related to PTO approvals, in our case Event Records for Time Off Requests.
2. Select Filter tab and + to add new filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the second calculated field you created, in our example SANDOVAL CF LKP Time Off Event for Business Process.
   • Operator Find and select any in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Annual Leave (Days)
     • Annual Leave (Statutory)
     • Personal Leave (Days)
     • Sick (Days)
     • Time Off
4. Select OK to save.

Note:

To block PTO Types, change field: *Operator to none of the selection list. This blocks the integration from getting any selected PTO types.

Filter a custom report using an existing field for Create PTO Requests and My PTO Requests microapps

Filter custom report: All time offs and balance.

Note:

We recommend using the same PTO types in all custom reports. This way if you decide to whitelist or block the outcome, the values in Comparison Value is the same for all custom reports).

1. From your Workday instance search for Edit Custom Report and select a custom report related to time off approvals, in our case All time offs and balance.
2. Select Filter tab and + to add new filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the custom report Time Off Type.
   • Operator Find and select in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Annual Leave (Days)
     • Annual Leave (Statutory)
     • Personal Leave (Days)
     • Sick (Days)
     • Time Off
4. Select OK to save.

Filter custom report: Absence requests.

1. From your Workday instance search for Edit Custom Report and select a custom report related to time off approvals, in our case Absence requests.
2. Select Subfilter tab and select + to add new subfilters, similar to how you added filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the custom report Time Off Type for Time Off Entry.
   • Operator Find and select in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Paid Time Off (Days)
     • Sick (Days)
     • Sick (Hours)
4. Select OK to save.

Set up deep link in Workspace

If you are referred to this article, contact your administrator and request that they set up deep linking for Citrix Workspace Microapps in Workday.

The following use-cases require the corresponding deep links. For example, if your domain is impl.workday.com and your tenant is citrix_gms2v, then the URL for Create expense report is: https://impl.workday.com/citrix_gms2/d/task/2997$995.htmld:

• Create Expense Report https://your_domain/your_tenant/d/task/2997$995.htmld

• Create Change Job https://your_domain/your_tenant/d/task/2997$4819.htmld

• Approve/Deny Change Job (Change Job Requests) https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld

Note:

If you do not have this data stored, log in to your Workday account and copy them from the URL. These deep links must be set up with every newly added integration.

Edit business process for time-off requests

Depending on the Workday tenant that you are using, you have a business process established for creating time-off requests. Modify that business process as shown in the following steps.

1. In Workday, search for bp: request time off, and then select Request Time Off for Global Modern Services.
2. Go to Actions > Business Process > Edit Definition.
3. Do not change Effective Date unless required, and select OK.
4. Under Business Process Steps, select the + icon to add a new row.
5. Enter b for Order.
6. Enter Approval for Type.
7. Select Manager for Group from the menu.
8. Select OK, and then Done.

Manage security group permissions

To enable proper security permissions for your security group, you complete two procedures. First add permissions to the group and activate the settings. Then add the security group to view all list and activate the settings.

Add and activate integration permissions

1. In Workday, search for view security group.
2. Search for the security group that you need, select it, and select OK.
3. Go to Actions > Security Group > Maintain Security Permissions.

4. Under the section Integration Permissions, search for the following list of permissions in the Domain Security Policies permitting Get access field, and add them all. Do not use colons (:) in your search:

   

   • Manage: Organization Integration
   • Worker Data: Public Worker Reports
   • Set Up: Spend Categories
   • Worker Data: Headcount Reports
   • Business Process Administration
   • Business Process Reporting
   • Set Up: Expense Item
   • Process: Purchase Order – View
   • Process: Expense Report – View
   • Worker Data: Active Employees
   • Worker Data: Current Staffing Information
   • Worker Data: Time Off (Time Off Balances)
   • Worker Data: Time Off (Time Off)
   • Worker Data: Time Off
   • Reports: Time Tracking
5. Select OK, review, and then select Done.
6. Search for Activate Pending Security Policy Changes.
7. In the Comment field, type Activate, and select OK.
8. Select the Confirm check box, and then select OK. Permissions have been updated and activated.

Add and activate security group to view all list

1. Search for bp:change job and select Change Job for Global Modern Services.

2. Go to Actions > Business Process > Edit.

   

3. Scroll to the section View All. Add your security group to the list of security groups that can view all.
4. Select OK, and then Done.
5. Search for Activate Pending Security Policy Changes.
6. In the Comment field, type Activate, and select OK.
7. Select the Confirm check box, and then select OK. Permissions have been updated and activated.

You can view your security group by searching for View security group and selecting your security group. There are now two tabs, Domain Security Policy Permissions and Business Process Security Policy Permissions.

Find your base URL

You need to enter the base URL (domain) for your Workday environment to enable API calls. The format is https://{domain}.workday.com. For example, if the Workday REST API Endpoint is https://wd2-impl-services1.workday.com/ccx/api/v1/citrix_gms, your base URL is wd2-impl-services1. Follow the following procedure to identify your base URL.

1. Log in to Workday as an admin and search for View API Clients.
2. Look at the first field called Workday REST API Endpoint. The format is https://{domain}.workday.com/ccx/api/v1/{tenant}.

Add the Workday integration to Citrix Workspace Microapps

Add the Workday integration to Citrix Workspace Microapps to connect to your application. This delivers out-of-the-box microapps with pre-configured notifications and actions which are ready to use within your Workspace.

Follow these steps to set up the Workday HTTP integration. The authentication options are preselected. Ensure that these options are selected as you complete the process. We recommend using this newer HTTP integration for most use-cases. The HTTP integration provides more power to configure the cached data structure.

Follow these steps:

1. From the Microapp Integrations page, select Add New Integration, and Add a new integration from Citrix-provided templates.
2. Choose the Workday tile from the Integrations category of the catalog.
3. Enter an Integration name for the integration.
4. Enter Connector parameters.
   • Enter the instance Base URL. This is the domain for your Workday environment, for example wd2-impl-services1. For more information about identifying your base URL, see Find your base URL.
   • Select an Icon for the integration from the Icon Library, or leave this as the default Workday icon.
   • Enable the On-premises instance toggle if you are creating an on-premises connection. For more information, see On-premises instance.

   

5. Enter your Workday username.
6. Enter your Workday password.
7. Enter your Workday tenant. For more information about identifying your tenant, see Find your base URL.
8. Under Service authentication, select Basic from the Authentication method menu and complete the authentication details.

9. Enter your Username and Password.

   

10. Under Service Action Authentication, enable the Use Separate User Authentication in Actions toggle. Service action authentication authenticates at the service action level.

    1. Select OAuth 2.0 from the Authentication method menu and complete the authentication details.
    2. Select Authorization code from the Grant type menu. This grants a temporary code that the client exchanges for an access token. The code is obtained from the authorization server where you can see the information the client is requesting. Only this grant type enables secure user impersonation. This will display the Callback URL, which you use when registering your application
    3. Select Authorization header from the Token authorization menu.
    4. Enter your Authorization URL. This is the format: {instance_url}/{tenant}/authorize. This is the authorization server URL provided when setting up the target application integration. For more information about identifying your base URL and tenant, see Find your base URL.
    5. Enter your Token URL. This is the format: {base_url}.workday.com/ccx/oauth2/{tenant}/token. This is the URL of the access authorization token.
    6. Enter your Client ID. The client ID is the string representing client registration information unique to the authorization server. You collect this and the secret by registering the OAuth client in your Google account. You need to add the Callback URL you see on the integration configuration page.
    7. Enter your Client secret. The client secret is a unique string issued when setting up the target application integration.

    

11. (Optional) If you want to activate rate limiting for this integration, enable the Request rate limiting toggle and set the Number of requests per Time interval.

12. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes.

    

13. Select Save to proceed.
14. Under OAuth Authorization, select Authorize to log in with your service account. A pop-up appears with a Workday login screen.
    1. Enter your Service Account user name and password and select Log in.
    2. Select Accept.

Replace Data Loading and Service Action variables

To complete this set up, you need to replace the {tenant}and {user} variables in the Workday integration configuration with your tenant and the user credentials that you use for authentication.

1. From the Microapp Integrations page, select the menu next to the Workday integration, and then Edit. The Data Loading screen opens. If not, select Data Loading from the left side navigation column.

2. For each data endpoint, you must manually add your details for:{tenant}/{user}. You do this six times. Select the menu next to the endpoint and Edit.

3. In the Edit Data Endpoint screen, under the PATH tab add your tenant and user to the empty fields.

4. Select Apply and confirm. Repeat for the other five data endpoints.

   

5. For each service action, you must manually add your details for:{tenant}. You do this twice. While editing the integration, select Service Actions from the left side navigation column. Select the menu next to one of the service actions and Edit.

   

6. In the Edit Service Action screen, under Action execution and the PATH tab replace the tenant value (citrix_gms2) with your tenant.

   

7. You need to delete and recreate Data update after action. Next to Data update after action label, select the delete icon to remove this section.
8. Select + Add data update.
9. Select time off request from the Data Endpoint menu.
10. Select the QUERY tab, and select + Add parameter.

11. Enter Completed_Date_On_or_After for Parameter name. From the Choose parameter menu, select timestamp.

    

12. Select Save to finish. Repeat for the other service action.

You are now ready to set and run your first data synchronization. As a large quantity of data can be pulled from your integrated application to the Microapps platform, we recommend you use the Table page to filter entities for your first data synchronization to speed up synchronization. For more information, see Verify needed entities. For complete information about synchronization rules, synchronization that does not meet its schedule and veto rules, see Synchronize data.

For more details of API endpoints and table entities, see Workday HTTP connector specifications.

Use Workday microapps

Our Workday HTTP integration template comes with the following preconfigured out-of-the-box microapps.

Create Time Off Request: Submit a paid time-off (PTO) request.

Change Job: View and approve change job requests.

Create Change Job: Create a change job request.

Create Expense Report: Create an expense report.

My Time Off Request: View a personalized list of time-off requests.

Time Off Requests: View and approve paid time-off (PTO) requests.

Add the legacy integration

Follow these instructions to set up the legacy integration.

Create custom reports

You create custom reports in Workday for each of the following reports. Download the attached spreadsheets and complete the details precisely as described in the spreadsheet. If any detail you enter differs from the provided report, the process does not work. For example, if you use an incorrect name, the report is generated, but no data is downloaded.

The following reports are the Legacy reports. When we add new end-points to this integration, they are added here in the product documentation.

1. Open one of the following custom report spreadsheets:

   • Time off request details
   • Event records for time off requests
   • Event records for change job
   • Event records for expenses
   • Event records for milestones
   • Staffing activities

   • Time off types per plan

     Note:

     Do not add self-referencing objects to the Time off types per plan report.

2. Follow the process above.

Generate custom report URLs

To download data and generate notifications for the custom reports, you must generate the custom report URLs and download the WSDL. You need these URLs to complete the Microapps set-up procedure.

1. In Workday, open a custom report that you created.
2. Select Actions and select the name of the report to open settings.
3. Select Actions > Web Service > View URLs > WSDLs.
4. Enter any date in Entered On field.
5. Right-click on the WSDL link under Workday XML section and select Copy URL. (Example URL: https://wd2-impl-services1.workday.com/ccx/service/customreport2/company_tenant/user_name/report_name?wsdl)

Save the URL for use when you set up the microapp in the Add the integration to Citrix Workspace Microapps procedure.

Filter PTO Types

Restrict PTO microapps to specific time-off types, such as vacation, or sick leave. If you created the following custom reports in Workday, you need to create calculated fields in Workday and filter custom reports using the following procedures.

• Event Records for time off requests
• Time off request details
• Time off types per plan

Create calculated fields for PTO Requests microapp

You need to create two calculated fields. The first calculated field is intended to retrieve the Absence Type from the Time Off Event so it is available in the second calculated field. The second calculated field is used as the filter in the custom report.

1. Log in to your Workday instance and search for create calculated field.
2. Complete all fields:
   • Field Name Enter a name for the calculated field. For example, SANDOVAL CF LRV Absence Type from this format: {(report creator)(CF=calculated field)(LRV=lookup related value)(values this field returns)}.
   • Business Object Find and select Time Off Event. We want our calculated field to be part of this business object.
   • Function Find and select Lookup Related Value.
3. Select OK at bottom left.
4. Under the Calculation tab, complete these fields:
   • Lookup field Find and select Time Off Event.
   • Return Value Find and select Time Off Types for Time Off Event
5. Select OK and then Done.

You created a calculated field. Now, let’s create the second field that retrieves the Time Off Event and will be used as the filter.

1. Again, from your Workday instance search for create calculated field.
2. Complete all fields:
   • Field Name Enter a name for the calculated field. For example, SANDOVAL CF LRV Time Off Event for Business Process from this format: {(report creator)(CF=calculated field)(LRV=lookup related value)(values this field returns)}.
   • Business Object Find and select Action Event. We want our calculated field to be part of this business object.
   • Function Find and select Lookup Related Value.
3. Select OK at bottom left.
4. Under the Calculation tab, complete these fields:
   • Lookup field Find and select Time Off Event.
   • Return Value Find and select the first calculated field you created. In our example, SANDOVAL CF LRV Absence Type.
5. Select OK and then Done.

Filter a custom report using calculated field for PTO Requests microapp

Add a filter to the custom report related to PTO approval using the new calculated field that you just created to whitelist PTO Types, which will allow you to get all PTO types you select.

1. From your Workday instance search for Edit Custom Report and select a custom report related to PTO approvals, in our case Event Records for Time Off Requests.
2. Select Filter tab and + to add new filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the second calculated field you created, in our example SANDOVAL CF LRV Time Off Event for Business Process.
   • Operator Find and select any in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Annual Leave (Days)
     • Annual Leave (Statutory)
     • Personal Leave (Days)
     • Sick (Days)
     • Time Off
4. Select OK to save.

Note:

To block PTO Types, change field: *Operator to none of the selection list. This blocks the integration from getting any selected PTO types.

Filter a custom report using an existing field for Create PTO Requests and My PTO Requests microapps

Filter Time off types per plan custom report.

Note:

We recommend using the same PTO types in all custom reports. This way if you decide to whitelist or block the outcome, the values in Comparison Value is the same for all custom reports).

1. From your Workday instance search for Edit Custom Report and select a custom report related to PTO approvals, in our case Time off types per plan.
2. Select Filter tab and + to add new filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the custom report Time Off Type.
   • Operator Find and select in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Annual Leave (Days)
     • Annual Leave (Statutory)
     • Personal Leave (Days)
     • Sick (Days)
     • Time Off
4. Select OK to save.

Filter Time off request details custom report.

1. From your Workday instance search for Edit Custom Report and select a custom report related to PTO approvals, in our case Time off request details.
2. Select Subfilter tab and select + to add new subfilters, similar to how you added filters.
3. Complete these fields:
   • And/Or And
   • Field Find and select the custom report Time Off Type for Time Off Entry.
   • Operator Find and select in the selection list.
   • Comparison Type Find and select Value specified in this filter.
   • Comparison Value Find and select the PTO types that you want to whitelist, for example:
     • Paid Time Off (Days)
     • Sick (Days)
     • Sick (Hours)
4. Select OK to save.

Set up deep link in Workspace

If you are referred to this article, contact your administrator and request that they set up deep linking for Citrix Workspace Microapps in Workday.

The following use-cases require the corresponding deep links. For example, if your domain is impl.workday.com and your tenant is citrix_gms2v, then the URL for Create expense report is: https://impl.workday.com/citrix_gms2/d/task/2997$995.htmld:

• Create Expense Report https://your_domain/your_tenant/d/task/2997$995.htmld

• Create Milestone https://your_domain/your_tenant/d/task/2998$8704.htmld

• Create Change Job https://your_domain/your_tenant/d/task/2997$4819.htmld

• Approve/Deny Change Job (Change Job Requests) https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld

Note:

If you do not have this data stored, log in to your Workday account and copy them from the URL. These deep links must be set up with every newly added integration.

Add integration to Citrix Workspace Microapps

Follow these instructions to set up the legacy Workday integration.

Follow these steps:

1. From the overview page, select Get Started.

   The Manage Integrations page opens.

2. Select Add New Integration, and Add a new integration from Citrix-provided templates.
3. Choose the Workday tile.
4. Enter an Integration name.
5. Enter the Connector parameters that you collected as prerequisites.
   • Enter your URL to enable API calls. This is the domain for your Workday environment, for example wd2-impl-services1. For more information about identifying your base URL, see Find your base URL.
   • Enter your Workday instance for Instance URL. Find your instance domain by logging into your Workday environment, and copying the instance url. For example, https://impl.workday.com.
   • Enter your Workday Tenant location. Find an example of identifying the Workday tenant in Find your base URL.
   • Enter your Client ID and Client Secret collected in Prerequisites procedure.
   • Enter your Username and Password.
   • Enter the Days to load to set the day limit when loading data.

6. Toggle Enable Time off module? to Yes if you create time-off requests that Workday calculates and you want the data downloaded and notifications generated based on the data. You collected these URLs and paths in the procedure Generate custom report URLs and Generate custom report path.

   • Enter the custom report URL for Time off request details report URL.
   • Enter the custom report path for Time off types per plan report path.
   • Enter the custom report URL for Event records for time off requests report URL.

7. Toggle Enable change job module? to Yes if you create change jobs requests that Workday calculates and you want the data downloaded and notifications generated based on the data. You collected these URLs in the procedure Generate custom report URLs.

   • Enter the custom report URL for Event records for change job report URL.
   • Enter the custom report URL for Staffing activities report URL.

8. Toggle Enable expense module? to Yes if you create expense reports that Workday calculates and you want the data downloaded and notifications generated based on the data. You collected these URLs in the procedure Generate custom report URLs.

   • Enter the custom report URL for Event records for expenses report URL.

9. Toggle Enable purchase orders module? to Yes if you create purchase orders and you want the data downloaded and notifications generated based on the data. This uses a public API and does require a custom report.

10. Toggle Download milestone items? to Yes if you create milestone items and you want the data downloaded and notifications generated based on the data. You collected these paths in the procedure Generate custom report path.

    • Enter the custom report path for Event records for milestone path.
11. Select Add.

The Microapp Integrations page opens with your added integration and its microapps. From here you can add another integration, continue setting up your out-of-the-box microapps, or create a new microapp for this integration.

Legacy Workday microapps

Our legacy Workday integration template comes with the following preconfigured out-of-the-box microapps:

Change Job Request: View and approve change job requests.

Create Change Job: Create a change job request.

Create Expense Report: Create an expense report.

Create Milestone: Create a milestone.

Create PTO Request: Submit a paid time-off (PTO) request.

Expense Reports: View and approve expense reports.

Milestones: View milestone details and receive milestone updates.

My Expenses: View a personalized list of expense reports with report details and details of individual expense items.

My PTO Request: View a personalized list of time-off requests.

Purchase Orders: View purchase orders with purchase order details.

PTO Balance: View a personalized list of remaining time-off days.

PTO Requests: View and approve paid time-off (PTO) requests.