Integration Overview

Integration is bi-directional and supports the following data synchronization:

  • From Oracle HCM to Humanity: Employee’s personal data and Absence data
  • From Humanity to Oracle HCM: Schedule data synchronization

Synchronization is automatically triggered every hour.

Oracle HCM is the source of truth for employee and absence data. Data synced from Oracle HCM to Humanity shouldn’t be changed in Humanity.

Humanity is the source of truth for schedule data. Data synced from Humanity to Oracle HCM shouldn’t be changed in Oracle HCM.

Employee Data Synchronization

The integration will synchronize personal data for the employees that exist in the Oracle HCM account for which the integration is activated.

All employees from Oracle HCM will be synced to Humanity as users with Employee account permissions.

To set proper account permissions per user in Humanity, go to Staff > Click on the employee name to access their profile > Navigate to Permissions > Select the required permission level from the Account Type drop-down menu.

On the initial Employee sync, only the data for active employees will be synced from Oracle HCM to Humanity, while the data for terminated/deactivated users will be omitted.

Each newly-created employee account in Humanity will have the status Active to reflect that the employee is active in Oracle HCM. Therefore, an activation email (for password setup) won’t be sent to the employee.

If you would like to send an activation email to a single, newly-created employee in Humanity, you will need to:

  • Change that user’s status to Inactive in their Humanity profile
  • Go to the Not Activated list from the left side panel within the Staff module
  • Choose Send Activation E-mail Now

If you would like to send an activation email to a few, or all, newly-created employees in Humanity, you will need to:

  • Go to the Staff module and select the employees
  • Click on the Bulk Edit button in the upper-right corner
  • Select Send Activation e-mail within the Bulk Edit options
  • Go to Next Step on the bottom of the page
  • Confirm the action by clicking on Confirm

The following Employee data is synced from Oracle HCM to Humanity:

  • First Name
  • Last Name
  • Preferred Name
  • Work Email
  • Work Phone / Work Mobile Phone / Home Phone
  • Employee Number
  • Employee Status

Integration recognizes and synchronizes the data from Oracle HCM to Humanity upon the following actions:

  • Employee account created in Oracle HCM
  • Employee information updated in Oracle HCM — first name, last name, phone, email, status change, etc.
  • Employee deactivated/terminated in Oracle HCM

Important Notes

  • The integration will sync both users defined as Employees and as Workers (contingent workers, contractors) in Oracle.
  • Personal data set for Workers is limited, and some data won’t be synced to Humanity, such as their status (all Workers will be set to active in Humanity).
  • Phone Number sync: The integration will first search for a Work Phone in Oracle HCM; if one is not set, it will look for a Work Mobile Phone to sync; if one is not set, it will look for a Home Phone to sync.

Job Synchronization

Integration supports the synchronization of Employees’ Jobs from Oracle Cloud HCM to Position in Humanity. Employees’ Jobs synced from Oracle Cloud HCM will be assigned as Positions in Humanity.

Activating the Job sync is optional and can be done only when the Employee sync is being configured for the first time. Once enabled, it cannot be disabled.

Integration recognizes and synchronizes the data from Oracle Cloud HCM to Humanity upon the following actions:

  • Job created and assigned to Employee in Oracle Cloud HCM
  • Job for Employee updated in Oracle Cloud HCM
  • Job unassigned from Employee in Oracle Cloud HCM

If an Employee doesn't have an assigned Job in Oracle Cloud HCM, then that Employee will be synced to Humanity, but won't have an assigned position. If multiple Jobs have been assigned to an Employee, each Job will be synced and assigned in Humanity as Position.

Positions manually created in Humanity will not be deleted/overwritten by the integration with data from Oracle Cloud HCM. However, you shouldn’t manually delete or change a Position which is synced from Oracle Cloud HCM, as that data will be overwritten with data from Oracle Cloud HCM with the next sync.

Salary Synchronization

The integration supports the synchronization of Employee’s Salaries from Oracle HCM Cloud to Base Rate for their Position in Humanity. The Employee’s Salary data is pulled from their Assignment in Oracle HCM Cloud and is assigned to the Employee’s Position in Humanity.

The Salary sync activation is optional and can be done only when setting up the Employee sync configuration for the first time. Once enabled, it cannot be disabled. The precondition for Salary sync activation is activated Job Sync.

