Oracle HCM Cloud Adapter Capabilities

The Oracle HCM Cloud Adapter enables you to create an integration with Oracle Human Capital Management (HCM) Cloud applications. You select business objects that an integration receives from Oracle HCM Cloud as a request and as a response.

Note:

Only use supported SOAP services. See Business Object Services of Cloud SOAP Web Services for Oracle HCM Cloud.

The Oracle HCM Cloud Adapter enables customers to easily integrate their on-premises or SaaS applications with Oracle HCM Cloud without having to know about the specific details involved in the integration.

The Oracle HCM Cloud Adapter provides the following benefits:

  • Integrates easily with the Oracle HCM Cloud application’s WSDL file to produce a simplified, integration-centric WSDL.

  • Generates automatic mapping to the exposed business object that you select during adapter configuration as a trigger connection. A business object represents a self-contained business document that can be acted upon by the integration. An integration can send requests to create a new record for that business object. They can send a request either to update or delete an existing record for a business object. Integrations can also send requests to retrieve information about one or more records representing that business object.

  • Exposes the Business Resource (REST) API, which represents an Oracle Fusion Applications REST API resource. You can select parent business resources and their corresponding child business resources. Support is provided in the invoke (outbound) direction.

  • Supports consumption of the Oracle HCM Cloud REST API. This enables the Oracle HCM Cloud Adapter to consume REST services under Oracle HCM Cloud when configured as an invoke connection. See All REST Endpoints of REST API for Oracle HCM Cloud for details about supported REST resources.

  • Automatically handles security policy details required to connect to the Oracle HCM Cloud application.

  • Provides standard error handling capabilities.

  • Enables you to map business objects that have polymorphic data structures.

  • Dynamically invokes a REST endpoint/URL at runtime without requiring you to configure any extra invoke connection or REST outbound details. See Invoke an Endpoint Dynamically.

  • Supports subscribing to the HCM Atom feed. Atom feeds enable you to track changes made to feed-enabled resources in Oracle Global Human Resources Cloud. For any updates of interest to downstream applications such as new hires, terminations, employee transfers, and promotions, Oracle Global Human Resources Cloud publishes Atom feeds. The Oracle HCM Cloud Adapter’s Atom feed subscription feature enables you to select a feed of interest. This feature must be used in a scheduled manner because there is a need to poll for updates at regular intervals. This is done by selecting a scheduled orchestration template when creating the integration.

    This feature is supported when using the Oracle HCM Cloud Adapter as an invoke connection in an integration.

    Prior to HCM release 18c, future-dated Atom entries appeared in their respective Atom feed immediately once the future-dated action was taken.

    Starting with HCM release 18c, there is a change in the way future-dated updates are returned by the HCM service. Atom feed entries appear by default once the future-dated actions become effective. You can select to process these future-dated Atom entries immediately on the Operations page of the Adapter Endpoint Configuration Wizard. The default behavior is to process future-dated Atom updates in the future.

    See Polling of REST API for Oracle HCM Cloud.

    See Atom Feeds of Cloud REST API for Oracle Global Human Resources Cloud.

  • Enables you to upload files to Oracle WebCenter Content (Universal Content Manager) in encrypted or unencrypted format. Oracle WebCenter Content provides a unified repository to store unstructured content, enabling organizations to deliver the content to business users in the proper format. See Upload a File to Oracle WebCenter Content.

    Note:

    Downloading files from Oracle WebCenter Content is not supported.
  • Supports HCM data extracts, a flexible tool for generating data files and reports. The Oracle HCM Cloud Adapter works as an extract discovering tool under Oracle HCM Cloud. The data extract process is automated as per the following steps:
    • Invoking the given HCM data extract by the client outside the Oracle HCM Cloud Adapter.

    • Discovering the extract as delivered in Oracle WebCenter Content.

    • Fetching the extract output in its format as it is delivered to Oracle WebCenter Content and persisting the extract to Oracle Integration staging.

    • Defining the XML schema by the user for the extract output for transformation using a stage file action that is available in an orchestrated integration.

      Note:

      The user must understand how to download the schema and how to schedule and run HCM extracts from the Oracle HCM Cloud user interface. See Defining an Extract: Worked Example of Cloud Integrating with Oracle HCM Cloud.

    This feature is supported when using the Oracle HCM Cloud Adapter as an invoke connection in an integration.