Integrate Oracle HCM

Deploy the Oracle HCM integration to deliver actionable notifications to item managers about their items, and view and edit items directly in Workspace.

For comprehensive details of the out-of-the-box microapps for Oracle HCM, see Use Oracle HCM microapps.

Review prerequisites

These prerequisites assume that the administrator is part of the Oracle HCM integration set up of the organization.

You need these artifacts to add the integration in Citrix Workspace Microapps:

  • Base URL: The base URL follows this model: {serverURL}/hcmRestApi/resources. Find the REST serverURL in the welcome email that was provided to your Oracle Cloud service administrator. Replace the {serverURL} value in our model with your serverURL.
  • Username: We recommend using the username and password of the dedicated service account as specified below.
  • Password: We recommend using the username and password of the dedicated service account as specified below.


It is recommended that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.


The integration requires regular access to your Oracle HCM instance. Create a dedicated service account in Oracle HCM for this implementation. The account requires access to this data only:

  • employee directory
  • absences
  • time entry

Adding the integration to Citrix Workspace Microapps

Add the Oracle HCM 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:

  1. From the Microapp Integrations page, select Add New Integration, and Add a new integration from Citrix-provided templates.
  2. Choose the Oracle HCM tile.
  3. Enter a name for the Integration.
    • Enter the instance Base URL: https://adc4-zrha-fa-ext.oracledemos.com/hcmRestApi/resources.This base URL value might be different.
    • Select an Icon for the integration from the Icon Library, or leave this as the default icon.
  4. Under Service authentication, select Basic from the Authentication method menu and complete the authentication details.
  5. Enter your Username and Password.
  6. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes. Leave all other toggles disabled.
  7. Select Save to proceed.

You are now ready to set and run your first data synchronization. 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 Oracle HCM connector specifications.

Use Oracle HCM microapps

Existing application integrations come with out-of-the-box microapps. Start with these microapps and customize them for your needs.

Employee Directory: View and search employee directory.

Notification or Page Use-case workflows
Employee Search page Search for an employee by name.
Employee Detail page Details of selected employee after searching.

Enter My Time: Enter daily time for selected entry types.

Notification or Page Use-case workflows
Time Entry page Submit a time card (using deeplink) or time entry with start and end time for the selected entry type.

PTO: Create and submit absences.

Notification or Page Use-case workflows
Create Absence page Provides a form with absence parameters to create a new absence entry.
Integrate Oracle HCM