Ce bean géré représente la source d'une collection d'objets Crystal Enterprise unique telle que des rapports, 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.
CorporateCategory
La principale catégorie d'entreprise Crystal Enterprise est utilisée par l'élément parent pour rechercher des 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.
PersonalCategory
La principale catégorie personnelle Crystal Enterprise est utilisée par l'élément parent pour rechercher des objets.
RootFolder
Le dossier racine dans le système Crystal Enterprise est utilisé comme élément parent afin de rechercher des objets.
UserRootCategory
La catégorie racine de l'utilisateur final sert d'élément parent.
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 de rapports 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.Category
CrystalEnterprise.Analytic
CrystalEnterprise.Excel
CrystalEnterprise.FavoritesFolder
CrystalEnterprise.Folder
CrystalEnterprise.Hyperlink
CrystalEnterprise.MyInfoView
CrystalEnterprise.ObjectPackage
CrystalEnterprise.PersonalCategory
CrystalEnterprise.Pdf
CrystalEnterprise.Program
CrystalEnterprise.Report
CrystalEnterprise.Rtf
CrystalEnterprise.Shortcut
CrystalEnterprise.Txt
CrystalEnterprise.Webi
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 rapports 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 rapports 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 propriétés permettant de spécifier le tri des éléments de la collection dans le bean EnterpriseItems
. La propriété sortField
de la classe SortProps
spécifie le champ selon lequel les éléments de la collection sont triés, et la propriété sortDirection
de la classe SortProps
spécifie 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 propriétés 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 la propriété pageSize
. La valeur par défaut affiche dix éléments à la fois sur une page. La propriété rangeSize
spécifie 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 : Pour obtenir une référence exhaustive de tous les membres du bean EnterpriseItems
, voir l'interface IEnterpriseItems
de la référence API Java des composants JavaServer Faces for Crystal Enterprise.
<managed
<description>Source for a collection of folders.</description>
<managed
<managed
com.businessobjects.jsf.appcontrols.model.EnterpriseItems
</managed
<managed
<managed
<property
<value>0</value>
</managed
</managed
Business Objects http://www.france.businessobjects.com/ Support technique http://www.businessobjects.com/services/support/ |