EnterpriseItem Bean

这个托管 Bean 是单一 BusinessObjects Enterprise 对象（如报表、文件夹或程序）的来源。该 Bean 提供信息并将功能添加到 UI 组件。

要了解有关核心 BusinessObjects Enterprise 功能和应用程序开发的更多信息，请查阅《BusinessObjects Enterprise Java SDK 指南》。

单击相应链接可转至该节：

• 概述
• 示例 faces-config.xml 声明

概述

EnterpriseItem Bean 是 BusinessObjects Enterprise 对象的来源，并用于在页面上呈现对象。EnterpriseItem Bean 是使用 用于 BusinessObjects Enterprise 的 JavaServer Faces 组件构建的任何应用程序的关键特征。许多组件（如 ReportPageViewer 组件）都依赖于 EnterpriseItem Bean，因为它们的功能是针对 BusinessObjects Enterprise 对象运行的。例如，ReportPageViewer 组件的用途是查看，特别是查看报表对象。要从系统中检索某个 BusinessObjects Enterprise 对象，页面必须使用 BusinessObjects Enterprise 查询语言查询该对象。但是，EnterpriseItem Bean 降低了复杂程度，只需一组自动生成查询字符串的属性即可达到目的。将属性设置为所需的值即可检索感兴趣的对象。有关 BusinessObjects Enterprise 查询语言的更多信息，请参阅《BusinessObjects Enterprise Java SDK 指南》。

itemID 属性是在 EnterpriseItem Bean 和实际对象之间建立关系的关键所在，因为它指定了 EnterpriseItem Bean 所代表对象的 ID 或 CUID。例如，可以将此属性设置为用户在某个页面中所选择报表的报表 ID。然后，可以将此 EnterpriseItem Bean 绑定到 ReportPageViewer 组件，以便向用户呈现并显示该报表。可以用多种方式设置 itemID 属性。一种常见的方案是：在用户从页面中的项目列表中选择了一个项目后以编程方式设置 itemID 属性。在这种情况下，您实际上查询了 EnterpriseItems Bean 所代表的项目集合，使用诸如 ItemsGrid 组件等组件显示了 EnterpriseItems Bean 代表的项目集合，然后将用户所选项目的单一 ID 传入了 EnterpriseItem Bean 中。有关更多信息，请参阅EnterpriseItems Bean。如何为 EnterpriseItem Bean 设置 itemID 属性很大程度上取决于您要尝试实施的方案。

fields 属性定义要查询的数据库字段，它确定了随对象一起检索哪些对象属性和属性包。选择随对象一起返回哪些对象，以便 EnterpriseItem Bean 能够访问您需要的信息。有效字符串的示例包括：

• »´ðø

返回所有字段。

• SI_ID

在 BusinessObjects Enterprise 系统中唯一地标识某个对象的数字。

• SI_CUID

群集唯一标识符。标识对象，并保证在群集内是唯一的。

• SI_NAME

对象的文字名称。

• SI_DESCRIPTION

对象的文字说明。

• SI_GUID

全局唯一标识符。标识对象，并保证是唯一的。

• SI_PARENTID

唯一标识对象父项的数字。

• SI_PARENTCUID

对象父项的群集唯一标识符。保证在群集内是唯一的。

• SI_INSTANCE

指明对象是否是报表实例的布尔值。

• SI_PROGID

一个字符串，指定实施对象的组件的名称。有效进程 ID 值的示例包括 CrystalEnterprise.Folder、CrystalEnterprise.Report 和 CrystalEnterprise.PDF。有关完整的列表，请查阅《BusinessObjects Enterprise Java SDK 指南》。

• SI_OWNER

拥有特定对象的用户的文字名称。

• SI_OWNERID

唯一标识拥有特定对象的用户的数字。

• SI_CREATION_TIME

对象的创建日期和时间。

• SI_LAST_RUN_TIME

上次运行对象时的日期和时间。

• SI_UPDATE_TS

上次修改对象时的日期和时间。

• SI_PROCESSINGINFO

包含了指定对象处理信息的属性。

• SI_SCHEDULEINFO

包含了指定预定作业的当前状态和信息的属性。

• SI_HASTHUMBNAIL

指明对象是否有附带缩略图的布尔值。

基于您为此 fields 属性所做的选择，EnterpriseItem Bean 将能够访问和处理对象的字段。因此，举例来说，"All" 将返回所有字段，而 {"SI_NAME, SI_DESCRIPTION, SI_PROGID"} 将只返回三个特定字段，其中包括项目的标题、说明和进程 ID。

注意：
   有关 BusinessObjects Enterprise 进程 ID 的更多信息，请参阅《BusinessObjects Enterprise Java SDK 指南》。

注意：
   有关所有 EnterpriseItem Bean 成员的全面参考信息，请参阅 BusinessObjects Enterprise 的 JavaServer Faces 组件的 Java API 参考中的 IEnterpriseItem 接口。

示例 faces-config.xml 声明

<managed-bean>

    <description>Source for a single report.</description>

    <managed-bean-name>report</managed-bean-name>

    <managed-bean-class>

        com.businessobjects.jsf.appcontrols.model.EnterpriseItem

    </managed-bean-class>

    <managed-bean-scope>session</managed-bean-scope>

    <managed-property>

        <property-name>itemID</property-name>

        <value>0</value>

    </managed-property>

</managed-bean>