Oracle E-Business Suite Integrated SOA Gateway can be set up either on an existing installation of Oracle WebLogic Server or on a newly installed Oracle WebLogic Server. Before the installation, you must first understand the product dependencies.
Product Dependencies
Oracle E-Business Suite Integrated SOA Gateway depends on the following products to provide its functionality for SOAP-based web services:
Important: REST-based web services are developed with the infrastructure of Oracle E-Business Suite and they do not depend on Oracle SOA Suite and Oracle Applications Adapter.
Oracle SOA Suite running on Oracle WebLogic Server
In this release, Oracle E-Business Suite Integrated SOA Gateway leverages the features of Oracle SOA Suite to expose public interfaces in Oracle E-Business Suite as web services.
Service Provider, one of the essential components in Oracle E-Business Suite Integrated SOA Gateway, uses Oracle SOA Suite for provisioning SOAP requests for Oracle E-Business Suite web services. It generates the SOA Composites which are deployed on Oracle SOA Suite server.
Oracle E-Business Suite Adapter (formerly known as Oracle Applications Adapter)
Oracle E-Business Suite Adapter provided from Oracle SOA Suite is part of the Oracle Fusion Middleware components. Oracle E-Business Suite Integrated SOA Gateway leverages its features for PL/SQL, Concurrent Program, and XML Gateway based Oracle E-Business Suite web services. The invocation of the web service is handled by Oracle SOA Suite after the parameters in the inbound SOAP headers are validated by Oracle E-Business Suite Adapter.
For information on how to install Oracle SOA Suite 12c, see Oracle Fusion Middleware Installing and Configuring Oracle SOA Suite and Business Process Management.
For information on how to install Oracle SOA Suite 11g, see Oracle Fusion Middleware Installation Guide for Oracle SOA Suite and Oracle Business Process Management Suite.
For information on how to configure, troubleshoot, or upgrade Oracle E-Business Suite Integrated SOA Gateway from earlier releases, refer to the following documents:
For information on how to install or upgrade Oracle E-Business Suite Integrated SOA Gateway from earlier releases, and how to perform setup tasks for both SOAP and REST services, see Installing Oracle E-Business Suite Integrated SOA Gateway, Release 12.2, My Oracle Support Knowledge Document 1311068.1.
For troubleshooting information on potential problem symptoms and corresponding solutions for Oracle E-Business Suite Integrated SOA Gateway, see Oracle E-Business Suite Integrated SOA Gateway Troubleshooting Guide, Release 12.2, My Oracle Support Knowledge Document 1317697.1 for details.
After configuring Oracle E-Business Suite Integrated SOA Gateway, administrators should set the required profile options and assign appropriate roles to users which allow them to perform design-time operations, monitor the web services and view logs. The next sections on assigning roles and setting profile options explain these features.
Oracle E-Business Suite Integrated SOA Gateway uses the following user roles to perform needed administrative and user tasks. Each user role is associated with a specific responsibility by default to access the Integration Repository. A system administrator can assign these user roles to appropriate users if necessary.
Integration Analyst role (UMX|FND_SYSTEM_INTEGRATION_ANALYST) - Integration Repository responsibility
Integration Developer role (UMX|FND_SYSTEM_INTEGRATION_DEVELOPER) - Integrated SOA Gateway responsibility
Integration Administrator role (UMX|FND_IREP_ADMIN) - Integrated SOA Gateway responsibility
Please note that the Integration Administrator role is assigned to the user (SYSADMIN) by default.
For example, users who have the Integration Analyst role can access the Integration Repository through the Integration Repository responsibility. They can browse integration interfaces and services as well as view each interface details through the Integration Repository user interface.
Users who have the Integration Developer role can access the Integration Repository through the Integrated SOA Gateway responsibility. They can view each interface through the repository, and also annotate custom integration interfaces based on annotation standards.
Users who have the Integration Administrator role can perform all user and administrative tasks in the Integration Repository through the Integrated SOA Gateway responsibility. These tasks include browsing and viewing each integration interface and service, generating, deploying, and undeploying services, as well as retiring active services, activating retired services, and resetting services.
To assign a user role:
Log in to Oracle E-Business Suite as a user who has the User Management responsibility.
Select the Users link from the navigation menu.
Enter appropriate information in the search area to locate a desired user account. Click Go.
Click the Update icon next to the user with 'Active' account status to open the Update User window.
Click Assign Roles.
In the search window, search for either one of the following user roles:
Integration Analyst
Integration Developer
Integration Administrator
Choose a desired role and click Select.
Enter a justification in the Justification filed and click Apply.
You will see a confirmation message indicating you have successfully assigned the role.
For more information on assigning or revoking user roles, see the Oracle E-Business Suite Security Guide.
The following table lists the profile options used in Oracle E-Business Suite Integrated SOA Gateway:
| Profile Option | Description | Required | Default Value |
|---|---|---|---|
| FND: XML Gateway Map Generic Service | Use this profile option to display or hide the generic XML Gateway service information for the selected XML Gateway map.
|
Yes | Yes
Important: If you do not start from this release and you have been using generic XML Gateway web service, set the profile option to 'Yes'. This allows the Generic XML Gateway Services subregion to be displayed within the Web Service region. Otherwise, subregion will not be shown and any invocations of generic XML Gateway web services will return a fault message. |
| ISG: Generic Service WSDL URL for XMLG | Once a generic XML Gateway web service has been deployed, the deployed service WSDL URL is populated as the profile value and the URL is also displayed in the 'Generic XML Gateway Service' subregion. If the generic service is not deployed, the profile value will not be shown and hence no WSDL URL is displayed in the subregion for the selected XML Gateway interface. |
Yes | N/A |
Use the FND: XML Gateway Map Generic Service profile option to display generic XML Gateway service information contained in the subregion only if your system is upgraded from a previous release and you have been using generic XML Gateway web services.
For information on setting profile options, see User Profiles and Profile Options in Oracle Application Object Library, Oracle E-Business Suite Setup Guide.