这个托管 Bean 是 Crystal Enterprise 对象集合(如多个报表、文件夹或程序)的来源。该 Bean 提供信息并将功能添加到 UI 组件。
要了解有关核心 Crystal Enterprise 功能和应用程序开发的更多信息,请查阅《Crystal Enterprise Java SDK 指南》。
EnterpriseItems
Bean 是 Crystal Enterprise 对象集合的来源,并用于在页面上呈现对象集合。集合是使用后置代码中的查询字符串从 Crystal Enterprise 系统中查询出的。这些查询字符串是按与 EnterpriseItem Bean 相同的方式通过设置 Bean 属性构建的。有关 Crystal Enterprise 查询语言的更多信息,请参阅《Crystal Enterprise Java SDK 指南》。
enableDefaultParent
和 parentItemID
是确定查询对象时所使用父项目的两个关键属性。 enableDefaultParent
属性的可能值是 com.businessobjects.jsf.sdk.properties.DefaultParentType
类的字段:
无
使用 Crystal Enterprise 系统内的默认根对象作为父项目来查询对象。
CorporateCategory
主 Crystal Enterprise 公司类别作为父项目来查询对象。
Custom
使用 parentItemID
属性指定的自定义父项目作为父项目。将 parentItemID
属性设置为项目的标识符,该项目将成为用于查询对象的父项目。
PersonalCategory
主 Crystal Enterprise 个人类别作为父项目来查询对象。
RootFolder
使用 Crystal Enterprise 系统内的根文件夹作为父项目来查询对象。
UserRootCategory
用最终用户自己的根类别作为父项目。
UserRootFolder
用最终用户自己的根文件夹作为父项目。
parentItemID
指定待查询集合中所有对象的父项的 ID 或 CUID。可以按多种不同的方式设置此属性。例如,当用户从列表中单击文件夹时,您可能想以编程方式将 parentItemID
属性设置为文件夹的 itemID 属性值。然后,可以使用此 ID 在该父文件夹内查询报表集合。
fields
属性定义要查询的数据库字段。有关此属性及其值的完整说明,请参阅 EnterpriseItem Bean。
将 itemTypes
属性设置为一种或多种要查询的 Crystal Enterprise 对象,并在集合中返回。有效字符串(进程 ID)的示例包括:
全部
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
因此,举例来说,"All"
将返回所有字段,而 {"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"}
将只返回 Crystal 报表项目、PDF 项目或纯文本文件项目。
注意: 有关 Crystal Enterprise 进程 ID 的更多信息,请参阅《Crystal Enterprise Java SDK 指南》。
searchFields
和 searchText
属性必须同时使用才能在 Crystal Enterprise 系统上执行通配符搜索。将 searchFields
属性设置为要搜索的字段,并将 searchText
属性设置为要匹配的文本。例如,将 searchFields
属性设置为 Name
,并将 searchText
属性设置为 World Sales Report
以搜索名称为“World Sales Report”的报表。只有某些字段经过优化,并且建议进行搜索:
若干其他属性控制对象集合查询操作的特定方面。将 filterByOwner
属性设置为 true
,以便只查询用户拥有的项目。默认情况下,此属性为 false
。instances
属性确定实例是否包括在返回的对象集合中,并且设置为 EnterpriseItems
Bean。必须将此属性设置为 com.businessobjects.jsf.sdk.properties.InstanceFilter
类的字段:IncludeInstances
(用于在查询结果中包括实例);ExcludeInstances
(用于从查询结果中排除实例);以及 InstancesOnly
(用于返回只包含对象实例的集合)。
除了 Bean 的常规属性之外,还有两个属性可访问包含更多属性的类:
sortBy
属性
sortBy
属性获取或设置 SortProps
类的实例,该类包含用于指定如何在 EnterpriseItems
Bean 内对集合中的项目进行排序的属性。 SortProps
类的 sortField
属性指定对集合中的项目进行排序所依据的字段,而 SortProps
类的 sortDirection
属性指定是按升序还是按降序数字顺序对项目进行排序。
注意: ItemsGrid
组件指定绑定到组件的 EnterpriseItems
Bean 的排序属性值。务必不要在设计时手动更改 EnterpriseItems
Bean 中的这些值(如果附加到 ItemsGrid
组件)。
paging
属性
paging
属性获取或设置 PagingProps
类的实例,该类包含用于指定用户如何在 EnterpriseItems
Bean 所代表的项目列表中分页的属性。默认情况下,分页处于禁用状态。要启用分页并允许用户在项目的页面间导航,请使用 PagingProps 类的 setEnabled
方法(参数为 true
)。 用户可在每一页上看到的项目数由 pageSize
属性确定。默认值是每次在页面上显示十个项目。 rangeSize
属性指定用于定义页码范围的页面数。例如,如果带参数 10 使用 setRangeSize
方法,并且将 EnterpriseItems
Bean 绑定到 ItemsGrid
组件,则用户可以使用网格底部的页码按钮来单独地浏览第 1 页到第 10 页。如果单击了下一页码范围按钮,则第 11 页到第 20 页的页码按钮将变得可供选择。
注意: 有关所有 EnterpriseItems
Bean 成员的全面参考,请参阅 Crystal Enterprise 的 JavaServer Faces 组件的 Java API 参考 中的 IEnterpriseItems
接口。
<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.china.businessobjects.com/ 支持服务 http://www.china.businessobjects.com/services/services.htm |