Oracle E-Business Suite Integrated SOA Gateway Overview

Oracle E-Business Suite Integrated SOA Gateway Overview

Building on top of Oracle Fusion Middleware and service-oriented architecture (SOA) technology, Oracle E-Business Suite Integrated SOA Gateway (ISG) is a complete set of service infrastructure to provide, consume, and administer Oracle E-Business Suite Web services.

With service enablement feature, integration interfaces published in the Oracle Integration Repository can be transformed into SOAP and REST based Web services.

By leveraging Oracle SOA Suite running on Oracle WebLogic Server, Oracle E-Business Suite Integrated SOA Gateway provides greater capabilities and infrastructure for exposing various integration interfaces within Oracle E-Business Suite as SOAP Web services. SOAP-based services are described in WSDLs and are deployed to Oracle SOA Suite for service consumption.

Unlike SOAP services, REST services, without the dependency on Oracle SOA Suite, are developed with the infrastructure of Oracle E-Business Suite. REST services described in WADLs are directly deployed to an Oracle E-Business Suite WebLogic environment. They can be used for user-driven applications such as Oracle E-Business Suite mobile applications.

Oracle E-Business Suite Integrated SOA Gateway provides Service Invocation Framework to invoke and consume Web services provided by other applications.

Major Features

Oracle E-Business Suite Integrated SOA Gateway can do the following:

Major Components Features and Definitions

Oracle E-Business Suite Integrated SOA Gateway provides two major service offerings:

Providing and Consuming Web Services

the picture is described in the document text

To better understand Oracle E-Business Suite Integrated SOA Gateway, the next sections explain essential components and how each component is used.

Enabling Oracle E-Business Suite Web Services

Service enablement is the key feature within Oracle E-Business Suite Integrated SOA Gateway. It provides a mechanism that allows native packaged integration interface definitions resided in Oracle Integration Repository to be transformed into Web services. SOAP services are deployed from the Integration Repository to Oracle SOA Suite allowing more consumptions over the Web. REST services are deployed to Oracle E-Business Suite.

The basic concept of Web service components is illustrated in the following diagram:

the picture is described in the document text

Oracle Integration Repository and Service Enablement

Oracle Integration Repository, an integral part of Oracle E-Business Suite, is the centralized repository that contains numerous interface endpoints exposed by applications within the Oracle E-Business Suite. It supports the following interface types:

Oracle E-Business Suite Integrated SOA Gateway leverages Oracle Integration Repository to provide the capabilities of Web service generation and deployment, as well as service life cycle management.

Note: Please note that not all the interface types resided in the Integration Repository can be service enabled. The supported interface types for service enablement are XML Gateway, PL/SQL, Concurrent Program, Business Service Object, Application Module Services, Java Bean Services, Open Interface Tables, and Open Interface Views.

As mentioned earlier, security services are pregenerated REST services from Oracle Application Object Library. Therefore, there is no need to enable the security services from the repository as required by other supported interface types.

Web Service Security

To protect application data from unauthorized access, Oracle E-Business Suite integrated SOA Gateway enforces the security rules through subject authentication and authorization:

Additionally, input message header (such as SOAHeader and RESTHeader) is used to pass application contexts needed in invoking Oracle E-Business Suite services as part of the subject authorization.

Service Monitor

Service Monitor known as SOA Monitor in earlier releases is a centralized, light-weight service execution monitoring and management tool.

It fetches data and statistics for each instance of a Web service request and response from the underlying Oracle SOA Suite infrastructure to let you monitor Oracle E-Business Suite Web services. You can use the Service Monitor user interface in Oracle E-Business Suite to view the runtime request and response data received and sent from Oracle SOA Suite.

Please note that only SOAP services are monitored and audited through Service Monitor. Runtime REST service monitoring and auditing features are not supported in this release.

Service Invocation Framework

Service Invocation Framework (SIF) leverages Oracle Workflow Java Business Event System (JBES) and a seeded Java rule function to invoke services within Oracle E-Business Suite.

It provides an infrastructure allowing developers to interact with Web services through WSDL descriptions. For detailed implementation information, see Implementing Service Invocation Framework.

Native Service Enablement Architecture Overview

Oracle E-Business Suite Integrated SOA Gateway employs essential components that enable service integration at design time and run time, and ease the service management throughout the entire service deployment life cycle.

Service Provider is the primary engine enabling the Oracle E-Business Suite services. It is the engine that performs the actual service generation and deployment behind the scene for both SOAP and REST services.

The high level service enablement diagram can be illustrated in the following diagram:

the picture is described in the document text

SOAP Service Enablement Architecture and Design Time

SOAP services, once successfully generated, are deployed to an Oracle SOA Suite WebLogic environment. The seamless integration between Oracle E-Business Suite and Oracle SOA Suite forms the Oracle E-Business Suite Integrated SOA Gateway architecture.

the picture is described in the document text

At design time, an integration developer or integration administrator can select a desired interface and perform the service generation from the repository.

Once the service artifact has been generated, an integration administrator can deploy the service from Oracle Integration Repository to an Oracle SOA Suite WebLogic environment where the soa-infra application is running.

Note: Users with different roles can perform various tasks in Oracle E-Business Suite Integrated SOA Gateway. Each user role representing a unique permission or permission set can be granted to appropriate users. For example, an integration administrator defined by the Integration Administrator role can perform design-time operations, and other administrative tasks. For information on user roles and how to grant roles to users, see Assigning User Roles and Role-Based Access Control (RBAC) Security for Oracle E-Business Suite Integrated SOA Gateway.

REST Service Design Time

Without the dependency on Oracle SOA Suite, REST services are developed based on Oracle E-Business Suite technology infrastructure.

At design time, an integration administrator can select desired methods to be exposed as REST service operations before deploying them to Oracle E-Business Suite.

Additionally, the administrator can undeploy the service if needed.

Service Enablement Run Time

Oracle E-Business Suite services can be exposed as Web services and are interacted with Web service clients at run time.

When service consumers or Web service clients send request messages at run time, before invoking deployed services in the managed servers, all service-related security and policies are enforced.

After authenticating the requests, Oracle E-Business Suite Web services can be invoked. service response messages will be sent back to Web service clients if needed.

For each service operation, SOAP request and response messages passed through Oracle SOA Suite will be captured in Service Monitor where all Oracle E-Business Suite Web service activities executed at run time can be monitored.

Note: REST service monitoring and auditing features are not supported in this release.

For more information on how to monitor SOAP messages in Service Monitor, see Monitoring and Managing SOAP Messages Using Service Monitor.

Web Service Clients

Customers or third parties can use the following standard Web service client technologies or tools to invoke Oracle E-Business Suite Web services: