Le composant Logon vous permet de créer un formulaire utilisé pour authentifier et connecter un utilisateur à une session Crystal Enterprise. Les informations de base requises, un nom d'utilisateur et un mot de passe, peuvent être saisies dans deux champs distincts. Le texte des étiquettes des champs de saisie du nom d'utilisateur et du mot de passe peut être personnalisé à l'aide des attributs userNameText et passwordText.
Outre les attributs généraux du composant, d'autres attributs doivent être définis selon des classes de propriétés.
authentication
L'attribut authentication permet d'accéder à des instances de la classe AuthenticationProps contenant deux propriétés : visible et text. Par défaut, la propriété visible est définie sur true, et un champ de saisie d'un alias de groupe d'utilisateurs apparaît sur le formulaire. Il peut s'agir d'un alias de groupe d'utilisateurs Enterprise ou de fournisseur d'authentification tiers comme Windows NT, Windows AD ou LDAP. Le texte de l'étiquette du champ de saisie de l'authentification peut être également défini à l'aide de la propriété text. Si la propriété visible est définie sur false, le champ de saisie de l'authentification n'apparaît pas.
logoffButton et logonButton
Les attributs logoffButton et logonButton permettent d'accéder à des instances de la classe SubmitButtonProps contenant des propriétés qui déterminent l'affichage des boutons de connexion et de déconnexion. Le bouton affiché varie selon le statut du composant. Ces attributs fonctionnent de la même manière que l'attribut submitButton décrit à la section Attributs de composant communs.
system
L'attribut system permet d'accéder à des instances de la classe SystemProps contenant des propriétés similaires à celles de la classe AuthenticationProps. Par défaut, la propriété visible est définie sur true, et un champ de saisie du système apparaît sur le formulaire. Ce champ sert à saisir le nom du système Crystal Enterprise auquel accéder. Lorsque le champ de saisie du système est visible, vous pouvez définir la propriété readOnly afin de déterminer l'affichage du contenu du champ de saisie. Si cet attribut est défini sur true, le nom du système Crystal Enterprise est désactivé et le champ ne peut pas être modifié par l'utilisateur. Si cet attribut est défini sur false, l'utilisateur peut modifier le nom du système. Le texte de l'étiquette du champ de saisie du système peut être également défini à l'aide de la propriété text. Si la propriété visible est définie sur false, le champ de saisie du système n'apparaît pas.
Remarque : Pour en savoir plus sur les classes de propriétés, voir Comment utiliser des classes de propriétés combinées à des Composants JavaServer Faces pour Crystal Enterprise ?
Pour activer les fonctionnalités de gestion automatique des événements du composant Logon, définissez l'attribut autoHandleEvents sur true. Lorsqu'il est défini sur true, cet attribut applique un comportement par défaut aux événements déclenchés lorsque l'utilisateur se sert du composant. Par exemple :
Si l'attribut autoHandleEvents est défini sur false, ces événements ne sont pas gérés. Lorsque l'attribut autoHandleEvents est défini sur true, ces événements appellent la méthode submit du composant Logon qui exécute la fonctionnalité par défaut. Si vous définissez l'attribut autoHandleEvents sur false, vous pouvez créer votre propre gestionnaire d'événements qui appelle la méthode submit afin de capturer les autres événements.
Utilisez l'attribut identity pour lier un Bean Identity au composant Logon. Un bean Identity fournit à l'utilisateur final les informations d'authentification nécessaires à la connexion à un système Crystal Enterprise.
| Business Objects http://www.france.businessobjects.com/ Support technique http://www.businessobjects.com/services/support/ |