Creating an Oracle E-Business Suite Connection with Oracle E-Business Suite Adapter

Overview

This chapter includes the following topics:

Please note that you can modify, delete, or clone the connection if needed after creating or testing a connection. See Creating Connections, Developing Integration Cloud Services chapter, Oracle Cloud Using Oracle Integration Cloud Service.

Creating an Oracle E-Business Suite Connection with Oracle E-Business Suite Adapter

Prerequisites

Before establishing an Oracle E-Business Suite connection using the Oracle E-Business Suite Adapter in Oracle Integration Cloud Service, you must complete the required setup tasks and apply the latest patches for enabling the Oracle E-Business Suite REST services provided through Oracle E-Business Suite Integrated SOA Gateway.

For setup information, see Setting Up the Oracle E-Business Suite Adapter.

Creating an Oracle E-Business Suite Connection with the Oracle E-Business Suite Adapter

Once you have successfully logged in to Oracle Integration Cloud Service (http://<servername>:<portnumber>/ics) through a web browser, the home page appears.

  1. Click Connections.

  2. Click Create New Connection.

  3. In the Create Connection - Select Adapter dialog appears.

    You can locate the Oracle E-Business Suite Adapter in either of the following ways:

    • Scroll down and select "Oracle E-Business Suite" from the dialog.

      Selecting Oracle E-Business Suite in the Create Connection - Select Adapter Dialog

      the picture is described in the document text

    • Use the search feature to enter a full or partial name to locate "Oracle E-Business Suite" from the dialog.

      Searching Oracle E-Business Suite in the Create Connection - Select Adapter Dialog

      the picture is described in the document text

    Click the Select button for "Oracle E-Business Suite" to use the Oracle E-Business Suite Adapter. The New Connection - Information dialog appears.

  4. Enter the following information for your connection:

    Entering Connection Information in the New Connection - Information Dialog

    the picture is described in the document text

    Click Create to create the connection.

    • Connection Name: Specify a unique name for your connection, such as EBS_Connection.

    • Identifier: Enter a unique identifier for your Oracle E-Business Suite connection. You can also accept the default value, such as EBS_CONNNECTION.

    • Connection Role: Specify either one of the following roles for your connection:

      • Trigger: This indicates this connection can only be added as a trigger (source) in an integration.

      • Invoke: This indicates this connection can only be added as an invoke (target) in an integration.

      • Trigger and Invoke: This indicates this connection can be added as a trigger (source) or an invoke (target) in an integration.

    • Description: Enter description information for your connection, such as "Use the Oracle E-Business Suite Adapter connection in an integration".

  5. Enter additional connection details by specifying the following information:

    • Email Address: Enter an administrator's email address to receive notifications if problems or changes occur in this connection.

    • Connection Properties: Click Configure Security to open the Connection Properties dialog where you enter a URL (http://<ebs host name>:<port>) to connect to an Oracle E-Business Suite instance.

      Please note that this URL address is where the Oracle E-Business Suite services are deployed and can be publicly accessible either through DMZ configuration or the Oracle Integration Cloud Service agent framework. See the step about configuring the access to Oracle E-Business Suite services, as described in Setting Up the Oracle E-Business Suite Adapter.

      Entering Connection URL in the Connection Properties Dialog

      the picture is described in the document text

      Click OK to save your work.

    • Security: Click Configure Credentials to open the Credentials dialog. Specify security policy, username, and password information to access the Oracle E-Business Suite instance you specified earlier in the Connection Properties dialog.

      The username specified here should be granted the privileges to access and execute the Oracle E-Business Suite APIs and services. See the step about granting the required user privileges, as described in Setup Tasks for Enabling the Oracle E-Business Suite Adapter.

      Note: HTTP Basic Authentication is the only security policy supported in this release.

      Entering User Credentials in the Credentials Dialog

      the picture is described in the document text

      Click OK to save your work.

    • Agent Group: Click Configure Agents to display the Select an Agent group dialog. A list of available agent groups is automatically populated for your selection.

      Select a desired agent group, such as "EBS", and click Use to enable the selection.

      The selected agent group serves as a channel for communication between Oracle E-Business Suite and Oracle Integration Cloud Service.

      For information on setting up agent groups, refer to Creating an Agent Group, Managing Agent Groups and the On-Premises Agent section in the Developing Integration Cloud Services chapter, Oracle Cloud Using Oracle Integration Cloud Service.

    After you specify the required connection information, the "EBS_Connection" connection detail page appears.

  6. Click Save to save your connection.

Testing an Oracle E-Business Suite Connection

After creating an Oracle E-Business Suite connection with Oracle E-Business Suite Adapter, you can test the connection by clicking Test to test the availability of the Oracle E-Business Suite instance you entered earlier.

Once you have successfully tested and established the connection to the Oracle E-Business Suite instance, a list of serviceable APIs or interfaces (such as XML Gateway maps or business events) from Oracle E-Business Suite licensed products and product families will be imported from the connected instance to Oracle Integration Cloud Service.

For information about error messages if occur while testing the connection, see Error Messages for Testing the Oracle E-Business Suite Connection.