Administering Composite Services - BPEL

Overview

A composite service is a set of specifications that define a way of assembling SOA-based application. It may consist of one or more services to describe a complex business process requirement. For example, a composite service - BPEL type can be used for service orchestration to manage more complex business processes (such as Order-to-Receipt) which may be handled by various applications.

A composite service - BPEL type contains its own WSDL definition and service endpoints allowing external Web service clients to invoke the services at run time.

Please note that in Oracle SOA Suite 11g and Oracle SOA Suite 12c, BPEL process is managed and deployed together with the associated SOA composite application. In Oracle SOA Suite 10g, it is developed and deployed as a separate component. Integration Repository displays 'Composite Services - BPEL' of Oracle SOA Suite 10g as catalogue in this release.

This chapter includes the following topics:

Understanding the Enablement Process for Composite Services - BPEL

To design a composite service, an integration developer uses BPEL process component in Oracle JDeveloper 10g (Service Designer) to assemble a series of service components together for a business function. The newly created composite service - BPEL definition needs to be annotated first based on the Integration Repository annotation standards. Users who have the Integration Administrator role need to validate the annotated files using a standalone design time tool called Integration Repository Parser. An Integration Repository loader (iLDT) file is generated after the validation and then uploaded to the Integration Repository using the FNDLOAD command. The composite service - BPEL type can be displayed and searched from the Integration Repository user interface.

The following diagram illustrates the high level enablement process:

Enablement Process for Composite Services - BPEL

the picture is described in the document text

Users granted the download composite service privilege through Integration Repository Download Composite Service Permission Set (FND_REP_DOWNLOAD_PERM_SET) can download the composite - BPEL file to their local directories. An integration developer can open the downloaded BPEL file using Oracle JDeveloper 10g and modify it if necessary before deploying it to a BPEL server in Oracle SOA Suite 10g for service consumption.

Note: Composite services - BPEL type is supported in Oracle SOA Suite 10g. For example, a composite - BPEL type can be deployed through Oracle JDeveloper to a BPEL server in Oracle SOA Suite 10g BPEL Process Manager or a third party BPEL PM in a J2EE environment.

For detailed information on how to upload composite - BPEL definitions to the Integration Repository, see Enabling Custom Integration Interface Process Flow.

For information on Integration Repository annotation standards, see Composite Service - BPEL Annotations, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

Administering Composite Services - BPEL

Oracle E-Business Suite Integrated SOA Gateway allows you to perform the following tasks on composite services:

Viewing Composite Services - BPEL

Once annotated custom composite - BPEL definitions are uploaded to the Integration Repository, 'Composite - BPEL' option can be listed when searching by Interface Type and visible to all users.

Integration administrators can view composite details for a selected composite service including service name, description, BPEL file, WSDL file, and other annotated information.

To locate a composite service - BPEL, navigate to the Composite Service interface type from the Oracle Integration Repository browser window with View By 'Interface Type' or perform a search by selecting Composite service (such as 'Composite - BPEL') interface type in the Search page. Click your desired composite service name link from the browser tree or the search result to display the composite service - BPEL interface details page where you can:

For information on Integration Repository annotation standards, see Composite Service - BPEL Annotations, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

For detailed information on how to upload composite - BPEL definitions to the Integration Repository, see Enabling Custom Integration Interface Process Flow.

Downloading Composite Services - BPEL

In addition to viewing composite service - BPEL details, a WSDL file, and BPEL file, users who have the Integration Administrator role can download a BPEL .JAR file containing relevant composite service files to their local machines by clicking Download Service in the composite service - BPEL details page.

Important: In general, only users with the Integration Developer role and the Integration Administrator role can download the composite services - BPEL. However, users who are granted the download composite service privilege through Integration Repository Download Composite Service Permission Set (FND_REP_DOWNLOAD_PERM_SET) can also perform the download action. Otherwise, Download Service may not appear in the details page by default.

For more information about how to grant the download composite service privilege, see Role-Based Access Control (RBAC) Security.

To download a composite service - BPEL:

  1. Log in to Oracle E-Business Suite as a user who has the Integration Administrator role. Select the Integrated SOA Gateway responsibility and the Integration Repository link.

  2. In the Integration Repository tab, select 'Interface Type' from the View By drop-down list.

  3. Expand the Composite - BPEL interface type node to locate your desired composite service.

  4. Click the composite service - BPEL that you want to download it to open the Composite Service- BPEL interface details page.

  5. Click Download Service to download the selected composite - BPEL file to your local directory.