Skip Headers
Oracle® Application Server Adapter for Tuxedo User's Guide
10g Release 2 (10.1.2)
B15802-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

4 Integrating OracleAS Adapter for Tuxedo with Oracle BPEL Process Manager

OracleAS Adapter for Tuxedo enables connectivity with Oracle BPEL Process Manager through the standard Web Services Description Language (WSDL) partner link mechanism.

Oracle BPEL PM enables users to capture Tuxedo native interactions as WSDL-based services. These services can be used from within the business process through an Invoke or Receive activity, which is associated with a partner link.

This chapter includes the following sections:

Integrating OracleAS Adapter for Tuxedo with Oracle BPEL Process Manager

Oracle BPEL Process Manager provides a comprehensive and easy-to-use solution for creating, deploying, and managing BPEL business processes. Oracle BPEL Process Manager is based on the Service Oriented Architecture (SOA) to provide enterprises with flexibility, interoperability, reusability, extensibility and rapid implementation of Web services and business processes. Oracle BPEL Process Manager reduces the overall cost of management, modification, extension, and redeployment of existing business processes. Each business activity is a self-contained, self-describing, modular application whose interface is defined by the WSDL, and the business process is modeled as a Web Service.

A Web Service is first published and then composed or orchestrated into business flows. Publishing a service is implemented by taking a function within an existing application or system and making it available in a standard way, while orchestration is implemented by composing multiple services into an end-to-end business process. The interactions defined as part of the configuration of OracleAS Adapter for Tuxedo are integrated into the orchestration as partner links.

Using OracleAS Adapter for Tuxedo as Outbound Link

OracleAS Adapter for Tuxedo can be integrated with an Oracle BPEL Process Manager project to provide connectivity to a Tuxedo server through Oracle Connect.

To use OracleAS Adapter for Tuxedo as an outbound link, perform the following steps:

  1. Open the relevant Oracle BPEL Process Manager project in the BPEL Designer.

  2. Select Partner Link from the component palette and drag the link to the Partner Links area in the project orchestration. The Create Partner Link screen is displayed.

  3. Click WSIL Browser. The WSDL Chooser screen opens, displaying a list of the available connections.

  4. Expand the node of the required connection, and select Adapters.

  5. Expand the Adapters node and select Legacy.

  6. Expand the Legacy node. The available servers are listed.

  7. Expand the node of the required server. The available daemons for the selected server are listed.

  8. Expand the node of the required daemon. The available workspaces for the selected daemon are listed.

  9. Expand the node of the required workspace. The available adapters for the selected workspace are listed.

  10. Expand the node of the required adapter and select the relevant interaction from the list, as shown in the following figure:

    Selecting an adapter interaction from the WSIL Explorer
    Description of the illustration Tux.gif

  11. Click OK.

  12. Specify the value from the list for the Partner Role field, as shown in the following figure:

    The Parner Role field value specified
    Description of the illustration partlink_out.gif

  13. Click OK to add the interaction to the orchestration as a partner link.

The interaction is now included in the orchestration.

Using OracleAS Adapter for Tuxedo as an Inbound Link

OracleAS Adapter for Tuxedo can be integrated with an Oracle BPEL Process Manager project to provide connectivity from a Tuxedo Server to Oracle BPEL through Oracle Connect.

To use OracleAS Adapter for Tuxedo as an inbound link, perform the following steps:

  1. Open the relevant Oracle BPEL Process Manager project in the BPEL Designer.

  2. Select Partner Link from the component palette and drag the link to the Partner Links area in the project orchestration. The Create Partner Link screen is displayed.

  3. Click WSIL Browser. The WSDL Chooser screen opens, displaying a list of the available connections.

  4. Expand the node of the required connection, and select Adapters.

  5. Expand the Adapters node and select Legacy.

  6. Expand the Legacy node. The available servers are listed.

  7. Expand the node of the required server. The available daemons for the selected server are listed.

  8. Expand the node of the required daemon. The available workspaces for the selected daemon are listed.

  9. Expand the node of the required workspace. The available adapters for the selected workspace are listed.

  10. Expand the node of the required adapter and select the relevant interaction from the list, as shown in the following figure:

    Selecting an adapter interaction from the WSIL Explorer
    Description of the illustration Tux.gif

  11. Click OK.

  12. Select the required value from the list for the My Role field, as shown in the following figure:

    The My Role field value specified
    Description of the illustration partlink_in.gif

  13. Click OK to add the interaction to the orchestration as a partner link.

The interaction is now included in the orchestration.

Updating Outbound and Inbound Interactions

The Oracle BPEL Process Manager samples the adapter metadata, including the schemas, interactions, and their definitions from the repository, in real-time.

When you are modifying an adapter or its interaction definitions using Oracle Studio, you are required to refresh the server process in order for the changes to take effect, as described in "Modeling Interactions for Oracle Application Server Adapter for Tuxedo".

The changes made will be saved to the repository only when the server process is refreshed in Oracle Studio.

If you delete an existing interaction, the Oracle BPEL Process Manager prompts with an error message, stating that the required interaction could not be invoked because it is not available. In this situation, you need to redeploy the business process in the Oracle BPEL Process Manager.