Le composant ItemsGrid affiche les champs d'une source de l'élément, tel un report, sous forme de colonnes d'un tableau. Chaque ligne du composant ItemsGrid représente un enregistrement de la source de l'élément. Le composant ItemsGrid permet aux utilisateurs de sélectionner des éléments individuels, de parcourir de grands ensembles d'éléments et de trier des éléments par colonne. Chaque colonne du composant ItemsGrid représente un composant ItemsColumn individuel.
Les composants defaultRoot et rootItemID sont deux attributs clés qui déterminent l'élément de niveau supérieur qui peut être recherché dans le composant ItemsGrid. L'attribut defaultRoot sert à spécifier le nœud racine de la hiérarchie des éléments du composant ItemsGrid. La valeur définie pour cette propriété crée une limite supérieure permettant de parcourir la hiérarchie des éléments Crystal Enterprise. Les valeurs possibles sont des champs de la classe com.businessobjects.jsf.sdk.properties.DefaultRootType :
Aucune
La racine du composant ItemsGrid est définie sur la racine par défaut de l'arborescence de dossiers dans le système Crystal Enterprise.
Personnalisé
Une racine personnalisée, spécifiée par l'attribut rootItemID, est utilisée comme racine du composant ItemsGrid. Définissez l'attribut rootItemID sur l'identifiant du dossier qui servira d'élément racine dans la grille.
UserRootFolder
Pour positionner le composant ItemsGrid sur la page, définissez l'attribut horizontalAlign sur la valeur souhaitée. Les attributs showHeader, showImages et showDrillUpLink peuvent servir à personnaliser l'apparence générale du composant ItemsGrid. Par défaut, l'attribut showHeader est défini sur true, et affiche une étiquette de texte d'enshowImages doit être défini selon les champs de la classe com.businessobjects.jsf.sdk.properties.Image. Par défaut, l'attribut est défini sur None, mais vous pouvez cependant le modifier pour afficher une représentation sous forme d'icône ou de miniature à côté de chaque élément de la grille. Pour en savoir plus sur l'affichage des icônes, voir Comment afficher des images dans le composant ItemsGrid ?.
L'attribut showDrillUpLink spécifie l'affichage d'un lien permettant à l'utilisateur de parcourir la hiérarchie des éléments vers le haut. Cet attribut est défini sur true par défaut.
Il existe également de nombreux attributs vous permettant de personnaliser l'affichage des informations dans le composant ItemsGrid. Par défaut, l'attribut allowSorting est défini sur false, empêchant ainsi l'utilisateur de trier les éléments. Définissez cet attribut sur true pour afficher un lien de tri permettant à l'utilisateur de trier la liste des éléments (lignes) de la grille. Seuls certains champs (colonnes) sont optimisés et recommandés pour le tri :
Pour aider l'utilisateur à distinguer rapidement les lignes et les colonnes, vous pouvez spécifier le type de lignes de grille affiché à l'aide de l'attribut showGridLines. Cet attribut doit être défini selon les champs de la classe com.businessobjects.jsf.sdk.properties.GridLines. Par défaut, cette propriété est définie sur Both ; définissezHorizontal pour afficher des lignes séparant les lignes de la grille, sur Vertical pour séparer les colonnes ou sur None pour masquer toutes les lignes. De plus, l'attribut allowDrillDown gère le comportement des éléments de la grille et permet à la grille d'explorer de façon dynamique le contenu d'un élément lorsque l'utilisateur clique sur cet élément. Cette propriété est définie sur true par défaut.
Les colonnes individuelles de la grille peuvent être également personnalisées en sélectionnant un sousItemsColumn et en définissant des valeurs d'attributs. Voir Attributs des balises (itemsColumn) pour plus de détails sur les attributs ItemsColumn. Pour en savoir plus sur la manipulation du composant dans le concepteur visuel, voir Comment manipuler les colonnes dans le composant ItemsGrid ?
Remarque : Seuls les champs spécifiés par la propriété fields du bean EnterpriseItem ou EnterpriseItems devraient être définis à l'aide de l'attribut fields du composant ItemsColumn. Ces informations doivent être consultées à partir de Crystal Enterprise afin que le composant ItemsGrid puisse remplir la colonne correspondante. Pour en savoir plus sur les champs, voir Bean EnterpriseItem.
Outre les attributs généraux du composant, d'autres attributs doivent être définis selon des classes de propriétés.
alerts
L'attribut alerts permet d'accéder à des instances de la classe AlertProps contenant des propriétés permettant de spécifier le moment et la façon dont les éléments d'alerte s'affichent dans le composant ItemsGrid. Par défaut, la propriété visible est définie sur true et le composant ItemsGrid affiche des alertes. Définissez cette propriété sur false pour supprimer des alertes. Lorsqu'une alerte se produit, l'utilisateur reçoit une image le prévenant de cette alerte. Définissez la propriété imageUrl selon l'emplacement de l'image à afficher. Par défaut, les sousshowAlertMessage et showAlertTime sont définies sur true, et affichent une description de l'alerte et l'heure à laquelle l'alerte s'est produite, respectivement. Définissez ces propriétés sur false pour masquer ces informations.
Remarque : Si des alertes sont activées, vous devez renvoyer les informations de traitement pour les éléments représentés par les données du bean EnterpriseItems associées à ce contrôle. Cette opération s'effectue en sélectionnant SI_PROCESSINGINFO comme valeur de la propriété fields du bean.
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 ItemsGrid, définissez les attributs de style des différentes parties du contrôle.
Pour activer les fonctionnalités de gestion automatique des événements du composant ItemsGrid, définissez la propriété autoHandleEvents sur true. Lorsqu'elle est définie sur true, cette propriété applique un comportement par défaut aux événements déclenchés lorsque l'utilisateur se sert du composant. Par exemple :
Si la propriété autoHandleEvents est définie sur false, ces événements ne sont pas gérés.
Le composant ItemsGrid 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 dans les lignes du composant ItemsGrid. 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/ |