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.

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.

  • Supports invoking of business objects using the HCM Data Loader, regardless of how they were created. The HCM Data Loader is a tool for bulk-loading and maintaining data. The data can be from any source. You use the HCM Data Loader for data migration, ongoing maintenance of Oracle HCM Cloud data, and coexistence scenarios where core HR data is uploaded regularly.

    See Introduction to HCM Data Loader and Overview of Automating Data Loading of HCM Data Loader.

  • 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 on the Operations page in the Adapter Endpoint Configuration Wizard. Support is provided in the invoke (outbound) direction. If you select a top-level resource on the Operations page, you can also select sub-resources on the Sub-Resources page. See Invoke Child Resources Page

  • Simplified connection creation: Automatically identifies the required service catalog service WSDL and optional interface catalog URL to use based on the Oracle HCM Cloud host name you specify when creating a new connection on the Connections page.
  • Supports consuming extensible flexfields (EFFs) and descriptive flexfields (DFFs) for REST resources. You can select specific EFFs and DFFs in the Adapter Endpoint Configuration Wizard of an Oracle HCM Cloud Adapter invoke connection. You can then map the EFFs and DFFs in the mapper. See Select Extensible and Descriptive Flexfields in an Integration.
  • 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.

  • Supports the following security policies for selection during Oracle HCM Cloud Adapter connection configuration:
    • Username Password Token With PGP Key Support
    • Username Password Token
    • OAuth Authorization Code Credentials
  • 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 Poll of REST API for Oracle HCM Cloud.

    See Atom Feeds of REST API for Oracle HCM 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 Define Extracts of HCM Extracts.

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

  • Supports a set of SOAP services. For the supported list, see Business Object Services of SOAP Web Services for HCM. The following integration behavior occurs:
    • For new integrations, only the supported SOAP services are displayed for selection when configuring the Oracle HCM Cloud Adapter in the Adapter Endpoint Configuration Wizard. Unsupported SOAP services are not displayed.
    • For existing integrations, you can edit, view, and activate old integration as before. If you add a new adapter endpoint to an existing integration, only supported SOAP services are available for selection in the Adapter Endpoint Configuration Wizard.