Setup - Oracle HCM

This guide is self-contained — every permission and scope required is listed in the steps below. For why each permission is needed, alternative permission models, and the full security and permission-propagation details, see Permissions & Security - Oracle HCM.

Prerequisites

Who you need to be

• Oracle HCM administrator, or a user with permission to create integration accounts and assign Oracle HCM roles

• Ability to grant REST API access to learner learning records

• Simpplr Enterprise Search administrator access to add and configure connectors

Network and firewall

• Outbound HTTPS access from Simpplr Enterprise Search to your Oracle HCM Cloud tenant URL (for example, https://{tenant}.fa.{region}.oraclecloud.com)

• Allowlist your Oracle HCM tenant hostname if your organization restricts outbound traffic

Step 1 — Prepare Oracle HCM

Credentials you will need from the source

• Oracle HCM domain — your tenant base URL

• Username — integration account username

• Password — integration account password

1. Sign in to your Oracle HCM Cloud administrator console.

2. Identify your Oracle HCM domain — the base URL for your tenant (for example, https://acme.fa.us6.oraclecloud.com).

3. Create or designate an integration user for Enterprise Search.

4. Assign the integration user an Oracle HCM role with REST API read access to learner learning records (for example, Human Capital Management Integration Specialist). See Permissions & Security - Oracle HCM for why this is needed.

5. Confirm the integration user can read learner assignment records within your Oracle data security policies.

Step 2 — Add Oracle HCM as a source in Simpplr Enterprise Search Admin Panel

1. In Simpplr, go to: Manage features → Enterprise search → Add source.
   

2. Search for and select Oracle HCM learners.
   

3. Enter a Connection name for this instance.

4. Enter the connector configuration:

   • Oracle HCM domain — your tenant base URL

   • Username — integration account username

   • Password — integration account password

   

5. Click Save configuration and confirm.

Step 3 — Add filters and ingestion scope

Filters control which content gets indexed. All filters are optional — if none are set, all learner assignment records the integration account can read are indexed.

1. Set date filter - limit indexing to learning assignments updated after a specific date
   

2. Set Audience configuration (optional) — restrict the connector to a specific Simpplr audience. Only members of the selected audience will be able to find this content in Enterprise Search.
   

3. Click Save and sync — this saves the configuration and initiates the first full sync.

   Alternatively, click Exit to save and resume setup later. To start the sync manually, go to Enterprise search → Oracle HCM → Status and click Sync now.

Step 4 — Verify the sync

1. Monitor progress at: Enterprise search → Oracle HCM → Status.

2. The dashboard shows sync status, total items indexed, and any errors.
   

What success looks like:

• Shortly after the connector is initialised, the status shows In progress and the item count begins increasing.

• When the initial full sync completes, the status shows Success and Oracle HCM learner assignment records appear in Enterprise Search.

• Initial full sync duration depends on the number of learning items and assignment records — large tenants can take several hours.