Select Resource Browser > Proxy Services to display the Summary of Proxy Services page.
Click the Edit Message Flow icon in the row of the proxy service whose message flow you want to view or edit.
If no message flow has yet been created for the selected proxy service, the Edit Message Flow page is displayed with a single icon on the page, the Proxy Service icon. This is the starting node for the proxy service. Click this icon to begin constructing the message flow.
If the proxy service already has a message flow, the page contains a graphic representation of the flow. Click the icons to view or edit the parts of the message flow.
See Edit Message Flow page for information about what you can do to construct a message flow on that page.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Edit Message Flow page
Use the Edit Message Flow page to construct a message flow for a proxy service.
The left navigation pane of the Edit Message Flow page shows a tree view of the nodes and objects in the message flow. When the details of an object are defined on a separate page, you can click the name of the object to display the associated page.
The right pane provides a field upon which to construct the message flow. When a message flow has not yet been defined, the pane includes a single Proxy Service icon that signifies the starting node for the service. Click the icon to add pipeline pair nodes, route nodes, conditional branches, operational branches, and error handling for the service.
When you add objects to the page, icons are displayed on the page to represent the objects. The relationships among the objects are shown with lines and bounding boxes. Click an icon on the Edit Message Flow page to display a menu of the actions you can perform on that object. The options available on the menu may differ, depending on context. See Table 18-1 for a complete list of icons and options.
Table 18-1 Edit Message Flow Page Icons and Options
Use the Edit Stage Configuration page to add actions to pipeline stages, error handler stages, and route nodes in a message flow.
When nothing has yet been defined on the Edit Stage Configuration page, the only object displayed is the Add an Action icon. Click that icon to get started.
When a stage or a route node has already been configured, the actions and objects defined for that stage or route node appear on the page. Edit the existing actions, as appropriate, or click any of the icons representing actions to add more actions to the stage.
Message flows can include zero or more pipeline pair nodes: request and response pipelines for the proxy service (or for the operations on the service), and error handler pipelines that can be defined for stages, pipelines, and proxy services. pipelines can include one or more stages, which in turn include actions.
Click the Proxy Service icon, then click Add Pipeline Pair.
To change the default name and add a description for the pipeline pair node, do the following:
Click the Pipeline Pair Node icon, then click EditName and Annotation.
Change the name and description, as desired.
Click Save.
Note:
When you rename a pipeline or a route node, the number of messages displayed on the Dashboard page in the Monitoring module may not correlate with those of other components due to the pipeline counters being reset to zero. This is because ALSB treats the rename as a delete and recreate action. The numbers should correlate again after a time period equal to the service's monitoring interval has elapsed.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Adding Conditional Branches to Message Flows
A branch node allows processing to proceed along exactly one of several possible paths. Branching is driven by an XPath-based switch table. Each branch in the table specifies a condition (for example, <500) that is evaluated in order down the message flow against a single XPath expression (for example, ./ns: PurchaseOrder/ns:totalCost on $body). Whichever condition is satisfied first determines which branch is followed. If no branch condition is satisfied, then the default branch is followed. A branch node may have several descendants in the message flow: one for each branch, including the default branch.
If the proxy service is not based on a WSDL and receives multiple document types as input, consider using a conditional branch node.
Conditional branching is driven by a lookup table with each branch tagged with a simple, but unique, string value. A variable in the message context is designated as the lookup variable for that node, and at run time, its value is used to determine which branch to follow. If no branch matches the value of the lookup variable, the default branch is followed. You should design the proxy service in such a way that the value of the lookup variable is set before reaching the branch node.
Click a Pipeline Pair Node icon or a Branch Node icon, then click Create Conditional Branch. The conditional branch node is added, and any existing nodes after the inserted branch node are moved to the default branch of the new conditional branch node.
To change the default name and add a description for the branch node, do the following:
Click the Conditional Branch icon, then click EditName and Annotation.
Change the name and description, as desired.
Click Save.
To add branch definitions, click the Conditional Branch icon, then click Edit Branch. The Edit Branch Node page is displayed.
From the Operator field, select a comparison operator.
In the Value field, enter a value for the branch.
In the Label field, enter a label for the branch.
Optionally, under Options:
Click Add a New Branch to add a new branch definition to this branch node.
Click Delete this Branch to delete a branch definition.
Click Move Branch Up or click Move Branch Down to change the positions of branch definitions. This option displays only when more than one branch definition exists.
Click Save to commit the updates in the current session.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Adding Operational Branches to Message Flows
When message flows define Web Services Description Language (WSDL)-based proxy services, operation-specific processing is required. Instead of configuring a branching node based on operations manually, ALSB provides a minimal configuration branching node that automatically branches based on operations. In other words, when you create an operational branch node in a message flow, you can quickly build your branching logic based on the operations defined in the WSDL because the ALSB Console presents those operations in the branch node configuration page.
A branch node allows processing to proceed along exactly one of several possible paths. Branching is driven by an XPath-based switch table. Each branch in the table specifies a condition (for example, <500) that is evaluated in order down the message flow against a single XPath expression (for example, ./ns: PurchaseOrder/ns:totalCost on $body). Whichever condition is satisfied first determines which branch is followed. If no branch condition is satisfied, then the default branch is followed. A branch node may have several descendants in the message flow: one for each branch, including the default branch.
Click a Pipeline Pair Node icon or a Branch Node icon, then click Create Operational Branch. The operational branch node is added, and any existing nodes after the inserted branch node are moved to the default branch of the new operational branch node.
To change the default name and add a description for the branch node, do the following:
Click the Operational Branch icon, then click EditName and Annotation.
Change the name and description, as desired.
Click Save.
To add branch definitions, click the Operational Branch icon, then click EditBranch. The Edit Branch Node page is displayed.
In the Operation Branch Definitions panel, select a service operation.
Optionally, under Options:
Click Add a New Branch to add a new branch definition to this branch node.
Click Delete this Branch to delete a branch definition.
Click Move Branch Up or click Move Branch Down to change the positions of branch definitions. This option displays only when more than one branch definition exists.
If necessary, click the plus sign to the left of the Pipeline Pair Node icon to expand it. A pipeline pair contains a Request Pipeline and a Response Pipeline.
Click the pipeline to which you want to add the stage, then click Add Stage.
To change the default name and add a description for the stage, do the following:
Click the Stage icon, then click EditName and Annotation.
To add error handling to the stage, click the Stage icon, then click Add Stage Error Handler. See Adding Stage Error Handlers. The Edit Message Flow page is displayed.
Click the Pipeline Pair Node icon of a pipeline pair, then click Add Route.
To change the default name and add a description for the route node, click the Route Node icon, then click EditName and Annotation.Change the name and description, as desired, then click Save.
Note:
When you rename a pipeline or a route node, the number of messages displayed on the Dashboard page in the Monitoring module may not correlate with those of other components due to the pipeline counters being reset to zero. This is because ALSB treats the rename as a delete and recreate action. The numbers should correlate again after a time period equal to the service's monitoring interval has elapsed.
To add actions to the route node, click the Route Node icon, then click EditRoute. The Edit Message Flow page is displayed. See the following sections for information about the actions you can add to route nodes:
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Cutting, Copying, and Pasting Stages and Route Nodes
You can cut, copy, and paste stages and route nodes.
To cut a stage or a route node, click its icon and select Cut or Copy.
To paste a stage that you cut or copied from a different pipeline pair within the message flow of this proxy service or from the message flow of a different proxy service, do one of the following:
Click the Request Pipeline or Response Pipeline icon, then click Paste Stage.
Click the Stage icon in a pipeline, then click Paste.
To paste a route node that you cut or copied from the message flow of another proxy service, click the Pipeline Pair Node icon for the pipeline pair, then click Paste Route.