Before You Install the Recipe

You must perform the following configuration tasks on your Oracle HCM Cloud instance, HireRight instance and sFTP server in order to successfully connect to these external systems using Oracle Integration and import verified employees.

Configure Oracle HCM Cloud

To access the Oracle HCM Cloud instance from Oracle Integration, you’ll require a separate user account on Oracle HCM Cloud if you do not already have one in place.

Log in to the Oracle HCM Cloud instance as an Administrator and perform the following tasks:

  1. Create a user account for Oracle Integration which will be required to connect to Oracle HCM Cloud from Oracle Integration.
  2. Assign roles to the user account. See Assign Required Roles to an Integration User in Using the Oracle HCM Cloud Adapter with Oracle Integration 3.
For more information, see Prerequisites for Creating a Connection in Using the Oracle HCM Cloud Adapter with Oracle Integration 3.

Configure HireRight

To access HireRight from Oracle Integration, you must perform certain configurations on your HireRight instance.

Note that the following tasks will involve the coordination with a HireRight implementation specialist.
  1. API endpoints.
    • Production: Provided by your HireRight implementation specialist.
    • Staging: Provided by your HireRight implementation specialist.
  2. API Header information

    These values are required for every integration against HireRight.

    Header Description
    hr-API-key

    The API key is unique per client. HireRight will grant an API key for each client. If client uses REST connect API for background checks ordering, hr-API-key will be the same for background checks and monitoring roster management API calls.

    hr-companylogin

    Company login in HireRight system.

    String, max length: 7
    hr-user-ref-id

    Reference of the user (UserRefId) in HireRight system

    String, max length: 50
    hr-APIversion

    Version of Monitoring Roster and Alerts API. Current version is v1.

    String, max length: 10
  3. Setup the following flex field in HireRight.
    • clientPersonId

    To know more about how to set up this flex field, contact your HireRight implementation specialist.

  4. Retrieve the monitoring values.

    These values are required for several of the integrations against HireRight where a payload is sent.

    Value Description
    hr_MonitoringId The id of the service that you subscribe to with HireRight.
    hr_Monitoringname The name of the service that you subscribe to with HireRight.

In addition to the above tasks, to access Oracle Integration from HireRight when sending alerts, Oracle recommends that you create a user specifically for HireRight. To complete this task, see Manage Access and Assign Roles in Provisioning and Administering Oracle Integration 3. Once the user account has been created, share this information with your HireRight implementation specialist. You'll also have to share the endpoint URL for the Oracle HCM Inbound Integration from HireRight using either HCM DataLoader or REST API.

Access an sFTP Server

You have to access an sFTP server and create necessary folders in it to host the HCM Extract for the initial load as well as any error files that are generated.

You can also use the embedded sFTP server (File Server) in Oracle Integration. To use File Server, you must enable it for your Oracle Integration instance. See Enable File Server in Using File Server in Oracle Integration 3.

Note that if you set up File Server, you may need to make modifications to the integrations in the recipe based on the implementation pattern that your Oracle Integration administrator has set up for your File Server.