Overview

The Logon component allows you to create a form that is used to authenticate and log a user on to a Crystal Enterprise session. The basic information required is a user name and password that can be entered in two separate input fields. The text on the user name and password input field labels can be customized with the userNameText and passwordText attributes.

In addition to the general attributes of the component, there are attributes that must be set to property classes.

Note:    For more information on property classes, see How do I use property classes in combination with JavaServer Faces Components for Crystal Enterprise?

Event Handling

To enable the automatic event handling capabilities of the Logon component, set the autoHandleEvents attribute to true. When set to true, this attribute implements default behavior on action events that are triggered when the user interacts with the component. For example:

EventDefault Behavior

LogoffClicked

When the logoff button is clicked, the user is logged off Crystal Enterprise.

LogonClicked

When the logon button is clicked, the authentication information specified in the component is submitted to Crystal Enterprise and an attempt is made to log on.

If the autoHandleEvents attribute is set to false, these events will not be handled automatically. When autoHandleEvents is set to true, these events call the Logon component's submit method, which implements the default functionality. If you set autoHandleEvents to false, you may write your own event handler that calls the submit method to capture these other events.

Data Binding

Use the identity attribute to bind an Identity bean to the Logon component. An Identity bean supplies the end user authentication credentials that are required to log on to a Crystal Enterprise system.



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