Invoke
See Also
The Invoke activity invokes a one-way or request-response operation between the BPEL process and a partner web service on a port provided by the partner. Invoke is used in both synchronous and asynchronous calls. In other words, it enables the BPEL process to exchange messages with partners.
As Invoke interacts with a partner web service, an Invoke activity should be associated with a Partner Link element on the diagram.
To use the Invoke element:
- In the Design view, drag the Invoke element from the Palette to the diagram.
- Right-click the Invoke element and choose Edit.
- In the Property Editor dialog box, configure the following:
- Name. Enter an arbitrary name.
- Partner Link. Select a Partner Link for which to specify an operation. Another way to associate a Partner Link with the Invoke activity is to draw a message flow on the diagram.
- Operation. Define an operation to be invoked. The operation is defined in the partner WSDL file, so you can only select it from the drop-down list.
- Input Variable. Create a new variable or use an existing variable to pass the input data to the partner service.
- Output Variable. Create a new variable or use an existing variable to transport the data received from the partner service.
The Invoke element is now configured to invoke calls to the target partner web service.
Adding Correlation Sets
You can add correlation sets defined for the Process element to an Invoke activity. Before adding a correlation set to Invoke, make sure that at least one correlation set has been defined for the Process element.
To add a correlation set to Invoke:
- In the Design view, right-click an Invoke element and choose Edit.
- 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.
- From the Initiate drop-down list, choose the initiate attribute for this correlation set. 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.
- 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.
- See Also
- Partner Link
- Creating Variables
- Understanding Correlation
- Adding Correlation Sets
- New Variable Dialog Box
- BPEL Designer Palette: Web Service
- About the Design View of the BPEL Designer
Legal Notices