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