Humanity stores only hourly wage data. Therefore, only hourly Salary will be pulled from Oracle HCM Cloud.

The integration will recognize and synchronize the data from Oracle HCM Cloud to Humanity upon the following actions:

  • Salary added to Employee’s Assignment in Oracle HCM Cloud;
  • Salary changed in Employee’s Assignment in Oracle HCM Cloud;
  • Salary removed from Employee’s Assignment in Oracle HCM Cloud.

Location Synchronization

Integration supports the synchronization of Oracle HCM Cloud Departments to Humanity Locations. Employee’s assigned Department in Oracle HCM Cloud will become their assigned Location in Humanity.

The Location sync activation is optional and can be done only when setting up the Employee sync configuration for the first time. Once enabled, it cannot be disabled. The precondition for Location sync activation is activated Job Sync.

The Location manually created in Humanity will not be deleted/overridden by integration with data from Oracle HCM Cloud. However, if you delete/change a Location in Humanity which is synced from Oracle HCM Cloud, that data will be overridden with data from Oracle with the next sync.

If an employee doesn't have an assigned Department in Oracle HCM Cloud then that employee will be synced to Humanity, but won't have an assigned Location.

Integration recognizes and synchronizes the data from Oracle HCM Cloud to Humanity upon the following actions:

  • A new Department created and assigned to the employee in Oracle HCM Cloud
  • An existing Department assigned to the employee is updated in Oracle HCM Cloud
  • An existing Department assigned to the employee is either deleted or has been unassigned from the employee in Oracle HCM Cloud

Absence Data Synchronization

Integration supports synchronization of employee’s Absence data from Oracle HCM Time & Labor module to Humanity.

The Absence data that is synced from Oracle HCM to Humanity include:

  • Absence Type Name
  • Approved Absence Request Start Time
  • Approved Absence Request End Time

The integration recognizes and syncs data upon the following actions:

  • Approved absence request created in Oracle HCM
  • Approved absence request updated in Oracle HCM
  • Approved absence request deleted/ canceled in Oracle HCM

The integration will sync absence requests which are approved one month in the past and three months in the future, relevant to the date of the current sync runtime. For example, if the current sync is running on January 1st, 2020, it will import all changes that occurred in the period from December 1st, 2019 to March 31st, 2020.

Important Notes

  • Approved absence requests that have been synced will be visible in Humanity’s Dashboard On Leave widget, Leave module (Upcoming Absence), ShiftPlanning module (Schedule Overview, Leave Schedule, Staff Availability), Staff module (within employee profile in the Leave section), and Reports module (Vacations, Vacation Summary reports).
  • Absence request types in Oracle HCM may be in both hourly or daily units, but all approved absence requests will be synced to Humanity as full-day requests only.
  • If an employee takes an hourly absence request (for example, three hours on Thursday), that employee will be shown in the Leave Schedule as being unavailable for the whole day. The Manager will be able to see how many hours the employee is actually unavailable by pulling up the Vacation Summary Report (in Humanity’s Reports module). The information will be available in the Comments column.
  • For an accurate entitled absence days/hours amount, please refer to Oracle HCM as the primary source of truth for absence data. This information will not be synced to Humanity. In Humanity, Entitled Leave Days for each synced absence type will be set to 365/366 days by default.

Schedule Data Synchronization

Integration supports synchronization of employee’s Schedule data from Humanity to Oracle HCM Time & Labor module.

The schedule data synced from Humanity to Oracle HCM include:

  • Shifts Start Time
  • Shift End Time
  • Shift Employee (employee for whom the shift was created)

Integration recognizes and syncs data from Humanity to Oracle HCM upon the following actions:

  • A shift for an employee is created and published in Humanity
  • A shift for an employee is updated/edited and published in Humanity
  • A published shift for an employee is deleted / employee is removed from the shift in Humanity

Important Notes

  • If the setting Use the Draft/Publish Schedule Method is OFF, all created shifts will be synced to Oracle HCM.
  • If the setting Use the Draft/Publish Schedule Method is ON, only the published shifts will be synced to Oracle HCM.
  • To see their synced schedule in Oracle HCM, employees have to navigate to Me > Time & Absences > Calendar.
  • To see their team synced schedule in Oracle HCM, employees have to navigate to Me > Time & Absences > Team Schedule.
  • To see their subordinates’ synced schedule in Oracle HCM, managers have to navigate to My Client Groups > Time Management > Planned Work Schedule.

