Designing an Integration with the Adapter Configuration Wizard

This section describes the design time and runtime aspects of using the Oracle HCM Cloud adapter.

You use the Adapter Configuration Wizard to include the Oracle HCM Cloud adapter in a SOA composite application or an Oracle Service Bus business service. The wizard consists of configuration pages that create the artifacts required to communicate with the Oracle HCM Cloud application. You can configure the adapter in the inbound (source) direction or the outbound (target) direction.

  • Inbound (source) direction:

    The Basic Info page prompts you to enter a meaningful name and optional description.

    The Connection page prompts you to specify the WSDL, security policy, and authentication key to use. The authentication key is created by clicking the Add icon to specify the key name, user name, and password. You must also specify these same values in Oracle Enterprise Manager Fusion Middleware Control. You can also test the connection to the Oracle HCM Cloud application on the Connection page. This enables you to confirm that the URL to the service catalog service and credentials are correct. Status is displayed that indicates whether the connection is successful and whether the credentials are authenticated by the Oracle HCM Cloud application. Any errors that occurred during the attempt to connect are also displayed.

    The Request page prompts you to select the business object to receive as a request from the Oracle HCM Cloud Application.

    To get all available data objects in the Oracle Sales Cloud instance, the adapter first reads the schema document (.XSD) that is referenced in the service’s WSDL. The adapter then parses this XSD to obtain the list of all schema imports and shows them as data objects.

    For example, the adapter displays the opportunity business object and its useful metadata first by reading the opportunity service’s WSDL and the referenced schema OpportunityService.xsd file. The XSD in turns imports another schema Opportunity.xsd in which the opportunity business object is defined. The metadata for the opportunity business object is defined in this schema.

    A search facility is provided that enables you to filter the display of business objects for quick selection. When you enter a search string, the list renders only the matching business objects in the list browser instead of showing all objects.

    The Response page prompts you to select the business object for the integration to send as a response document to the Oracle HCM Cloud application. To send no response, deselect the Send checkbox. You can also optionally select to send an immediate response back to the Oracle Sales Cloud application. An immediate response indicates a conversational response. For an immediate response, you can select any of the data objects as a response document. You also can select to send fault details with the immediate response.

    The Summary page displays your selections.

  • Outbound (source) direction:

    The Basic Info page prompts you to enter a meaningful name and optional description. This is the same page as is displayed for the inbound direction.

    The Operations page prompts you to select a business object or service and the operation to perform on your selection.

    A search facility based on service names is also provided. To quickly select a business service, you type a search string. The list renders only matching business services in the list browser instead of showing all services.

    The Summary page displays your selections for the outbound direction.

The following artifacts are created for each adapter instance in the Applications window in Oracle JDeveloper:

  • WSDL file: Only the standard WSDL file type is supported.

  • JCA file: Contains the internal implementation details used by the adapter during runtime. It contains the different interaction and connection properties used by the adapter.

When application configuration is complete, you can deploy the application from Oracle JDeveloper to the runtime environment.

Note:

The wizard does not support the creation of response message callbacks. As an alternative, you can design your BPEL process to include activities that support callbacks.

For information about the details to specify in the fields of the wizard pages, see Configuring Oracle HCM Cloud Properties.