Ce bean géré représente la source d'une collection d'objets Crystal Enterprise unique telle que des états, des dossiers ou des programmes. Ce bean fournit des informations et ajoute des fonctionnalités aux composants d'interface utilisateur.
Pour en savoir plus sur les fonctionnalités Crystal Enterprise de base et le développement d'applications, consultez le Crystal Enterprise Java SDK Guide.
Cliquez sur l'un des liens ci
Le bean EnterpriseItems constitue la source d'une collection d'objets Crystal Enterprise et sert à représenter une collection d'objets sur la page. Les collections sont interrogées à partir du système Crystal Enterprise à l'aide de chaînes de requête dans le code
Les propriétés enableDefaultParent et parentItemID constituent les deux propriétés clés qui déterminent l'élément parent utilisé lors de l'interrogation des objets. Les valeurs possibles de la propriété enableDefaultParent sont des champs de la classe com.businessobjects.jsf.sdk.properties.DefaultParentType :
Aucune
L'objet racine par défaut dans le système Crystal Enterprise est utilisé comme élément parent afin d'interroger les objets.
Personnalisé
Un élément parent custom, spécifié par la propriété parentItemID, est utilisé comme élément parent. Définissez la propriété parentItemID selon l'identificateur de l'élément qui servira d'élément parent pour l'interrogation des objets.
UserRootFolder
Le dossier racine de l'utilisateur final sert d'élément parent.
La propriété parentItemID spécifie l'ID ou le CUID du parent de tous les objets de la collection à interroger. Cette propriété peut être définie de plusieurs façons. Par exemple, vous pouvez définir la propriété parentItemID par programmation selon la valeur de la propriété itemID d'un dossier lorsque l'utilisateur clique sur un dossier d'une liste. Cet ID peut ensuite servir à interroger une collection d'états dans ce dossier parent.
La propriété fields définit les champs de la base de données que vous souhaitez interroger. Voir Bean EnterpriseItem pour obtenir une description complète de cette propriété et de ses valeurs.
Définissez la propriété itemTypes selon un ou plusieurs types d'objets Crystal Enterprise que vous souhaitez interroger et renvoyer dans la collection. Voici des exemples de chaînes (ProgID) valides :
All
CrystalEnterprise.Report
CrystalEnterprise.Excel
CrystalEnterprise.FavoritesFolder
CrystalEnterprise.Folder
CrystalEnterprise.Hyperlink
CrystalEnterprise.ObjectPackage
CrystalEnterprise.Pdf
CrystalEnterprise.Program
CrystalEnterprise.Rtf
CrystalEnterprise.Shortcut
CrystalEnterprise.Txt
CrystalEnterprise.Word
Par exemple, "All" renvoie tous les champs, tandis que {"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"} renvoie uniquement les éléments représentant des états Crystal, des fichiers PDF ou des fichiers texte.
Remarque : Pour en savoir plus sur les ProgID de Crystal Enterprise, voir le Crystal Enterprise Java SDK Guide.
Les propriétés searchFields et searchText doivent être utilisées ensemble pour effectuer une recherche par caractères génériques sur le système Crystal Enterprise. Définissez la propriété searchFields selon le champ que vous souhaitez rechercher, puis définissez la propriété searchText selon le texte correspondant. Par exemple, définissez la propriété searchFields sur Name et la propriété searchText sur World Sales Report pour rechercher les états intitulés "World Sales Report". Seuls certains champs sont optimisés et recommandés pour la recherche :
Plusieurs autres propriétés gèrent des aspects spécifiques de l'interrogation de collections d'objets. Définissez la propriété filterByOwner sur true pour interroger les éléments appartenant à l'utilisateur. Par défaut, cette propriété est définie sur false. La propriété instances détermine les instances incluses dans la collection d'objets renvoyée et définie selon le bean EnterpriseItems. Cette propriété doit être définie selon les champs de la classe com.businessobjects.jsf.sdk.properties.InstanceFilter : le champ IncludeInstances, qui inclut des instances dans les résultats de l'interrogation; le champ ExcludeInstances, qui exclut des instances des résultats de l'interrogation, et l'attribut InstancesOnly qui renvoie une collection contenant uniquement des instances d'objets.
Outre les attributs généraux du bean, deux propriétés permettent d'accéder aux classes contenant d'autres propriétés :
sortBy
La propriété sortBy extrait ou définit une instance d'une classe SortProps contenant des méthodes permettant de spécifier le tri des éléments de la collection dans le bean EnterpriseItems. Les méthodes getSortField et setSortField de la classe SortProps spécifient le champ selon lequel les éléments de la collection sont triés, et les méthodes getSortDirection et setSortDirection de la classe SortProps spécifient si les éléments sont triés par ordre alphanumérique croissant ou décroissant.
Remarque : Le composant ItemsGrid détermine les valeurs de la propriété de tri d'un bean EnterpriseItems lié au composant. Vous ne devez pas modifier manuellement ces valeurs pour un bean EnterpriseItems lors de la conception s'il est associé à un composant ItemsGrid.
paging
La propriété paging extrait ou définit une instance d'une classe PagingProps contenant des méthodes permettant de spécifier comment un utilisateur peut parcourir les listes d'éléments représentées par le bean EnterpriseItems. Par défaut, la pagination est désactivée. Pour activer la pagination et permettre à l'utilisateur de parcourir les pages d'éléments, utilisez la méthode setEnabled de la classe PagingProps à l'aide d'un argument true. Le nombre d'éléments présentés à l'utilisateur sur chaque page est déterminé par les méthodes getPageSize et setPageSize. La valeur par défaut affiche dix éléments à la fois sur une page. Les méthodes getRangeSize et setRangeSize spécifient le nombre de pages définissant une plage de pages. Par exemple, si la méthode setRangeSize est utilisée comme un argument de 10 et que le bean EnterpriseItems est lié à un composant ItemsGrid, l'utilisateur peut alors sélectionner de façon individuelle les pages 1 à 10 et les parcourir à l'aide des boutons de numéro de page situés en bas de la grille. Si l'utilisateur clique sur le bouton de la plage de pages suivante, les boutons de numéro des pages 11 à 20 peuvent être sélectionnés.
Remarque : Le composant ItemsGrid détermine les valeurs de la propriété de pagination d'un bean EnterpriseItems lié au composant. Vous ne devez pas modifier manuellement ces valeurs pour un bean EnterpriseItems lors de la conception s'il est associé à un composant ItemsGrid.
Remarque : Pour obtenir une référence exhaustive de tous les membres du bean EnterpriseItems, voir l'interface EnterpriseItems de la référence API Java deCrystal Reports pour Rational Application Developer.
<description>Source d'une collection de dossiers.</description>
<managed
com.businessobjects.jsf.appcontrols.model.EnterpriseItems
<managed
<property
| Business Objects http://www.france.businessobjects.com/ Support technique http://www.businessobjects.com/services/support/ |