1. Oracle Global Human Resources Cloud REST APIREST API for Oracle Fusion Cloud HCM
  2. Use Cases
  3. Global Human Resources
  4. Notify Downstream Applications

Notify Downstream Applications

Oracle HCM Cloud is the system of record for HCM data. Therefore, downstream applications such as LDAP, ERP, Learning Management, Pension, Office Location, Travel Management, and Role Assignment applications need to be informed when the following updates occur in Oracle HCM Cloud:

  • Creation of new accounts for users when a new hire is processed in Oracle HCM Cloud. You can subscribe to the new hire Atom feed using this URL format:

    /hcmRestApi/atomservlet/employee/newhire

  • Removal of accounts for terminated users when an employee is terminated in Oracle HCM Cloud. You can subscribe to the terminations Atom feed using this URL format: 
    /hcmRestApi/atomservlet/employee/termination
  • Update of employee details. You can subscribe to the employee update Atom feed using this URL format: 
    /hcmCoreApi/atomservlet/employee/empupdate
  • Creation of new jobs, locations, organizations, and other workstructures. You can subscribe to workstructures Atom feeds using this URL format: 
    /hcmRestApi/atomservlet/workstructures/<workstructure>

The central application or LDAP on the customer's side is subscribed to updates that occur in Oracle HCM Cloud. Downstream applications such as LMS, pension, travel management applications, and so on are notified of updates that occur in Oracle HCM Cloud when they subscribe to Atom feeds. Feeds are generated for updates such as new hire accounts, employee transfers, promotions, and terminations, and workstructures updates such as creation of jobs, locations, organizations, and so on.

Orchestration Using SOA

To receive notifications about updates of interest to downstream systems:

  • The Service Oriented Architecture (SOA) orchestration layer subscribes to the appropriate work structures feed.

    Note:

    The orchestration layer always processes the work structures entries before the employee entries because of potential dependencies. For example, to find changes to locations, the orchestration layer polls the following URL:

    /hcmRestApi/atomservlet/workstructures/locations

  • The call can include a minimum (min) or maximum (max) time, which should match the polling interval, so that all entries since the last query are picked up. 
    • /hcmRestApi/atomservlet/workstructures/locations?updated-min=2014-11-10T18:53:22.000Z&updated-max=2014-11-10T18:53:22.000Z&page=1&page-size=5
    • /hcmRestApi/atomservlet/workstructures/locations?updated-min=2014-11-10T18:53:22.000Z

    Note:

    The updated-min clause is the last time polling occurred. The updated-max clause is optional and returns all entries updated before the specified date-time.

    • Use the ISO 8601 timestamp format. For example: 2014-11-10T18:53:22.000Z
    • The lower bound is inclusive, whereas the upper bound is exclusive.

Perform Position Updates

For updates related to position in Taleo Business Edition (or other third-party recruiting applications), the following conditions apply:

  • When the hiring status of a position is set to Approved, or the open headcount changes, a requisition must be created in TBE for each headcount.
  • If position details are updated in Oracle HCM Cloud, any related requisitions in TBE must be updated with the changes.
  • If a position is closed or deleted in Oracle HCM Cloud, any related requisition in TBE must be closed.
  • If a closed position in Oracle HCM Cloud is reopened, any related requisition in TBE must be reopened or a new requisition created.

You can subscribe to the position Atom feed using this URL format:

/hcmRestApi/atomservlet/workstructures/positions?updated-min=2014-11-10T18:53:22.000Z

Note:

2014-11-10T18:53:22.000Z is the exact ISO time when the entry was last invoked by your orchestration program.

A recruiting application on the customer's side, such as Taleo, is subscribed to position feeds from Oracle HCM Cloud. When position updates occur in Oracle HCM Cloud, the recruiting application is notified and job requisitions are created accordingly.