Présentation

Le composant Path vous permet de créer une représentation visuelle, sous forme de jalons, du chemin allant d'un élément sélectionné, tel qu'un état, à son élément racine. Par exemple, vous pouvez utiliser ce composant lorsque l'utilisateur explore des dossiers et sous-dossiers à la recherche d'un état à afficher ou à planifier. Dans cet exemple, le chemin peut être affiché et mis à jour visuellement lorsque l'utilisateur redescend la hiérarchie des dossiers montrant comment le dossier racine amène au premier sous-dossier amenant lui-même au second sous-dossier et ainsi de suite jusqu'à l'état.

Les attributs rootItemID et rootText sont les deux attributs clés qui détermine le premier nœud du chemin. Définissez l'attribut rootItemID selon l'identificateur de l'élément qui s'affichera comme élément racine (premier) du chemin. La valeur définie pour cet attribut crée une limite supérieure permettant de parcourir la hiérarchie des éléments Crystal Enterprise. Le texte représentant cet élément supérieur dans le chemin peut être personnalisé à l'aide de l'attribut rootText.

Utilisez l'attribut repeatDirection pour spécifier si l'utilisateur peut visualiser le chemin de gauche à droite, en définissant l'option horizontal, ou de haut en bas, en définissant l'option vertical. L'attribut repeatDirection doit être défini selon les champs de la classe com.businessobjects.jsf.sdk.properties.RepeatDirection. Utilisez l'attribut separatorText pour spécifier les caractères à utiliser pour séparer les éléments du chemin. Par exemple, vous pouvez créer une flèche ("->") pour représenter le chemin conduisant d'un élément au suivant. Par défaut, cet attribut est défini sur le caractère supérieur à (">"). L'attribut showSelectedItem peut être défini pour afficher ou masquer l'élément sélectionné comme dernier élément du chemin. Par défaut, cet attribut est défini sur true. S'il est défini sur false, l'élément parent de l'élément sélectionné apparaît comme le dernier élément du chemin.

Outre les attributs généraux du composant, l'attribut showImages accède à la classe ImagesProps contenant d'autres propriétés :

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 personnaliser l'apparence du composant Path , définissez les attributs de style des différentes parties du composant.

Attribut Style Description Classe de styles

itemStyle

Style de tous les éléments du chemin.

Nom de chaîne de la classe de styles définie dans une feuille de style et associée à partir d'une page JSP.

selectedItemStyle

Style d'un élément sélectionné de façon individuelle.

Nom de chaîne de la classe de styles définie dans une feuille de style et associée à partir d'une page JSP.

separatorStyle

Style des caractères qui séparent des éléments individuels du chemin.

Nom de chaîne de la classe de styles définie dans une feuille de style et associée à partir d'une page JSP.

Gestion des événements

Pour activer les fonctionnalités de gestion automatique des événements du composant Path, définissez l'attribut autoHandleEvents sur true. Lorsqu'elle est définie 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 :

Événement Comportement par défaut

ItemClicked

Lorsque l'utilisateur clique sur un élément du composant, le bean EnterpriseItem ou EnterpriseItems associé aux données est défini pour afficher les éléments sous l'attribut parentItemID spécifié pour cet élément.

Si l'attribut autoHandleEvents est défini sur false, cet événement n'est pas géré.

Liaison de données

Le composant Path prend en charge la liaison des données à un bean EnterpriseItem ou EnterpriseItems. Ces beans fournissent la source de l'élément ou des éléments à afficher du composant Path. Utilisez l'attribut itemSource pour lier le composant au bean souhaité.


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