Skip to content

Oracle API Integration Connection

Oracle HCM is a complete cloud solution that connects every human resource process and every person across enterprises. Hire2Retire product supports Oracle API Integration as the entry point to fetch employee's data.

Create a Connection

The API integration of Oracle uses OAuth2 mechanism for authentication. Oracle requires the following keys to authenticate its clients using this mechanism:

  • Client ID - The client ID is in your app settings in Oracle Identity Cloud Service. Just go to Configuration > General Information.

  • Client Secret - The client Secret is in your app settings in Oracle Identity Cloud Service. Just go to Configuration > General Information.

  • Scope - The scope value for your Oracle Integration instance can be found in the trusted app settings. Simply navigate to Configuration > Accessing APIs. Under Allowed Scopes, you will typically see a scope similar to this one: https://CA6ABF5D.myhost.example.com:443urn:opc:resource:consumer::all.

  • Identity Cloud Service URL - The Identity Cloud Service URL is the gateway to Oracle Identity Cloud Service. It's where administrators handle configurations, and users manage their account details and app access.

  • Oracle Integration instance URL - The base URL for Oracle HCM REST APIs it varies based on your specific instance and Oracle Cloud environment.

Connection page

Figure 1. Oracle API Connection Set Up page - Create Connection

Obtaining Identity Cloud Service URL for Oracle

To obtain your Identity Cloud Service URL, follow the instructions on this page.

Obtaining Oracle Integration instance URL for Oracle

To obtain your Oracle Integration instance URL, follow the instructions on this page.

Configuration

Once you have successfully configured the connections, you can continue with the Design section to configure the rest of the workflow following these steps in order.

  1. HR Employee Data Definition
  2. Lifecycle Business Rules
  3. Employment Status
  4. HR to AD Profile Map
  5. Organizational Unit Assignment - Only defined in on-premise Active Directory
  6. Security Group Assignment
  7. Distribution List Assignment

Deployment

Once your workflow has been setup, you can optionally setup notifications and archival for your workflow.

Otherwise, you can proceed to deploy and test it on the Hire2Retire platform, see Deploy and Test Flow