EnterpriseItem Bean

另请参见  

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

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

单击相应链接可跳转至该节:

概述

EnterpriseItem Bean 是 Crystal Enterprise 对象的来源,并用于在页面上呈现对象。EnterpriseItem Bean 是使用 Crystal Enterprise 的 JavaServer Faces 组件构建的任何应用程序的关键特征。许多组件(如 ScheduleReportPageViewer 组件)都依赖于 EnterpriseItem Bean,因为它们的功能是针对 Crystal Enterprise 对象运行的。例如,ReportPageViewer 组件的用途是查看,特别是查看报表对象。要从系统中检索某个 Crystal Enterprise 对象,页面必须使用 Crystal Enterprise 查询语言查询该对象。但是,EnterpriseItem Bean 降低了复杂程度,只需一组自动生成查询字符串的属性即可达到目的。将属性设置为所需的值即可检索感兴趣的对象。有关 Crystal Enterprise 查询语言的更多信息,请参阅《Crystal 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 能够访问您需要的信息。有效字符串的示例包括:

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

注意:    有关 Crystal Enterprise 进程 ID 的更多信息,请参阅《Crystal Enterprise Java SDK 指南》。

注意:    有关所有 EnterpriseItem Bean 成员的全面参考,请参阅 Crystal Reports for Rational Application Developer 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>


Business Objects
http://www.china.businessobjects.com

支持服务
http://www.china.businessobjects.com