CommandBar component: Tag definitions

The Business Process Choreographer Explorer CommandBar component displays a bar with buttons. These buttons operate on the object in a details view or the selected objects in a list.

The CommandBar component consists of the JSF component tags: bpe:commandbar and bpe:command, the bpe:command tag is a subelement of the bpe:commandbar tag.

Component class

com.ibm.bpe.jsf.component.CommandBarComponent

Example syntax

<bpe:commandbar model="#{TaskInstanceList}">

    <bpe:command
       commandID="Work on"
       label="Work on..."
       commandClass="com.ibm.bpc.explorer.command.WorkOnTaskCommand"
       context="#{TaskInstanceDetailsBean}"/>

    <bpe:command
       commandID="Cancel"
       label="Cancel"
       commandClass="com.ibm.task.clientmodel.command.CancelClaimTaskCommand"
       context="#{TaskInstanceList}"/>

</bpe:commandbar>

Tag attributes

Table 1. bpe:commandbar attributes
Attribute Required Description
model yes A value binding expression to a managed bean that implements the ItemProvider interface. This managed bean is usually the com.ibm.bpe.jsf.handler.BPCListHandler class or the com.ibm.bpe.jsf.handler.BPCDetailsHandler class that is used by the List component or Details component in the same JavaServer Pages (JSP) file as the CommandBar component.
styleClass no The cascading style sheet (CSS) style for rendering the bar.
buttonStyleClass no The CSS style for rendering the buttons in the command bar.
Table 2. bpe:command attributes
Attribute Required Description
commandID yes The ID of the command.
commandClass yes The command class that is triggered.
action no A JavaServer Faces (JSF) action method that has the signature: String method(). The value that is returned by the action method, or that is directly specified as a literal overrides the target returned by the execute method of the command. The action attribute is not processed if the command throws an exception other than an ErrorsInCommandException exception.

If this attribute is specified as an outcome string, it defines an outcome used by the JSF navigation handler to determine the navigation rule and the next page to display.

If this attribute is specified as a method binding (#{.....}), the method to be called has the signature String method(). Its return value is used by the JSF navigation handler to determine the navigation rule and the next page to display.

label yes The label of the button that is rendered in the command bar.
styleClass no The CSS style for rendering the button. This style overrides the button style defined for the command bar.
context no A value binding expression, which refers to a managed bean. Use this attribute if the command needs to initialize the target page or bean.

Terms of use |

Last updated: Thu Apr 27 14:54:56 2006

(c) Copyright IBM Corporation 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)