A composite service is a coarse-grained abstracted service. It uses native services as building blocks to orchestrate the business invocation sequence into a meaningful end-to-end business flow through a web service composition language BPEL.
At design time, integration developers use BPEL process component in Oracle JDeveloper 10g to assemble a series of service components together for a business function, and then they annotate the composite service - BPEL definition based on the Integration Repository annotation standards. After validation, the newly-created composite service - BPEL can be uploaded to Integration Repository where it can be displayed and available to all users.
The integration developer can view each composite service - BPEL details by selecting a desired service from the Oracle Integration Repository browser, downloading the selected composite service - BPEL to a local directory, modifying the BPEL process in Oracle JDeveloper 10g if it's necessary, and deploying it to a BPEL server in Oracle SOA Suite 10g BPEL Process Manager or a third party BPEL PM in a J2EE environment.
This chapter explains how to view, download, and modify composite services - BPEL. Detailed design-time tasks on how to create a SOA composite service with BPEL process are included in each individual interface described earlier in this book.
For information on how to annotate composite - BPEL definitions, see Composite Service - BPEL Annotations.
For information on how to upload composite - BPEL definitions to the Integration Repository, see Enabling Custom Integration Interface Process Flow, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.
Once annotated custom composite - BPEL definitions are uploaded to the Integration Repository, 'Composite - BPEL' option can be displayed from the repository and available to all users.
An integration developer can view a composite service - BPEL by navigating to the Composite - BPEL interface type directly from the Oracle Integration Repository Browser window with View By 'Interface Type'. Alternatively, the integration developer can perform a search to locate the composite service - BPEL in the Search page.
To view a composite service - BPEL details, click on a composite service name link from the navigation tree or search results. The composite service - BPEL interface details page is displayed with service name, description, BPEL file, WSDL file, and other annotated information.
The composite service - BPEL details page allows you to perform the following tasks in the BPEL Files region:
View an abstract WSDL file by clicking the View Abstract WSDL link
See: Reviewing Web Service WSDL Source, Oracle E-Business Suite Integrated SOA Gateway User's Guide.
View the composite - BPEL file by clicking the View BPEL File link
The BPEL code is displayed in a pop-up window containing major BPEL process components and activities included for the selected composite service.
For information on how to annotate composite - BPEL definitions, see Composite Service - BPEL Annotations.
For information on how to upload composite - BPEL definitions to the Integration Repository, see Enabling Custom Integration Interface Process Flow, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.
You can download a corresponding composite service BPEL project file to your local machine. See: Downloading Composite Services - BPEL.
In addition to viewing composite service - BPEL details and reviewing a WSDL abstract, an integration developer can download the composite service relevant files aggregated in a .JAR file to a local directory.
Important: In general, only integration developers and integration administrators can download the composite services - BPEL. However, users who are granted the download 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 on how to grant download composite service privilege, see Role-Based Access Control (RBAC) Security, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.
To download the .ZIP file for a composite service - BPEL, navigate to the composite service - BPEL details page for a service that you want to download, and then click Download Service to download the file to your local directory.
After the download, you can unzip the BPEL .JAR file and open the BPEL process in Oracle JDeveloper 10g for modification on service endpoints if needed. For information on how to modify and deploy BPEL process, see Modifying and Deploying BPEL processes.
To download a composite service - BPEL:
Log in to Oracle E-Business Suite as a user who has the Integration Developer role. Select the Integrated SOA Gateway responsibility and choose the Integration Repository link from the navigation menu.
In the Integration Repository tab, select 'Interface Type' from the View By drop-down list.
Expand the Composite - BPEL interface type node to locate your desired composite service - BPEL.
Click the composite service - BPEL that you want to download to open the Composite Service - BPEL interface details page.
Click Download Service to download the selected composite BPEL file to your local directory.
After downloading a composite service BPEL project, an integration developer can modify the BPEL project if it's needed. This can be done by first unzipping the BPEL .JAR file and then opening the BPEL file in Oracle JDeveloper 10g to modify the BPEL process endpoints if it's needed. After the modification, the BPEL project can be deployed to a BPEL server in Oracle SOA Suite 10g.
Note: In Oracle SOA Suite 11g and Oracle SOA Suite 12c, BPEL process is managed and deployed together with the associated SOA composite application.
Composite service - BPEL type is supported in Oracle SOA Suite 10g. The BPEL process is deployed to a BPEL server in Oracle SOA Suite 10g or a third party BPEL PM in a J2EE environment.
The modification of a BPEL process uses the similar logic during the BPEL process creation. Refer to the design-time tasks for each interface type discussed earlier in this book. For information on how to test and validate the BPEL process within a composite application, refer to the runtime tasks of the interface type described in this book.
For BPEL process modification and deployment described in this section, Oracle JDeveloper 10g (10.1.3.3.0) is used as a design-time tool to modify the BPEL process, and Oracle SOA Suite BPEL server 10.1.3.3.0 is used for the process deployment.
To modify a BPEL process:
Open a BPEL file in Oracle JDeveloper 10g BPEL Designer.
From the File menu, select Open.
Locate your BPEL file from the directory that you want to modify. Click Open in the Open window.
The selected BPEL process diagram appears.
Modify the BPEL process endpoints if necessary.
Save your work.
To deploy a BPEL process:
In the Applications Navigator of Oracle JDeveloper 10g BPEL Designer, select the BPEL project that you want to deploy.
Right-click the project and select Deploy action from the menu. Click on Invoke Deployment Tool and enter your BPEL Process Manager information.
For example, you can select Deploy > BPELServerConn > Deploy to Default Domain to deploy the project if you have the BPEL Process Manager set up appropriately.
The Password Prompt dialog box appears. Enter the password for the default domain in the Domain Password field and click OK. The BPEL project is compiled and successfully deployed.