Integration Requirements

To activate Humanity’s integration with Oracle HCM and enable data synchronization, a certain set of requirements related to Humanity and Oracle HCM must be fulfilled.

Humanity Application Requirements

The integration user must have an active Humanity account with administrator access.

The Group Accounts Platform (GAP) module must be activated. Please contact your Humanity representative for details.

The preconditions for Absence sync activation are:

  • Activated Employee sync;
  • The Leave settings (Settings > Leave and Availability) must be set to the values shown in the following screenshot:
  • The Deduct weekends from leave requests option under Advanced settings for the Leave module (Settings > Leave and availability) has to be set in a way that none of the days are selected. See the screenshot below:

The precondition for Schedule sync activation is activated Employee sync.


Oracle HCM Application Requirements

The following configuration is required in Oracle:

  • Humanity Integration User needs to be created;
  • Specific role/permission access granted to Humanity Integration User in order to fetch data from / send data to Oracle HCM.

Integration Setup Instructions - Integration Activation (Authentication)

Step 1: Integration activation steps are as follows:

  • Log in to your Humanity account and click on the Settings gear in the upper right corner.
  • Go to the Integrations module listed under the Integration section on the left side panel.
  • Choose Oracle integration from the Integrations main page.

Step 2: On the next page, click on the Activate button.

Step 3: A sidebar will appear and you will be asked to fill in the following company information, followed by a prompt to click on the Authorize button:

  1. Company Subdomain (customer's defined company subdomain on Oracle HCM account)
  2. Domain (customer's used Oracle HCM domain)
  3. Oracle HCM Username
  4. Oracle HCM Password

Step 4: Authentication between the two apps will be completed and the integration will be activated.

Important Notes

  • If the Integrations module is not listed, please contact Humanity’s Support team (support@humanity.com).
  • Any changes made to the login credentials or permissions/role setup of the Oracle Integration User will result in integration deactivation.

Employee Sync Activation

In order to enable the Employee sync, the requirements from the “Integration Requirements” section must be fulfilled.

Employee sync activation steps:

  • In the Oracle HCM Cloud integration page, go to the Sync Details section, find Oracle > Humanity Employee Sync, and expand the Show More dropdown.

  • Use the toggle to enable Sync Oracle HCM Cloud Jobs to Humanity Positions.
  • Use the toggle to enable Sync Oracle HCM Cloud Salaries to Humanity Base Rates on Position.
  • Use the toggle to enable Sync Oracle HCM Cloud Departments to Humanity Locations.
  • Click Start Sync.
  • The Employee sync is now activated and the initial Employee data sync will begin immediately.

Important Note: The initial Employee sync may take more than an hour. No changes can be made to the integration configuration while the sync is running.


Absence Sync Activation

In order to enable the Absence sync, the requirements from the “Integration Requirements” section must be fulfilled.

Absence sync activation steps:

Step 1: Click on Start Sync for Absence Sync located in the Oracle integration page Sync Details section.

Step 2: The Absence sync is activated and the initial Absence data sync will begin once the next scheduled Employee sync has been completed.

Important Notes

  • If the Employee sync is deactivated, Absence sync will be automatically deactivated as well.
  • Absence requests synced from Oracle must not be submitted/approved in Humanity.
  • Upon Absence sync activation, the following Humanity settings will be automatically set and must not be changed in order for the Absence sync to work properly: The settings under the Current Leave Types section ( Settings > Leave and Availability) will be set to the values shown in the following screenshot. These settings apply only to Time Off types synced from Oracle Time & Attendance to Humanity.


Schedule Sync Activation

In order to enable the Schedule sync, the requirements from the “Integration Requirements” section must be fulfilled.

Schedule sync activation steps:

Step 1: Click the Start Sync for Schedule sync located in the Oracle integration page Sync Details section.

Step 2: The Schedule sync is activated and the initial Schedule data sync will begin once the next scheduled Employee sync has been completed.

If you have any further queries, please don't hesitate to reach out to us at support@humanity.com.

Did this answer your question?