Guide to Building Business Processes

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Adding Message Paths

A Message Path is used to interrupt an executing process on delivery of a message from either a client or a control. This allows the process to halt the current stream of execution and take alternate actions. You can have as many message paths as you like in your business process.

A Message path can be associated with a node that can receive messages. For example, a client request node, a control receive node, or a client request with return node.

Note: Message paths are not supported on the following individual nodes: Perform, Client Response, Control Send, and Control Send with Return.

A Message Path can contain a Client Request or Control Receive node at which it receives the message. For the case in which an On Message path is specified for the process (that is, specified at the Start node) the first node on the path can be a Client Request with Return node.

This section contains the following topics:


Creating a Message Path

You can associate a message path with individual nodes in your business process, with groups of nodes, or with the whole process (global). You create a global message path by adding a message path to the start node of your process.

This section contains the following topics:

To Create a Message Path
  1. Select the node or groups of nodes for which you want to create a message path. (To learn about grouping nodes, see Grouping Nodes in Your Business Process)
  2. Right-click the node or group of nodes and select Add Message Path from the drop-down menu.
  3. A message path is added to your node or group of nodes and is displayed as shown in Figure 16-1.

    Figure 16-1 Message Path

    Message Path

    You can rename the path anything you like by double-clicking OnMessage and entering the new name. You can also change the name in the name field of the JPD Configuration pane.

To Configure a Message Path
  1. Double-click Start node to invoke the starting event node builder.
  2. Select the event which you want your message branch to wait for. Choose one of the following options:
    • A Client Request—Select this option if you want your message path to wait for a message from a client.
    • A Client Request with Return—Select this option if you want your message path to wait for a message from a client and then send a synchronous response back to the client. You can add optional nodes between the receive and send nodes inside the Client Request with Return node.
    • Note: This option is only available when a Message Path is added to a Start node of a business process.
    • A Control Receive—Select this option if you want your message path to wait for a message from a specified control.
  3. Click Close, to close the node builder.
  4. The node you selected is added as the starting event to your message path. To configure your starting node see, step 6

  5. Select the message path which you want to configure.
  6. The related properties are displayed in the JPD Configuration view. If the JPD Configuration view is not visible in BEA WorkSpace Studio, choose Window > Show View > JPD Configuration from the BEA WorkSpace Studio menu bar.

  7. In the JPD Configuration pane, configure the following properties:
  1. Configure your starting event by double-clicking the node you chose as the starting event. The node builder is invoked. For information on how to configure:
  2. Add any business process nodes to the exception path, as required to define the message path logic.
  3. To configure the annotations, go to Properties view. If the Properties view is not visible in BEA WorkSpace Studio, choose Window > Show View > Properties from the BEA WorkSpace Studio menu bar.

Viewing Message Paths in the Design View

When you create message path, the following icon appears beside a node (or group of nodes) in the Design view to indicate that an exception path is activated for the specified node:

Table 16-1 Message Path

Message Path

This icon represents the message path in your business process. In this case, the path appears empty, indicating that the logic to execute when a message is received is not defined yet.
To define the exception handling logic, add business process nodes by dragging the nodes from the Node Palette and dropping them on the message path.

You can collapse the view of any message path (or exception handler or timeout path) by clicking the grey arrow of the message path icon. The following figure shows the icon associated with your node to indicate a collapsed path.

Table 16-2 Collapsed and Expanded View

Message Path

You can toggle between collapsed and expanded views of paths in the Design view by clicking the message path icon.


Deleting Message Paths

To Delete a Message Path
  1. Right-click the path which you want to delete.
  2. Select Delete from the drop-down menu.
  3. The path is deleted and removed from the Design view.

WARNING: Deleting a path deletes any business process nodes you defined on that path. When you attempt to delete a path, a dialog box displays a warning message that you must acknowledge before proceeding with the deletion.

Related Topics

Grouping Nodes in Your Business Process

Writing Custom Java Code in Perform Nodes

Handling Exceptions

Adding Timeout Paths

Transaction Boundaries

  Back to Top       Previous  Next