OnMessage Branch Dialog

2.81 OnMessage Branch Dialog - General Tab

Use to create an activity that indicates that the event specified must wait for a message to arrive.

A pick activity must include at least one OnMessage branch. An OnMessage branch is similar in functionality to a receive activity. The OnMessage branch indicates that the event specified must wait for a message to arrive. The usage and interpretation of correlation is the same as for receive activities.

For more information about the OnMessage branch, see the Business Process Execution Language for Web Services Specification (for BPEL 1.1) or the Web Services Business Process Execution Language Version 2.0 Specification at http://www.oasis-open.org.

The OnMessage Branch Dialog - General Tab is arranged in the following sections:

Name

The Name section enables you to name the OnMessage branch and specify optional conversation ID information.

Element	Description
Name	Enter a name or accept the default name of `OnMessagenumber`. This becomes the name for this activity in the designer.
Conversation ID	Enter a unique value. This value is used for identifying a process instance during an asynchronous conversation. By default, the BPEL process service engine generates a unique ID for each conversation (which can span multiple invoke and receive activities), as specified by WSA addressing. If you want, you can specify your own value for the engine to use.

Interaction Type - Event

The Interaction Type -Event section enables you to select the web service partner or business event with which to interact.

Element	Description
Event	Select to publish a business event.
Event	Click the Search icon to select the business event.
Variable	Click the Add icon to automatically create a variable. The variable is automatically assigned a message type. Click the Search icon to browse a list of existing variables to assign.

Interaction Type - Partner Link

The Interaction Type - Partner Link section enables you to select the web service partner with which to interact.

Element	Description
Partner Link	Select the partner link to invoke with this activity.
Port Type	Select the port type for this activity. This field only displays in BPEL 2.0 projects.
Operation	Select the operation to be performed.
Input	Select Argument Mapping or Variable.
Argument Mapping	Select to set the message parts for the selected operation.
Operation Parts Table	Displays the message parts, message types, and values of the selected operation.
Parts	Displays the message part.
Type	Displays the message type.
Value	Click to set the value for the message part. Select the variable in which to retrieve the value and store in the message part.
Variable	Select to specify a variable.
Variable	Select one of the following options: Click the Add icon to automatically create a variable for this activity. The variable follows a naming convention of `activity_name_operation_InputVariable`. For example, if the activity name is `invokeCredit` and the operation is `initiate`, the variable is named `invokeCredit_initiate_InputVariable`. A message type is automatically assigned to this variable (for example, request message). Click the Search icon to browse a list of existing variables to assign to this activity.