BPEL Designer: Adding Correlation Sets Manually
See Also
Correlation in Four Steps
These are four basic steps to manually enable correlation in a process:
- Define one or more properties in the WSDL file using the WSDL Editor or using the Navigator window.
- Define property aliases in the WSDL file using the WSDL Editor or using the Navigator window.
- Define a correlation set for the Process on the BPEL diagram, using one or more of the properties.
- Associate one or more correlation sets with a message that is sent or received in an Invoke, Receive, Reply, or Pick activity.
You can add properties and property aliases to a WSDL file using one of the following methods:
After properties and property aliases are added to an imported WSDL file, you can define correlation sets for the Process element.
To define a correlation set:
- In the Design view, right-click the Process element and choose Add > Correlation Set.
Alternatively, in the BPEL Logical View of the Navigator window, right-click the Correlation Sets node and choose Add Correlation Set.
- In the Add Correlation Set dialog box, specify the name for the correlation set and click Add to add properties.
- In the Property Chooser dialog box, expand the WSDL file node, and select a property to add to the set.
- (Optional) Clear the Show Imported Files Only checkbox to view the contents of non-imported WSDL and XML schema files.
- By default, the Property Chooser dialog box only shows those files that have already been referenced in the process. However, the project may contain other .wsdl and .xsd files which have not yet been imported into the process. If you select a type for the new property that is defined in a non-imported file, the IDE will automatically add the required import to the BPEL process.
- Click OK.
The correlation sets defined for the Process have global visibility. The name of a correlation set must be unique among the names of other correlation sets.
After defining a correlation set, add it to the Invoke, Receive, or Reply elements. You can also associate a correlation set with the On Message branch of a Pick activity and the On Event branch of an Event Handlers container element.
To add a correlation set to an activity:
- In the Design view, double-click an element (Invoke, Receive, Reply, the On Message branch of Pick, or the On Event branch of an Event Handlers container element).
- In the Property Editor, select the Correlations tab and click Add.
- In the Choose a Correlation Set dialog box, expand the Correlation Sets node, select the correlation set and click OK.
- Choose the initiate attribute for this correlation set from the Initiate drop-down list. You can select one of the following options:
- Yes. The activity must attempt to initiate the correlation set.
- Join. The activity must attempt to initiate the correlation set if the correlation set is not yet initiated.
- No. The activity must not attempt to initiate the correlation set. This is the default option.
- For an Invoke activity, specify the message pattern.
From the Pattern drop-down list, select a pattern attribute to indicate whether the correlation applies to the outbound message (request), inbound message (response), or both (request-response).
- (Optional) Add more correlation sets as needed and click OK.
Correlation Attributes
A correlation within a synchronous Invoke activity has an additional attribute: pattern. This attribute specifies whether the correlation set applies to the request message, the response message, or both.
- See Also
- Understanding Correlation. Using the Correlation Wizard
- Configuring Properties and Property Aliases Using the WSDL View
- Pick
- Invoke
- Receive
Legal Notices