Ce bean géré représente la source d'une collection d'objets BusinessObjects 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 BusinessObjects Enterprise de base et le développement d'applications, consultez le Guide du SDK Java BusinessObjects Enterprise.
Cliquez sur l'un des liens ci
Le bean EnterpriseItems constitue la source d'une collection d'objets BusinessObjects Enterprise et sert à représenter une collection d'objets sur la page. Les collections sont interrogées à partir du système BusinessObjects 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 :
AucuneL'objet racine par défaut dans le système BusinessObjects Enterprise est utilisé comme élément parent afin d'interroger les objets.
CorporateCategoryLa principale catégorie d'entreprise BusinessObjects 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.
PersonalCategoryLa principale catégorie personnelle BusinessObjects Enterprise est utilisée par l'élément parent pour rechercher des objets.
RootFolderLe dossier racine dans le système BusinessObjects Enterprise est utilisé comme élément parent afin de rechercher des objets.
UserRootCategoryLa catégorie racine de l'utilisateur final sert d'élément parent.
UserRootFolderLe 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 BusinessObjects Enterprise que vous souhaitez interroger et renvoyer dans la collection. Voici des exemples de chaînes (ProgID) valides :
AllCrystalEnterprise.CategoryCrystalEnterprise.AnalyticCrystalEnterprise.ExcelCrystalEnterprise.FavoritesFolderCrystalEnterprise.FolderCrystalEnterprise.HyperlinkCrystalEnterprise.MyInfoViewCrystalEnterprise.ObjectPackageCrystalEnterprise.PersonalCategoryCrystalEnterprise.PdfCrystalEnterprise.ProgramCrystalEnterprise.ReportCrystalEnterprise.RtfCrystalEnterprise.ShortcutCrystalEnterprise.TxtCrystalEnterprise.WebiCrystalEnterprise.WordPar 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 BusinessObjects Enterprise, voir le Guide du SDK Java BusinessObjects Enterprise.
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 BusinessObjects 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 :
SI_NAMESI_DESCRIPTIONSI_PROGIDSI_OWNERPlusieurs 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 :
sortByLa 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.
pagingLa 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 pour BusinessObjects 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/ |