Partner Link

See Also

In the context of BPEL, partner links are references to external web services with which a BPEL process interacts. The Partner Link activity defines the role each partner plays in the exchange of conversational messages. Indirectly, by virtue of its reference to a partner link type, a Partner Link activity indicates which port types are implemented by each partner.

Partner Link Elements and Partner Link Type Definitions

The partner link type is a BPEL extension for WSDL. As such, it is defined in a WSDL file, not in a BPEL file. The partner link type creates an association between one or two arbitrary roles and indicates that each role must implement a single port type. By associating a port type with a role, the partner link type defines interaction rules between partners.

Do not confuse the Partner Link elements and partner link type definitions:

Partner link type definitions are prerequisites to a Partner Link element. A Partner Link element can only be defined by referring to a particular partner link type and role which must be defined in the WSDL file.

Ways to Add a Partner Link

You can add a Partner Link to a business process in one of the following ways:

Using a Partner Link element

To use the Partner Link element:

  1. In the Design view, add a Partner Link element to the diagram using one of the methods listed above.
    The Partner Link Property Editor dialog box appears.
  2. In the Property Editor dialog box, specify the following:
  3. Select one of the following options to specify the Partner Link Type:

To use an existing Partner Link Type:

  1. Select the Use Existing Partner Link Type option and select the partner link type from the drop-down list. The My Role and/or Partner Role fields are filled in automatically.
  2. Click OK.
    The IDE modifies the BPEL file with the values you have provided.

To add a Partner Link Type to a WSDL file and configure the Partner Link element to use it:

  1. Select the Use a Newly Created Partner Link Type option.
  2. Specify the WSDL file in which to add a partner link type. You can do one of the following:
  3. Specify the partner link type name.
  4. Specify the role for the business process (My Role) and/or the partner role (Partner Role) as follows:
    1. Select the checkbox that to the role you want to define.
    2. Specify the role name in the Role Name field.
    3. Select the Port Type from the drop-down list.
  5. Click OK.
    The IDE adds a new partner link type definition to the WSDL file and modifies the BPEL file with the values you have provided.
See Also
Receive
Reply
Invoke
Adding WSDL and XML Schema Imports
About the WSDL Editor
BPEL Designer Palette: Web Service
About the Design View of the BPEL Designer

Legal Notices