Common component attributes

Several attributes are common to more than one of the JSF component tags and need to be set to similar values. The attributes listed in the table apply to more than one component:

autoHandleEvents

The component tags that contain the autoHandleEvents attribute are:

  • changePassword
  • itemsGrid
  • logon
  • path

When set to true, the default event handler for the component is invoked after specific client-side actions. By default, this attribute is set to true.

Each component has out-of-the-box business logic that executes automatically when the autoHandleEvents attribute is set to true. This enables you to rapidly and easily create a BusinessObjects Enterprise web application.

In that case, client-side interaction with components, when they trigger certain action events, are handled automatically on the server.

The individual behavior of these event handlers implemented by each component is explained in the appropriate JSF components section.

When the autoHandleEvents attribute is set to false, events triggered by client-side interactions with the component, such as when the user clicks a button or a link, result in no behavior of the components on the server-side. In that case, you can implement custom event handlers in the code-behind. You can then connect those handlers to the appropriate event, to perform the desired business logic.

identity

The component tags that contain the identity attribute are:

  • changePassword
  • logon

Specifies the authentication credentials and session information to be data bound to the component. The Identity bean specified by this attribute represents a particular set of user credentials to be associated with a user performing actions on the client-side. Hence, this bean encapsulates the identity of the user.

itemSource

The component tags that contain the itemSource attribute are:

  • itemsGrid
  • path

Specifies the item, or set of items, such as a report, folder, or report instance, to be data bound to the component. The components take an EnterpriseItem bean or an EnterpriseItems bean as an itemSource attribute value.

labelAlignment

The component tags that contain the labelAligment attribute are:

  • changePassword
  • logon

Specifies the alignment of all labels in the component. The possible values are fields of the com.businessobjects.jsf.sdk.properties.HorizontalAlign class:

  • Center
  • Justify
  • Left
  • NotSet
  • Right

submitButton

The component tags that contain the submitButton attribute, or contains attributes that inherit from the same SubmitButton class are:

  • changePassword
  • logon

The submitButton attribute accesses instances of the SubmitButton class, which contains the alignment, imageUrl, text, type, and visible properties.

The alignment property specifies the horizontal alignment of the submit button relative to the input fields of the component. The possible values are fields of the com.businessobjects.jsf.sdk.properties.HorizontalAlign class:

  • Center
  • Justify
  • Left
  • Not Set
  • Right

The type property specifies the kind of button used for the submission action of the component. The possible values are fields of the com.businessobjects.jsf.sdk.properties.ButtonType class:

  • Button
  • ImageButton
  • LinkButton

The text property specifies the text that is displayed on the submit button that is of type Button or LinkButton, or the text that is displayed as the tooltip of the submit button that is of type ImageButton.

The imageUrl property specifies the url of the image to display as a button of type ImageButton.

The visible property can be set to show or hide the button.



Business Objects
http://www.businessobjects.com/
Support services
http://www.businessobjects.com/services/support/