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/ |