|
|
This section describes all the views, dialogs, wizards, and other user interface objects in the ALSB plug-in.
The following pages are provided for managing alerts:
An alert destination is a destination address for alert notifications in ALSB. Use this page to configure an alert destination resource. For more information, see Alert Destinations in Using the AquaLogic Service Bus Console.
Continue in the Edit Alert Destination page. Click Add to add e-mail and JMS recipients to an alert destination. See:
For more information, see Adding E-Mail and JMS Recipients in Using the AquaLogic Service Bus Console.
Use this page to configure the destination target for an alert sent via e-mail (that is, using the e-mail transport). For more information, see Adding E-Mail Recipients in Using the AquaLogic Service Bus Console.
Use this page to configure the destination target for an alert sent via JMS (that is, using the JMS transport). For more information, see Adding JMS Recipients in Using the AquaLogic Service Bus Console.
You configure new business services while creating them in the New AquaLogic Business Service wizard. You can view and modify those settings in the AquaLogic Business Service editor: With a few exceptions, configuration options are identical in the wizard and the editor and are therefore documented in one place. The wizard and editor business service configuration pages are:
Use the AquaLogic Business Service General Configuration page to specify general configuration settings for a business service. This page appears both in the New AquaLogic Business Service wizard and in the AquaLogic Business Service editor. Options vary, depending on whether you are using the wizard or the editor, as described below.
The following table describes the options in the wizard:
The following table describes the options in the editor:
Use the AquaLogic Business Service Message Type Configuration page to configure message types for a business service whose type is Messaging Service. This page appears both in the New AquaLogic Business Service wizard and in the AquaLogic Business Service editor:
The binding definition for messaging services consists of configuring the content-types of the messages that are exchanged. The content-type for the response does not need to be the same as for the request; therefore, the response is configured separately (for example, the service could accept an MFL message and return an XML acknowledgment receipt).
| Note: | E-mail, File, FTP, or SFTP transport business services whose type is Messaging Service support one-way messaging only; the Response Message Type should be None. If you select an option other than None, the file, ftp, or sftp protocol will not be available on the Transport Configuration page. |
Use the AquaLogic Business Service Service Policy Configuration page to configure service policy settings for a proxy service. This page appears both in the New AquaLogic Business Service wizard and in the AquaLogic Business Service editor.
Select this option to add service-level policies, operation-level policies (in which case the policy applies to both the request and response messages), request policies, and response policies directly.
For more information about configuring service policies, see
Configuring Message Level Security for Web Services in the AquaLogic Service Bus Security Guide.
|
Use AquaLogic Business Service SOAP Binding Configuration page to configure the SOAP Binding for a business service based on a WSDL. This page appears both in the New AquaLogic Business Service wizard and in the AquaLogic Business Service editor:
Select or deselect Enforce WS-I Compliance to specify whether or not the service is to conform to the Basic Profile defined by the Web Services Interoperability Organization. This option is available for or SOAP 1.1 services only
When a service is marked WS-I compliant, checks are performed against the messages sent to and from that service.
Use the AquaLogic Business Service Transport Configuration page to select, review, or change the service’s transport protocol and to set, review, or change general transport configuration settings. This page appears both in the New AquaLogic Business Service wizard and in the AquaLogic Business Service editor:
Outbound transport-level security applies to the connections between ALSB proxy services and business services. For more information about transport-level security, see Configuring Transport-Level Security in the AquaLogic Service Bus Security Guide.
For every new message, there is a new order of URLs. |
|||
Enter an endpoint URL in the format based on the transport protocol you selected in the Protocol field, above: The formats are:
In the URI,
If the JNDI provider is located on the same server, the JNDI provider need not be specified. The URI then would be
The HTTP transport supports both
To target a JMS destination to multiple servers, use the following URI format:
To make the MQ transport available in ALSB, see MQ Connections in Using the AquaLogic Service Bus Console.
|
|||
In the URI, If more than one URI is specified, you must have unique resource names for the endpoints. If no remote name is specified, its value is the value of the resource name. If no remote name is entered or if remote and resource name are the same, only one URI is allowed. In this case resource name and remote name have the same value. This allows already defined WTC Imports to make use of WTC load-balancing and failover. For more information, see AquaLogic Service Bus Interoperability Solution for Tuxedo.
Click Add to add one or more additional URIs. At run time, the URLs are selected based on the load balancing algorithm you selected in the Load Balancing Algorithm field.
If you selected Random-weighted in the Load Balancing Algorithm field, you can also enter a weight in the Endpoint URI field. The default is
1.
|
|||
In case of delivery failure when sending outbound requests, specify the number of times to retry individual URL endpoints; in other words, the number of failover attempts.
|
|||
You configure new proxy services while creating them in the New AquaLogic Proxy Service wizard. You can view and modify those settings in the AquaLogic Proxy Service editor: With a few exceptions, configuration options are identical in the wizard and the editor and are therefore documented in one place. The wizard and editor business service configuration pages are:
Use the AquaLogic Proxy Service General Configuration page to set or modify general configuration properties for a proxy service. This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor: Options vary, depending on whether you are using the wizard or the editor, as described below.
The following table describes the options in the wizard:
Select this option to create a proxy service based on a WSDL. Then enter the WSDL name, qualified by its path (for example,
myProject/myFolder/myWSDL). Alternatively, click Browse to select a WSDL resource.
(port or binding) - Enter the name of a port (defined in the WSDL) to describe an actual transport address, or enter the name of a binding (defined in the WSDL) to map to a transport address. If you use Browse to select a WSDL, the Select a WSDL Definition dialog lists any defined ports and bindings.
|
|||
|
|||
Select this option to create a proxy service with a route node that routes to the business service you select. You cannot create a proxy service from a transport typed business service. If you create a proxy service from a DSP transport business service, ALSB switches the transport type of the proxy service to HTTP, because the DSP transport cannot be used for proxy services. You can change the transport type of the proxy service to any other available transport.
|
|||
|
Select the Enabled check box and whether to buffer the intermediate content in memory (Memory Buffer) or to a disk file (Disk Buffer).
For more information, see
Streaming body Content in the AquaLogic Service Bus User Guide.
|
The following table describes the options in the editor:
This option shows the service type of the proxy service. You can change only some of the properties of some of the service types:
|
|
|
Select the Enabled check box and whether to buffer the intermediate content in memory (Memory Buffer) or to a disk file (Disk Buffer).
For more information, see
Streaming body Content in the AquaLogic Service Bus User Guide.
|
Use the AquaLogic Proxy Service Message Level Security Configuration page to configure message-level security for the proxy service. This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor:
Message-level custom tokens and message-level user name and password are supported on proxy services of the following binding types:
The configuration for both custom user name/password and custom token is similar. In both cases, you specify XPath expressions that enable ALSB to locate the necessary information. The root of these XPath expressions is as follows:
All XPath expressions must be in a valid XPath 2.0 format. The XPath expressions must use the XPath "declare namespace" syntax to declare any namespaces used, as follows:
declare namespace
ns='http://webservices.mycompany.com/MyExampleService';)
|
You can enter the path (
project/folder) and name of a service key provider, or click Browse to select one.
|
|
Enter the type for the custom token type. Only the active token types configured for a WebLogic Server Identity Assertion provider can be used.
See
Configuring Identity Assertion Providers for Custom Tokens for more information.
|
|
An XPath expression that specifies a path to the custom token. ALSB evaluates the Token XPath expression against the message headers or payload, as appropriate, to obtain the token for custom authentication.
To create or edit an expression, click <XPath> (or the expression_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
Optionally, specify one or more context properties to pass additional context information to the Authentication (Custom User Name and Password) or Identity Assertion (Custom Token) security provider.
Context Properties provide a way (the
ContextHandler interface) to pass additional information to the WebLogic Security Framework so that a security provider can obtain contextual information. See
Additional Context Properties for Message Level Authentication for more information.
Enter the Property Name as a literal string, and the Value Selector as a valid XPath expression. (XPath expressions can also be literal strings.)
The XPath expressions are evaluated against the same message-part that is used for the custom token or custom user name/password. That is, the Value Selector XPath expressions for SOAP-based proxy services evaluate against the header and against the payload for non-SOAP-based proxy services.
The XPath expression is evaluated at runtime to produce the property's value. A ContextHandler is essentially a name/value list and, as such, it requires that a security provider know what names to look for. Therefore, the XPath expressions are evaluated only if a security provider asks for the value of one of these user-defined properties.
|
Use AquaLogic Proxy Service Message Type Configuration page to configure message types for a proxy service whose type is Messaging Service. This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor:
The binding definition for messaging services consists of configuring the content-types of the messages that are exchanged. The content-type for the response does not have to be the same as for the request; therefore, the response is configured separately (for example, the service could accept an MFL message and return an XML acknowledgment receipt).
| Note: | E-mail, File, FTP, or SFTP transport proxy services whose type is Messaging Service support one-way messaging only; the Response Message Type should be None. If you select an option other than None, the E-mail, File, FTP, or SFTP protocols will not be available on the Transport Configuration page. |
Use AquaLogic Proxy Service Operation Selection Configuration page to enforce WS-I compliance (for SOAP 1.1 services only) and select the selection algorithm to use to determine the operation called by this proxy service. This option is only available for SOAP or XML services defined from a WSDL.
The WSDL specification defines a default algorithm to compute which operation is called based on the type of the SOAP message received. However, there are cases (for example, performance issues, signature/encryption issues, or the default algorithm is not applicable) when you may need to select the operation based on other means.
ALSB provides additional algorithms. Each of them follows the same pattern and are based on the evaluation of an expression to get a value that is then used to lookup the corresponding operation in a static table.
ALSB is generally very forgiving if an inbound message is either missing data such that the operation cannot be determined, or has data that does not correspond to a valid operation. Both of these conditions result in $operation being empty. Rather than reject all such messages, ALSB does not initialize the operation variable in the context but otherwise continues to process the message.
However, security requirements are enforced if the proxy service is WSDL-based and at least one of the following conditions is true:
If these conditions are met, then there is a runtime check to make sure the operation selection algorithm returns a valid operation name. If the operation selection returns null or an operation that is not in the WSDL, then the message is rejected and an error is raised.
Use AquaLogic Proxy Service Service Policy Configuration page to configure service policies for a proxy service. This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor:
This page is displayed only if the service you are creating has operations. This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor:
Use the AquaLogic Proxy Service SOAP Binding Configuration page to enforce WS-I compliance (for SOAP 1.1 services only) and select the selection algorithm to use to determine the operation called by this proxy service. This option is only available for SOAP or XML services defined from a WSDL.
The WSDL specification defines a default algorithm to compute which operation is called based on the type of the SOAP message received. However, there are cases (for example, performance issues, signature/encryption issues, or the default algorithm is not applicable) when you may need to select the operation based on other means.
ALSB provides additional algorithms. Each of them follows the same pattern and are based on the evaluation of an expression to get a value that is then used to lookup the corresponding operation in a static table.
ALSB is generally very forgiving if an inbound message is either missing data such that the operation cannot be determined, or has data that does not correspond to a valid operation. Both of these conditions result in $operation being empty. Rather than reject all such messages, ALSB does not initialize the operation variable in the context but otherwise continues to process the message.
However, security requirements are enforced if the proxy service is WSDL-based and at least one of the following conditions is true:
If these conditions are met, then there is a runtime check to make sure the operation selection algorithm returns a valid operation name. If the operation selection returns null or an operation that is not in the WSDL, then the message is rejected and an error is raised.
Use the AquaLogic Proxy Service Transport Configuration page to select a transport protocol for the proxy service and to set other general transport configuration settings.
This page appears both in the New AquaLogic Proxy Service wizard and in the AquaLogic Proxy Service editor:
| Note: | Inbound transport-level security applies to the client applications and ALSB proxy services. Outbound transport-level security applies to the connections between ALSB proxy services and business services. To learn more about transport-level security, see Configuring Transport-Level Security in the AquaLogic Service Bus Security Guide. |
Enter an endpoint URI in the format based on the transport protocol you selected in the Protocol field, above: The formats are:
The HTTP transport supports both To target a target a JMS destination to multiple servers, use the following URI format:
Note that when you create a proxy service, you can configure a JMS endpoint URI even if the server at that endpoint if not available. However, in the case of JMS, when you activate the session, the endpoint must be available. This transport does not require an endpoint URI.
To make the MQ transport available in ALSB, see MQ Connections in Using the AquaLogic Service Bus Console.
|
|||
The URI If more than one URI is specified, you must have unique resource names for the endpoints. If no remote name is specified, its value is the value of the resource name. If no remote name is entered or if remote and resource name are the same, only one URI is allowed. In this case resource name and remote name will have the same value. This allows users using already defined WTC Imports to make use of WTC load-balancing and failover. Note: If you configure two identical URIs, an error indicates that the service name already exists. |
|||
|
Select No to retrieve a defined set of headers. If you select No, enter a set of headers in the Header field, then click Add. (This step does not apply to Local transport.)
|
The following are provided for working with ALSB configurations and projects.
This view displays a hierarchical list of all your ALSB configurations and the projects they contain. See also New AquaLogic Service Bus Configuration Project wizard.
You can do the following in the Configurations view:
Use this wizard to create an ALSB configuration project. For configuration options, see ALSB Configuration page.
An ALSB configuration project is a grouping of ALSB projects and resources destined for a server, a location for system resources (SMTP, UDDI, and such), and a container for validation; for example, a resource in a project associated with one ALSB configuration cannot refer to a resource in a project associated to another ALSB configuration.
Use this page to create a new ALSB configuration project (in the New AquaLogic Service Bus Configuration Project wizard) or to to configure an existing one (in the Properties for ALSB Configuration editor).
The preserve, session, and customization file settings are used when publishing an ALSB configuration to the server, and used as defaults when configuring the Export wizard - Export to Server - Select Resources page.
Select this check box to discard the session if the activation fails (for example, due to conflicts). For more information, see
Activating Sessions in Using the AquaLogic Service Bus Console.
|
|
Specify a customization.xml file or click Browse, locate the file, then click Open. For information on customization, see
Creating Customization Files in Using the AquaLogic Service Bus Console.
|
|
The name of the server associated with this ALSB configuration. This setting is automatically configured unless there is more than one server from which to choose. When multiple servers are associated with the same ALSB configuration, use the drop-down list to select the server you want to associate with this ALSB configuration.
|
|
Use this page to create a new ALSB project.
Enter a unique name for the project. For more information, see
Naming Projects and Folders in Using the AquaLogic Service Bus Console.
|
|
Select an existing ALSB configuration or click New to open the New AquaLogic Service Bus Configuration Project wizard, where you can create a new configuration.
|
You can define custom resources for use by ALSB using the New Custom Resource wizard and the Custom Resource editor, as described in the following topics:
Use this wizard to create a new custom resource.
Use this editor to modify the configuration of a custom resource. The General page identifies the type of custom resource. The Custom page provides options for editing the configuration for that type of custom resource.
Use this page to select the type of custom resource to create. Select the type of custom resource to create from the list of available resource type.
Use this page to configure a custom MQ connection resource. For information on MQ connection resources and MQ transports, see the following:
|
The coded character set identifier (CCSID) to be used when establishing a connection. The CCSID is used mainly for internationalization support.
To learn more, see IBM’s
WebSphere MQ Fundamentals.
|
|
The Export wizard contains the following pages:
Use this page to export ALSB resources to a configuration JAR file. For more information, see Exporting Resources in Using the AquaLogic Service Bus Console.
|
|||||
Use this page to select the projects or resources you want to export. Clear the check boxes next to any resources that you do not want to include in this export.
Select this check box to create and activate a session in the ALSB console. For more information, see
Activating Sessions in Using the AquaLogic Service Bus Console.
|
|
Specify a customization file or click Browse, locate the file, then click Open. For information on customization, see
Creating Customization Files in Using the AquaLogic Service Bus Console.
|
|
Use this page to select the projects or resources you want to export.
The Import wizard has the following pages:
Use this page to select a configuration JAR to import and an import destination. For more information, see Importing Resources in Using the AquaLogic Service Bus Console.
Select an existing ALSB configuration or click New to open the New AquaLogic Service Bus Configuration Project wizard, where you can create a new configuration.
|
|
Use this page to select the objects on which you want to operate (create, update, or delete). Resources are only scheduled for deletion when the JAR being imported is a full project JAR and there are project resources in the importing system that are not present in the imported JAR file. To prevent resources from being deleted, deselect them. For more information, see Importing Resources in Using the AquaLogic Service Bus Console.
Use this page to select a ZIP file with resources to import and an import destination. For more information, see Loading Resources from a Zip File in Using the AquaLogic Service Bus Console.
Use this page to select the objects you want to import. Clear the check boxes next to any resources that you do not want to include in this import. For more information, see Loading Resources from a Zip File in Using the AquaLogic Service Bus Console.
Use this page to import resources such as WSDLs or XML schemas that are available on the Web. You can import them, along with all their dependents, by specifying the URL of the root resource. For more information, see Loading Resources from a URL in Using the AquaLogic Service Bus Console.
Use this page to select the objects you want to import. Clear the check boxes next to any resources that you do not want to include in this import. For more information, see Loading Resources from a URL in Using the AquaLogic Service Bus Console.
The following are provided for working with JNDI providers:
Use this editor to modify an existing JNDI provider configuration. For descriptions of the fields, see the New JNDI Provider Resource wizard. For more information, see Editing JNDI Providers in Using the AquaLogic Service Bus Console.
Use this page to configure a new JNDI provider resource. For more information, see Adding JNDI Providers in Using the AquaLogic Service Bus Console.
The Message Flow Design Palette lists all the nodes and actions you can use to construct a message flow for a proxy service. To insert a node or an action into a message flow, drag the item from the palette to the Message Flow Editor. When you drag an item to the palette, one or more targets appear (
) to indicate that you can drop the dragged item in that position on the palette. When you drag the item onto a target, the target is highlighted (
) to show that you can drop the item there.
You can also add nodes and actions to message flows by right-clicking an object in the Message Flow Editor and choosing a node or action from the Insert, Insert Into, or Insert After submenus. You can also add an error handler by selecting the Add Error Handler command. These submenus and commands are context sensitive. That is, they appear only when it is legal to add the item into the selected context in the message flow.
The Message Flow Design Palette is organized into the following categories:
The following table describes the nodes you can add to a message flow:
|
For configuration properties, see Conditional Branch Node Properties.
|
|
|
For configuration properties, see Operational Branch Node Properties.
|
|
|
For configuration properties, see Pipeline Pair Node Properties.
|
|
|
For configuration properties, see Route Node Properties.
|
|
|
For configuration properties, see Stage Node Properties.
|
|
|
For configuration properties, see Error Handler Node Properties.
|
The following table describes the communication actions you can add to a route in a message flow:
A dynamic routing action assigns a route for a message based on routing information available in an XQuery resource.
For configuration properties, see Dynamic Routing Action Properties.
|
|
A routing action identifies a target service for the message and configures how the message is routed to that service:
For configuration properties, see Routing Action Properties.
|
|
A routing table action assigns a set of routes wrapped in a switch-style condition table. Different routes are selected based upon the results of a single XQuery expression.
For configuration properties, see Routing Table Action Properties.
|
The following table describes the flow control action you can add to a route in a message flow:
An if-then action performs an action or a set of actions conditionally, based on the Boolean result of an XQuery expression.
For configuration properties, see If-Then Action Properties.
|
The following table describes the communication actions you can add to a stage in a message flow:
|
For configuration properties, see Dynamic Publish Action Properties.
|
|
|
For configuration properties, see Publish Action Properties.
|
|
A publish table action publishes a message to zero or more statically specified services. Switch-style condition logic is used to determine at run time which services will be used for the publish.
For configuration properties, see Publish Table Action Properties.
|
|
A routing options action modifies any or all of the following properties in the outbound request: URI, Quality of Service, Mode, Retry parameters, Message Priority.
For configuration properties, see Routing Options Action Properties.
|
|
A service callout action configures a synchronous (blocking) callout to an ALSB-registered proxy or business service.
For configuration properties, see Service Callout Action Properties.
|
|
|
For configuration properties, see Transport Headers Action Properties.
|
The following table describes the flow control actions you can add to a stage in a message flow:
|
For configuration properties, see For-Each Action Properties.
|
|
An if-then action performs an action or set of actions conditionally, based on the Boolean result of an XQuery expression.
For configuration properties, see If Action and Else-If Action Properties.
|
|
|
For configuration properties, see Raise Error Action Properties.
|
|
|
For configuration properties, see Reply Action Properties.
|
|
A skip action specifies that at run time, the execution of the current stage is skipped and the processing proceeds to the next stage in the message flow.
For configuration properties, see Skip Action Properties.
|
|
|
For configuration properties, see Resume Action Properties.
|
The following table describes the message processing actions you can add to a stage in a message flow:
|
For configuration properties, see Assign Action Properties.
|
|
|
For configuration properties, see Delete Action Properties.
|
|
An insert action inserts the result of an XQuery expression at an identified place relative to nodes selected by an XPath expression.
For configuration properties, see Insert Action Properties.
|
|
|
For configuration properties, see Java Callout Action Properties.
|
|
|
For configuration properties, see MFL Transform Action Properties.
|
|
A rename action renames elements selected by an XPath expression without modifying the contents of the element.
For configuration properties, see Rename Action Properties.
|
|
|
For configuration properties, see Replace Action Properties.
|
|
A validate action validates elements selected by an XPath expression against an XML schema element or a WSDL resource.
For configuration properties, see Validate Action Properties.
|
The following table describes the reporting actions you can add to a stage in a message flow:
|
For configuration properties, see Alert Action Properties.
|
|
|
For configuration properties, see Log Action Properties.
|
|
|
For configuration properties, see Report Action Properties.
|
Use this editor to construct a proxy service message flow. To insert a node or an action into a message flow, drag the item from the Message Flow Design Palette to the editor. When you drag an item to the editor, one or more targets appear (
) to indicate that you can drop the dragged item in that position on the palette. When you drag the item onto a target, the target is highlighted () to show that you can drop the item there.
You can also add nodes and actions to message flows by right-clicking an object in the Message Flow Editor and choosing a node or action from the Insert, Insert Into, or Insert After submenus. You can also add an error handler by selecting the Add Error Handler command. These submenus and commands are context sensitive. That is, they appear only when it is legal to add the item into the selected context in the message flow.
When you select a node or action in the editor, a configuration page for that item is displayed in the Properties view. You can add or modify configuration properties in those pages. The message flow node and action properties configuration pages are:
In a message flow, use the alert action to generate alerts based on message context in a pipeline, to send to an alert destination. Unlike SLA alerts, notifications generated by the alert action are primarily intended for business purposes, or to report errors, and not for monitoring system health. Alert destinations should be configured and chosen with this in mind. To learn more about alert destinations, see Alert Destination editor.
If pipeline alerting is not enabled for the service or at the domain level, the configured alert action is bypassed during message processing.
In the Message Flow Editor, click an alert action to display its properties in the Properties view. Use these properties pages to configure the selected alert action. The pages are:
The Alert page has the following options:
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|
| Tip: | To prevent exceptions from aborting the message being processed when generating a pipeline alert, it is recommended that an error handler for the alert action be defined to handle and contain such exceptions locally, rather than having them bubble up to a global error handler. |
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use an assign action to assign the result of an XQuery expression to a context variable.
In the Message Flow Editor, click an assign action to display its properties in the Properties view. Use these properties pages to configure the selected assign action. The pages are:
The Assign page has the following options:
An expression that creates the data that is assigned to variable named in the Variable field, described below.
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a conditional branch node to specify that message processing is to proceed along exactly one of several possible paths, based on a result returned by an XPath condition.
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.
In the Message Flow Editor, click a conditional branch node to display its properties in the Properties view. Use these properties pages to configure the selected conditional branch node. The pages are:
The Flow page has the following options:
The Conditional Branch page has the following options:
The XPath expression that defines the condition to be evaluated for determining the branch to follow.
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
A conditional branch node also always contains one or more branches, which are configured as part of the node.
Click a Branch icon in a conditional branch node to display the Branch properties page in the Properties view. Use these properties pages to configure the selected branch node in a message flow. This page has the following options.
In a message flow, use a delete action to delete a context variable or a set of nodes specified by an XPath expression.
In the Message Flow Editor, click a delete action to display its properties in the Properties view. Use these properties pages to configure the selected delete action. The pages are:
The Delete page has the following options. Select Variable to delete a variable, or select XPath to delete an XPath expression.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a dynamic publish action to publish a message to a service specified by an XQuery expression.
In the Message Flow Editor, click a dynamic publish action to display its properties in the Properties view. Use these properties pages to configure the selected dynamic publish action. The pages are:
The Dynamic Publish page has the following options:
|
To create or edit the expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
In the editor, enter an Xquery expression or select an XQuery resource that provides a result similar to:
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a dynamic routing action to assign a route for a message based on routing information available in an XQuery resource.
This is a terminal action, which means you cannot add another action after this one. However, this action can contain request and response actions.
In the Message Flow Editor, click a dynamic routing action to display its properties in the Properties view. Use these properties pages to configure the selected dynamic routing action. The pages are:
The Dynamic Routing page has the following option:
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
In the XQuery/XSLT Expression editor, enter an Xquery expression, the result of which is similar to:
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
Use an error handler to specify what should happen if an error occurs in a specific location in the message flow.
All configuration for an error handler is in one or more stages contained by the error handler. See Stage Node Properties.
In a message flow, use the for-each action to iterate over a sequence of values and execute a block of actions.
In the Message Flow Editor, click a for-each action to display its properties in the Properties view. Use these properties pages to configure the selected for-each action. The pages are:
The For Each page has the following options:
An XPath expression that specifies where in the structure of the containing context variable the variable specified in the For Each Variable field is located.
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use an if-then action to perform an action or a set of actions conditionally, based on the Boolean result of an XQuery expression.
In the Message Flow Editor, click an if-then action to display its properties in the Properties view. Use this page to review and configure general properties of the if-then action. The pages are:
An if-then action always contains an if condition plus zero or more else-if condition, where you define the conditions for the if-then action. An if-then action also always contains an else condition, which defines the default path when no other condition is met.
Click an If:condition icon or an Else-If:condition icon in an if-then action to display their properties in the Properties view. Use these properties pages to configure the selected condition. This If condition properties page has the following option.
If actions and else-if actions are always contained by an if-then action. The message follows the path associated with the first if action or else-id action that returns true.
A condition in an if action or an if-else action that contains one of the tests for following alternative paths in the flow.
In the route node, you can select only the routing, dynamic routing, or routing table actions. However, these actions can contain request and response actions.
|
The else action does not have associate properties. When all if and else-if conditions return false, the message proceeds down the path associated with the else action.
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use an insert action to insert the result of an XQuery expression at an identified place relative to nodes selected by an XPath expression.
In the Message Flow Editor, click an insert action to display its properties in the Properties view. Use these properties pages to configure the selected insert action. The pages are:
The Insert page has the following options:
The XQuery expression used to create the data that will be inserted at a specified location in a named variable.
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|
The location where the insert is performed, relative to the result of the XPath expression: Options are:
|
|
|
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a Java callout action to invoke a Java method or an EJB business service from within the message flow.
In the Message Flow Editor, click a Java callout action to display its properties in the Properties view. Use these properties pages to configure the selected Java callout action. The pages are:
The Java Callout page has the following options:
|
Click Browse to select a class and a static method from an archived resource. Once you have selected the class and method, a table appears on the Java Callout Properties page:
The Action column provides an <Expression> or
expression_fragment link to the XQuery/XSLT Expression Editor, where you can create an expression to retrieve a value for the argument.
If the type of the input value you enter does not match the declared input argument type, ALSB tries to automatically typecast input values to the declared type of the input argument. For example a string value of
"123" will be converted to integer 123 if the declared type of the input argument is java primitive int.
|
|
An optional Service Account, which can be specified if there is a security context for this Java method.
In the case of fixed and mapped service accounts, the userid/password from the service account is authenticated in the local system and the security context propagated to the Java callout. In the case of
passthru, the security context is propagated to the Java callout. This context is the message level context if defined (with WS-Security). Otherwise, it is the transport level context.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the log action to construct a message to be logged and to define a set of attributes with which it will be logged.
In the Message Flow Editor, click a log action to display its properties in the Properties view. Use these properties pages to configure the selected log action. The pages are:
The Log page has the following options:
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|||
|
Debug - While your application is under development, you might find it useful to create and use messages that provide verbose descriptions of low-level activity within the application.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In the Message Flow Editor, click a node or an action to display its properties in the Properties view. For most nodes and actions, one of the properties pages displayed (as a tab) is the Comment page. Use this page to add an optional comment about the item selected in the message flow.
In the Message Flow Editor, click a node or an action to display its properties in the Properties view. For most nodes and actions, one of the properties pages displayed (as a tab) is the Namespaces page. Use this page to see a list of defined namespaces or to create a new namespace.
In the Message Flow Editor, click a node or an action to display its properties in the Properties view. For many nodes and actions, one of the properties pages displayed (as a tab) is the Variables page. Use this page to see a list of all the predefined and user-defined context variables. Click Add to define a new variable.
For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a MFL (Message Format Language) transform action to convert message content from XML to non-XML, or vice versa, in the message pipeline. An MFL is a specialized XML document used to describe the layout of binary data. It is a BEA proprietary language used to define rules to transform formatted binary data into XML data, or vice versa.
In the Message Flow Editor, click a MFL transform action to display its properties in the Properties view. Use these properties pages to configure the selected MFL transform action. The pages are:
The MFL Transform page has the following options:
|
Click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor, where you can specify the variable.
|
|
|
Click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor, where you can specify the MFL resource that will perform the action, in the format project/folder/MFLresourcename.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use an operational branch node to configure branching based on operations defined in a WSDL.
When message flows define WSDL-based proxy services, operation-specific processing is required. Instead of configuring a branching node based on operations manually, ALSB provides a 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 plug-in presents those operations in the operational 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.
When you add an operational branch node to a message flow in the Message Flow Editor, the node contains an initial conditional branches based on the first operation defined in the WSDL, as shown below, plus a default branch:
Click the node itself (the Operational Branch Node icon or the bounding box connected to the icon) to display the Flow properties page in the Properties view. You can provide a name and a description for the node on that page.
Click an operational branch icon to display the properties for that operational branch on the Operational Branch page. That page contains a drop-down list of all the operations defined in the WSDL. You can select a different operation for that branch. You can also click the plus sign in the operational branch node, in the Message Flow Editor, to add another operation branch.
After you have added all the branches, add nodes and stages to them to define the processing for each branch.
In a message flow, use a pipeline pair node to define request and response processing.
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.
A pipeline pair always contains a request pipeline and a response pipeline. Add stages and actions to those pipelines, as needed.
In the Message Flow Editor, click a pipeline pair node to display its properties in the Properties view. Use this properties page to configure the selected pipeline pair node. The options are:
In a message flow, use a publish action to identify a statically specified target service for a message and to configure how the message is packaged and sent to that service.
In the Message Flow Editor, click a publish action to display its properties in the Properties view. Use these properties pages to configure the selected publish action. The pages are:
The Publish page has the following options:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a publish table action to publish a message to zero or more statically specified services. Switch-style condition logic is used to determine at run time which services will be used for the publish. A publish table action contains one or more case actions to define conditions for following alternative paths (by default, via publish actions), as well as a default path to a default publish action. To fully define a publish table action, you must configure the publish table action, its case actions, and its publish actions (and any other actions you may add).
When you add a publish table action to a message flow in the Message Flow Editor, the publish table action contains a case action with a path to a publish action plus a default case action with a path to a default publish action, as shown below. Click add condition to add another condition to the publish table.
In the Message Flow Editor, click the publish table action itself (the Publish Table icon or the bounding box connected to the icon) to display the Publish Tables properties page in the Properties view. Use these properties pages to configure the selected publish table action. The pages are:
The Publish Table properties page has the following option:
An XQuery expression, which at run time returns the value upon which the routing decision will be made.
To create or edit an XQuery expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In the Message Flow Editor, click a case action to display its properties in the Properties view. Use this properties page to configure the selected case action, as described below:
See Publish Action Properties.
In a message flow, use the raise error action to raise an exception with a specified error code (a string) and description.
In the Message Flow Editor, click a raise error action to display its properties in the Properties view. Use these properties pages to configure the selected raise error action. The pages are:
The Raise Error page has the following options:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the rename action to rename elements selected by an XPath expression without modifying the contents of the element.
In the Message Flow Editor, click a rename action to display its properties in the Properties view. Use these properties pages to configure the selected rename action. The pages are:
The Rename page has the following options:
|
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a replace action to replace a node or the contents of a node specified by an XPath expression. The node or its contents are replaced with the value returned by an XQuery expression.
A replace action can be used to replace simple values, elements and even attributes. An XQuery expression that returns nothing is equivalent to deleting the identified nodes or making them empty, depending upon whether the action is replacing entire nodes or just node contents.
In the Message Flow Editor, click a replace action to display its properties in the Properties view. Use these properties pages to configure the selected replace action. The pages are:
The Replace page has the following options:
|
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|||
The XQuery expression used to create the data that replaces the data specified by the XPath in the named variable.
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|||
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the reply action to specify that an immediate reply be sent to the invoker.
The reply action can be used in the request, response or error pipeline. You can configure it to result in a reply with success or failure. In the case of reply with failure where the inbound transport is HTTP, the reply action specifies that an immediate reply is sent to the invoker.
In the Message Flow Editor, click a reply action to display its properties in the Properties view. Use these properties pages to configure the selected reply action. The pages are:
The Reply page has the following options:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the report action to enable message reporting for a proxy service.
In the Message Flow Editor, click a report action to display its properties in the Properties view. Use these properties pages to configure the selected report action. The pages are:
The Report page has the following option:
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|
When you finish editing the XQuery expression, click Add a Key to add one or more key value pairs to be used to extract key identifiers from any message context variable or message payload. (The rest of the message is ignored.) The keys are a convenient way to identify a message.
|
For example, consider a report action configured on an error handler in a stage. The action reports the contents of the fault context variable in the event of an error. The report action is configured as follows:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the resume action to resume message flow after an error is handled by an error handler. This action has no parameters and can only be used in error pipelines.
In the Message Flow Editor, click a resume action to display its properties in the Properties view. Use these properties pages to configure the selected resume action. The pages are:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the route node to handle request and response dispatching of messages to and from business services. No other nodes can follow a route node.
In the Message Flow Editor, click a route node to display its properties in the Properties view. Use these properties pages to configure the selected route node. The pages are:
The Route page has the following option:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a routing action to identify a target service for the message and configure how the message is routed to that service.
This is a terminal action, which means you cannot add another action after this one. However, this action can contain request and response actions.
In the Message Flow Editor, click a routing action to display its properties in the Properties view. Use these properties pages to configure the selected routing action. The pages are:
The Routing page has the following option:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a routing options action to modify any or all of the following properties in the outbound request: URI, Quality of Service, Mode, Retry parameters, Message Priority.
In the Message Flow Editor, click a routing options action to display its properties in the Properties view. Use these properties pages to configure the selected routing options action. The pages are:
The Routing Options page has the following option:
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
|||
|
|||
|
To create or edit an expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a routing table to select different routes based upon the results of a single XQuery expression. A routing table action contains a set of routes wrapped in a switch-style condition table.
This is a terminal action, which means you cannot add another action after this one. However, this action can contain request and response actions.
When you add a routing table action to a message flow in the Message Flow Editor, the routing table action contains a case action with a path to a routing action plus a default case action with a path to a default routing action, as shown below. Click add condition to add another condition to the routing table.
In the Message Flow Editor, click the publish table action itself (the Publish Table icon or the bounding box connected to the icon) to display the Publish Tables properties page in the Properties view. Use these properties pages to configure the selected publish table action. The pages are:
The Routing Table properties page has the following option:
An XQuery expression, which at run time returns the value upon which the routing decision will be made.
To create or edit an XQuery expression, click <Expression> (or the expression_fragment, if one is already defined) to display the XQuery/XSLT Expression Editor.
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In the Message Flow Editor, click a case action to display its properties in the Properties view. Use this properties page to configure the selected case action, as described below:
See Routing Action Properties.
In the Message Flow Editor, click a service callout action to display its properties in the Properties view. Use these properties pages to configure the selected service callout action. The pages are:
The Service Callout page has the following options:
Subsequent configuration options depend on the kind of service you selected in step 3 and on the kind of configuration options you chose for that service in step 5. Table 3-1 shows the options available for each service type.
|
||
The following table provides instructions for each of the options listed in the table above.
Optionally, add one or more transport header actions. For more information about transport header actions, see Transport Headers Action Properties
| Note: | In addition to the transport headers you specify, headers are added by the ALSB binding layer. |
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use the skip action to specify that at run time, the execution of the current stage is skipped and the processing proceeds to the next stage in the message flow. This action has no parameters and can be used in the request, response or error pipelines.
In the Message Flow Editor, click a skip action to display its properties in the Properties view. Use these properties pages to configure the selected skip action. The pages are:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a stage node as a container for actions in a message flow. You can string multiple stages together, to compartmentalize processing logic.
In the Message Flow Editor, click a stage node to display its properties in the Properties view. Use these properties pages to configure the selected stage node. The pages are:
The Stage page has the following options:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a transport header action to set header values in messages.
In the Message Flow Editor, click a transport headers action to display its properties in the Properties view. Use these properties pages to configure the selected transport headers action. The pages are:
The Transport Header page has the following options:
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In a message flow, use a validate action to validate elements selected by an XPath expression against an XML schema element or a WSDL resource. You can validate global elements only; ALSB does not support validation against local elements.
In the Message Flow Editor, click a validate action to display its properties in the Properties view. Use these properties pages to configure the selected validate action. The pages are:
The Validate page has the following options:
|
To create or edit the XPath expression, click <XPath> (or the XPath_fragment, if one is already defined) to display the XPath Expression Editor.
|
|
Use the Comment page to add a comment, if desired:
Use the Namespaces page to see a list of defined namespaces or to create a new one.
Use the Variables page to see a list of defined context variables or to create a new one. For more information about context variables, see Message Context in the AquaLogic Service Bus User Guide.
In ALSB, JAR resources can contain classes that depend on other classes in different JARs. Use the Modify JAR Dependencies page to add or remove referenced JAR resources. Use the Up and Down buttons to reorder the hierarchy (order of precedence) of referenced JARs. For more information, see JARs in Using the AquaLogic Service Bus Console.
The following editor and wizard are provided for working with SMTP servers:
Use this page to view the details of an SMTP server and edit the configuration, if required. For descriptions of the fields, see the New SMTP Server Resource wizard. For more information, see Editing SMTP Servers in Using the AquaLogic Service Bus Console.
Use this page to configure a new SMTP server resource. For more information, see Adding SMTP Servers in Using the AquaLogic Service Bus Console.
Use this page to configure a UDDI registry resource. This page is displayed in the New UDDI Registry Resource wizard and in the UDDI Configuration editor.
For more information, see UDDI in Using the AquaLogic Service Bus Console and UDDI in the AquaLogic Service Bus User Guide.
This view displays a hierarchical view, or outline, of a structured file that is currently open in the editor area. The contents of this view are editor-specific.
In ALSB, when the proxy service is editor is open and the Message Flow Editor is selected, the Outline view displays a hierarchical view of the nodes and actions in the message flow. When the Message Flow Editor is displayed, you can switch between the hierarchical view and a thumbnail view of the service, as described in the table below:
The following are provided for managing resources:
Use this page to associate one or more file extensions with an ALSB resource type.
Use this page to view resource dependencies. This view shows your current selection whether it is in the Project Explorer or the active editor.
Use this dialog to specify where to clone a project, as a new project or as a folder under a different project.
Use this dialog to select a resource, appropriate to the context, that has been created in or imported into the ALSB plug-in. When you click Browse from an editor or a wizard, this dialog displays the available resources that are appropriate for the context. The dialog has different names, depending on the type of resource displayed, for example, Select a WSDL, Select a MFL, Select an XML Schema, etc. In some cases, the dialog displays a hierarchical list of items contained in each resource. For example, the Select an XML Schema dialog lists elements and types defined in the schemas. The Select a WSDL dialog displays ports and bindings defined in the WSDLs.
In some cases, for example, the Select a WSDL dialog, you can click the Consume button to open the Service Consumption dialog, where you can consume services from the following resource types: AquaLogic Enterprise Repository, file system, UDDI, URI, workspace: consume a service residing in the current workspace.
Use this page to configure a service key provider resource. For more information, see Service Key Providers in Using the AquaLogic Service Bus Console.
Web Services Policy Framework (WS-policy) is an extensible XML-based framework that extends the configuration of a Web Service with domain specific security assertions and specifies the security requirements, expectations, and capabilities of the Web Service. In ALSB, one of the primary uses of WS-policy is configuring message-level security in proxy services and business services. For more information, see Custom WS-Policies in Using the AquaLogic Service Bus Console.
Use this page to select a name and location for a new WS-policy resource.
The following are provided for working with service accounts:
Use this wizard to create a new service account resource, as described in the following table.
|
For more information, see Service Accounts in Using the AquaLogic Service Bus Console.
Use this page to configure a service account resource, as described in the following table.
|
For more information, see Service Accounts in Using the AquaLogic Service Bus Console.
Use this to page to save a user name and password with the service account configuration. The service account encodes this user name and password in the outbound request. For more information, see Service Accounts in Using the AquaLogic Service Bus Console.
Use this to page to create a service account that maps the user name from one or more clients to user names and passwords that you specify. For more information, see Service Accounts in Using the AquaLogic Service Bus Console.
To map authorized clients to remote user names and passwords, in the Local User Name field, enter the name that identifies a client that has been authenticated on its inbound request.
If you have not already added this user in the Security Configuration module of the ALSB Console, do so before you use this mapping in a runtime environment. See
Adding Users in Using the AquaLogic Service Bus Console. ALSB lets you create a mapping for a non-existent local user, but the mapping will never match an authenticated user and will never be used.
|
|
The following editors help you to write expressions for use in services.
Use the XQuery/XSLT Expression editor to create variable structures, define user namespaces, use predefined message context variables to build inline XQuery expressions, build inline XQuery expressions manually, and select XQuery or XSLT resources for execution as inline XQueries.
For more information about using XQueries, see Working with Variable Structures in the AquaLogic Service Bus User Guide
The XQuery/XSLT Expression editor contains two panels, each containing three tabs.
Use the panel on the left to write or construct the expression. The panel contains these pages (tabs):
Use the tabs in the panel on the right to manage the variables, namespaces, and XQuery functions you can use to construct an XQuery or XSLT. The panel contains these pages (tabs):
Use the XPath Expression Editor to create an XPath expression, which is then inserted into the location from which you launched the editor.
The XPath Expression Editor contains these pages:
You can write an expression directly in the Expression text field, or you can drag variables from the Variable Structure page and drag XQuery functions from the XQuery Functions page to construct a valid XPath expression.
When you are finished constructing the expression, you can click Test to test the expression on a running server. Or click OK to insert the expression without testing it.
Use the Condition Editor to create an inline XQuery condition.
Use the panel on the left to write or construct the condition. The panel contains these tabs, each of which is described below:
Use the tabs in the panel on the right to manage the variables, namespaces, and XQuery functions you can use to construct a condition. The panel contains the following tabs. They are the same as the tabs in the right-hand panel of the XQuery/XSLT Expression Editor, and the following links display the help for those tabs in the XQuery/XSLT Expression Editor.
Use the Condition Builder page to build an inline condition. This page appears only in the Condition Editor.
Build an expression in the Condition Builder as follows:
This page appears on the XQuery/XSLT Expression Editor, the XPath Expression Editor, and the Condition Editor.
The Expression page contains a text field where you can build expressions by typing directly into the field or by dragging items from the Variable Structures page or the XQuery Functions page on the right side of the editor.
Click Test to test the expression in an ALSB domain on a running server. WebLogic Server is packaged with ALSB, so an installation of ALSB includes an embedded server you can use for testing purposes.
This page appears in the XQuery/XSLT Expression Editor only.
In the message flow of a proxy service, you can assign XQuery expressions to message context variables, assign if-then-else actions based on the Boolean result of an XQuery expression, insert the result of an XQuery expression at an identified place relative to an XPath expression, specify the message context that you want to log through XQuery expressions on context variables, and so on.
Use the XQuery Resource page to configure an XQuery transformation to be executed in the message flow of a proxy service.
This page appears in the XQuery/XSLT Expression Editor only.
Use the XSLT Resource tab to configure an XSLT transformation to be executed in the message flow of a proxy service.
This page appears in the XQuery/XSLT Expression Editor, the XPath Expression Editor, and the Condition Editor.
The Variable Structures page displays variables and their contents as trees. It includes the built-in message context variables attachments, body, header, outbound, and inbound, as well as any user-defined variables. It includes fault if the context of the expression is appropriate (htat is, in an error handler). The outbound variable is always listed; even though it is not valid in every context. If outbound is used in invalid contexts, it will be reported when validating.
Each variable structure mapping entry has a label and maps a variable or variable path to one or more structures. The scope of these mappings is a stage or a route node.
You can drag items from this page to the editor’s Expression page to insert them into the current expression. They are inserted as XPath expressions.
To define a new variable and add it to the variable structure tree, click Add to open the Add Variable Structure dialog.
For more information about working with variable structures, see Working with Variable Structures in the AquaLogic Service Bus User Guide
This page appears in the XQuery/XSLT Expression Editor, the XPath Expression Editor, and the Condition Editor.
The Namespace Definitions page lists default ALSB namespaces, variable namespaces, and user-defined namespaces. Click Add to define a new namespace, which is then added to the list of user-defined namespaces. To modify a user-defined namespace, select it in the list, then click Edit.
This page appears in the XQuery/XSLT Expression Editor, the XPath Expression Editor, and the Condition Editor.
The XQuery Functions page lists a set of standard XQuery functions, organized alphabetically and by type. You can drag functions from this page to the editor’s Expression page to insert them into the current expression. When you insert a function into an expression, placeholders are used for parameter values you must supply.
Use this dialog to define a variable and add it to the tree of variable structures in the Variable Structures page of the Expression Editors.
You create variable structures in this dialog to define the structure of a variable for design purposes. For example, it is easier to browse the XPath variable in the structure view rather than viewing the XML schema of the XPath variable. Variable structures do not create variables. Variables are created at runtime as the target of the assign action in the stage.
You can declare your own variable structures based on:
You can use this feature directly for all user-defined variables, as well as $inbound, $outbound, and $fault. However, you cannot use it directly to access XML attachments in $attachments, headers in $header, or documents and RPC parameters in $body, with one exception— you can use it directly to access documents and parameters in $body for request messages received by a WSDL proxy service.
When you create a variable structure based on XML types, MFLs, or service interfaces, you must enter the following information into the fields at the top of the page:
For more information about working with variable structures, see Working with Variable Structures in the AquaLogic Service Bus User Guide
Transformation maps describe the mapping between two data types. eXtensible Stylesheet Language Transformation (XSLT) maps describe XML-to-XML mappings. For more information, see XSL Transformations in Using the AquaLogic Service Bus Console.
Use this page to select a name and location for a new XSL transformation. This wizard creates a skeleton for the XSLT. Add details in the XSLT editor.
The following sections describe the fields and user interface components involved with creating and configuring Split-Joins in ALSB.
The Split-Join Design Palette lists all the controls you can use to construct a Split-Join. To insert a control into a Split-Join, drag the icon from the palette to the Split-Join editor. When you drag an item to the editor, one or more circles (drag-points) appear (
) to indicate that you can drop the dragged item in that position on the editor. When you drag the item into such a circle, it is highlighted () to show that you can drop the item there.
The Split-Join Design palette is organized into the following categories:
The following table describes the controls you can add to a Split-Join:
Invoke Service invokes a WSDL-based, non-transport-typed Business Service or a WSDL-based Proxy Service.
For configuration properties, see Split-Join Properties View - Invoke External Service.
|
|
|
For configuration properties, see Split-Join Properties View - Reply Page.
|
|
|
For configuration properties, see Split-Join Properties View - Parallel.
|
|
|
For configuration properties, see Split-Join Properties View - For Each.
|
|
|
For configuration properties, see Split-Join Properties View - If Activity.
|
|
Raise Error generates an error that causes the Split-Join to stop normal processing. If the error is not handled using an Error Handler, the Split-Join will terminate and a Fault will be sent to the ALSB Message Flow.
For configuration properties, see Split-Join Properties View - Raise Error Page.
|
|
|
For configuration properties, see Split-Join Properties View - Assign.
|
|
Use this properties page to review and configure the selected Error Handler in a Split-Join.
The Error Handler receives and handles all of the errors that are raised in a Split-Join.
The catchAll tab has the following options.
Use this properties page to review and configure the selected External Services (business and proxy services) invoked from the Split-Join.
Use External Services to call Services outside of the context of the Split-Join.
When you select External Service, a dashed blue line appears pointing to the Invoke Service associated with the service.
Use this properties page to review and configure the selected Assign in an Split-Join.
Use Assign for data manipulation, including initializing and updating a Variable.
The Assign tab has the following options:
|
|
To create an Assign operation, select Assign from the Add Button to launch the Assign Operation Dialog. To create a Copy operation, select Copy from the Add Button to launch the Copy Literal/XPath 1.0 Expression Dialog. To create a Delete operation, select Delete from the Add Button to launch the Delete Action Dialog. To create an Insert operation, select Insert from the Add Button to launch the Insert Action Dialog. To create a Replace operation, select Replace from the Add Button to launch the Replace Action Dialog |
The General tab has the following options:
Use this properties page to review and configure the Global Properties of the selected Split-Join.
The initial node in a Split-Join specifies its Global Properties. Among these properties, Global Variables and associated External Services can be reviewed and configured by expanding the left-side arrow. The global Error Handler can be reviewed and configured by expanding the right-side arrow.
The Imports tab has the following options:
The General tab has the following options:
Use this properties page to review and configure the selected For Each in a Split-Join.
For Each executes logic configured within its Scope a specified number of times.
The For Each tab has the following options:
Defines an implicit variable within the Scope of the For Each. Each iteration of the For Each contains an isolated instance of this variable. In turn, every instance is set to an iteration number; for example, the first iteration has its value set to Start Counter Value, the second iteration to Start Counter Value+1, etc. |
|
The value of the Counter Variable for the first iteration of For Each. Determined as the result of an XPath 1.0 expression. The result must be “1” or more. (“0” is not a valid Start Counter Value.) The browse button launches the Copy Literal/XPath 1.0 Expression Dialog. The built Expression should generate an integer for the initial Start Count Value. |
|
The value of the Counter Variable for the final iteration of For Each. Determined as the result of an XPath 1.0 expression. The result must be “1” or more. (“0” is not a valid Start Counter Value.) The browse button launches the Copy Literal/XPath 1.0 Expression Dialog. The built expression should generate an integer for the Final Count Value. |
The General tab has the following options:
Use this properties page to review and configure the selected If in a Split-Join.
Use If to provide conditional behavior within an Split-Join.
Use this properties page to review and configure the selected If or Else If in an Split-Join.
The If and Else If controls provide conditional behavior within an Split-Join.
Define an XPath 1.0 expression that evaluates to true or false. If the condition evaluates to true, the associated If/Else If branch is executed.
Click the browse button to launch the Copy Literal/XPath 1.0 Expression Dialog.
|
Use this properties page to review and configure the selected Invoke External Service in a Split-Join.
Use Invoke External Service to invoke a WSDL-based, non-transport-typed Business Service or a WSDL-based Proxy Service.
The Operation tab has the following options:
|
Browse to select an operation from the Service Browser.
|
|
The Input Variable tab has the following options:
|
|||
The Output Variable tab has the following options:
|
|||
The General tab has the following options:
Use this properties page to review and configure the selected Parallel in a Split-Join.
Parallel creates a fixed number of configured parallel branches.
Use this properties page to review and configure the selected Raise Error in an Split-Join.
Raise Error establishes an error condition under which the execution of the process will halt.
Use this properties page to review and configure the selected Receive in a Split-Join.
The Operation tab has the following options:
|
Browse to select an operation from the WSDL Browser.
|
The Variable tab has the following options:
|
|||
The General tab has the following options:
Use this properties page to review and configure the selected Reply in a Split-Join.
Reply sends a response or fault back to the ALSB message flow.
The Operation tab has the following options:
The Variable tab has the following Select options:
|
|||
|
|||
The General tab has the following options:
Use this properties page to review and configure the selected Scope in a Split-Join.
The Scope creates a context which influences the behavior of its enclosed controls. Local variables and the Error Handler defined within the Scope are restricted to this context.
Use this properties page to review and configure the Start Node in a Split-Join.
The Start Node contains global variables and imports introspected from the WSDL Operation. It can also have an associated global Error Handler.
The Imports tab has the following options:
The General tab has the following options:
Use this properties page to review and configure Variables in the selected Split-Join.
Click to display the Create/Edit Variable Dialog, where you can modify the Variable’s name and type.
|
Use this dialog to create an Assign Operation for use in an Assign.
A variable to which the result of the XQuery expression is assigned. Only previously defined Variables, the Counter Variable, and SOAP Fault Variables (for Error Handlers) are available. |
Use this dialog to create a Copy Operation for use in an Assign.
Use this dialog to create a Counter Variable.
Use this dialog to review and/or configure Variables in the Split-Join.
Use this dialog to create a new Variable.
Use this dialog to create a Delete Action for use in an Assign.
Use this dialog to create an Insert Action for use in an Assign.
The location used to control where the Insert Action is performed relative to the result of the XPath 1.0 Expression. Options include:
|
|
|
Click on the Xpath to launch the
XPath Expression Editor.
|
|
Use this dialog to create a Replace Action for use in an Assign.
|
Click on the XPath to launch the
XPath Expression Editor.
|
|
Specifies that the nodes selected by the XPath 1.0 expression defined above are replaced along with all of its contents. |
|
Use this page to locate and name the new Split-Join
Use this page to select an operation for the new Split-Join.
Use this dialog to browse for and select an operation from a Business or Proxy Service in the depicted tree.
Use this dialog to create a SOAP fault variable.
Use this dialog to browse for and select an operation from a WSDL in the depicted tree.
|
