Crystal Reports Toolkit 发行说明
© Copyright Business Objects Software Limited 2004, 2007.
© Copyright International Business Machines Corporation 2006, 2007. All rights reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
发行说明
1.0 局限性
1.1 安装
1.2 限制
1.3 Crystal Reports Designer
1.4 InfoView
1.5 Java 报告
2.0 已知问题与变通方法
2.1 InfoView
2.2 发布
2.3 Java 报告
2.4 报告功能
2.5 特定于平台的问题
2.6 格式化与呈示
2.7 关系数据库与 SQL 语句
2.8 特定于语言的问题
2.9 辅助功能选项
在 Linux® 上,Crystal Reports 只能由并非以 root 用户身份登录的用户安装。
- Java™ Reporting Component 只能处理使用 Crystal Reports 9
或更高版本创建的报告。您应该使用报告转换工具对使用先前版本 Crystal Reports 创建的报告进行转换,可以从
Business Objects 的 Web 站点下载该工具。
- 在本发行版中,未公布 Java Reporting Component 的报告创建和修改 API。
- 不能使用需要访问下列数据源的报告:
- 使用 Java Reporting Component 时,只能将报告导出为 PDF、RPT、CSV 和 RTF。
- 在本发行版中,不支持下列功能:
- 报告模板
- 地图
- Crystal Reports 存储库
- 报告警报
- 动态提示
- 如果报告中包含的组将组排序选项设置为原始顺序,则无法打开这些报告。
- 要使用 Java Reporting Component 来导出报告,必须将 java.io.tmpdir 设置为绝对路径。
- Crystal Reports Designer 不允许同时在多个窗口中编辑同一个报告。
- 如果报告包含已命名的组条件,并且该条件带有除“分组方式”字段以外的字段,则无法在先前版本的
Crystal Reports Designer 中正确地显示该报告。
- 如果报告包含定制查询表与数据库表之间的链接,则无法预览该报告。
从 BusinessObjects Enterprise 中注销时,必须清除所有包含已高速缓存的报告源的会话变量,以确保报告查看器使用更新后的凭证来连接 BusinessObjects Enterprise。
- 在将 JRC 内部进程与 JSF 查看器配合使用时,JSF 必须处于服务器端状态保护方式。
- 创建新的 JSP 页面时,请清除“使用 JSP 模板”复选框。在 Crystal Reports 代码段中,查看器自己的页面在缺省情况下设置为 true,因此使用模板可能会导致 HTML 标记重复。
- 从项目中除去 JRC 构面时,不会自动除去 JRCHelperSample 类,这是因为它可能已被修改。
- 如果在系统字段中使用了服务器 IP 地址,您将无法登录到 BusinessObjects Enterprise Java InfoView。
变通方法:使用中央管理服务器(CMS)的主机名进行登录。
- 从 Rational® Software Development Platform 中运行
InfoView 时,用来创建新报告的选项(“页眉面板”工具栏 > 新建 > Crystal Report)不起作用。
变通方法:使用 Crystal Reports Designer 来创建新报告,或者从外部浏览器中打开 InfoView。
- 如果报告包含将“求值条件类型”设置为“对于每个记录”或者将“复位条件类型”设置为“从不”的累计,则无法将该报告发布到 BusinessObjects Enterprise。
变通方法:使用“条件类型”列表中的其他选项。
- 在发布包含多个 JDBC 连接的报告时,发布向导无法显示所有连接。
变通方法:请转到中央管理控制台(CMC)以修改发布向导中未显示的 JDBC 连接。
- 除非为 Web 项目定义了运行时,否则 JRCHelperSample 应用程序无法通过编译。
变通方法:在“属性”菜单中,单击“目标运行时”以设置运行时。
- 在 Page Designer 的“设计”视图中,无法插入 Crystal Reports 片段。
变通方法:要插入片段,请切换到 Page Designer 的“源代码”视图。
- 要让 JSF 查看器正确地显示报告,必须将 DOCTYPE 声明更改为“!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"”。
- 在使控件与使用“使用最新的实例”选项创建的 EnterpriseItem Bean 同步时,页面代码可能会出错。
变通方法:在页面代码中,将“getParentItemID”更改为“getItemID”,并将“setParentItemID”更改为“setItemID”。
- 在“页数据”视图中,不能修改“页面 Bean”类别下面某个项的配置。
变通方法:改为修改“Faces 受管 Bean”下面同一个项的配置。
- 在预览包含已保存的数据并且将“第一次刷新时进行验证”选项设置为 true 的报告时,保存的数据将被废弃,接着会出现警告消息。
变通方法:预览该报告前,请在创建该报告的 Crystal Reports Designer 中将其打开,清除“第一次刷新时进行验证”报告选项,然后保存该报告。
- 如果在另一个操作执行期间打开页面,可能会导致 java.lang.IndexOutOfBoundsException
异常。当使用 JSF 查看器,并且 javax.faces.STATE_SAVING_METHOD 设置为“server”时,将发生此问题。此问题是由
Sun 的 JSF 实现中的错误引起的。
变通方法:更新为版本高于 V1.1 的 Sun JSF 实现,或者使用另一个 JSF 实现。
- 设置 java.sql.ResultSet 的数据源后,如果 OldTableAlias 与 NewTableName
不同,则 RAS SDK 将无法使用 NewTableName 值对新表进行命名。
- 预览报告时,DataEngine 无法访存 java.util.Date 类型的 POJO 数据。
变通方法:改为使用 java.sql.Date 类型。
- 导出随需应变子报告时,只能将主报告第一页上的那些报告导出为 CSV 格式。
- 修改图表时,在将“排序顺序”设置为“顶部 N 个”、“底部 N 个”、“顶部百分比”或“底部百分比”之后,无法更改“分组方式”属性。
变通方法:在修改“分组方式”字段之前,将“排序顺序”更改为“升序”或“降序”。
- 数据库资源管理器不支持存储过程。这是 Eclipse 的一个已知问题。有关更多信息,请参阅 Eclipse Bugzilla 错误 132107。
变通方法:要了解可能的代码变通方法,请参阅以下网址处的论坛论题:http://diamond.businessobjects.com/node/520#comment-209。
特定于平台的问题
- 在 Sun JVM 上,可能会出现以下错误消息:“java.lang.OutOfMemoryError: PermGen space”。
变通方法:更新 eclipse.ini 文件并指定下列设置:
-vmargs
-Xms40m
-Xmx512m
-XX:MaxPermSize=256m
请参阅 Eclipse Bugzilla 错误 129490 和 92250,以获取更多详细信息。
- 在编辑已发布到 Apache Tomcat 服务器的报告时,必须在保存该报告前关闭 Tomcat,以确保成功地保存更改。
- 除去构面时,将从 lib 目录中除去文件,但不会从构建路径中除去文件。这可能会导致“问题”视图中显示错误。
- 在 IBM® Websphere® 6.0 和 6.1 上,导出功能可能并不适用于所有导出格式。
变通方法:使用 JSF Crystal Reports Page Viewer 来将报告导出为多种格式,或者确保查看器代码是页面上的唯一输出。
- 在 V1.5.0_07 以前的 Sun JVM 上,在多线程环境中装入包含
OLE 对象映像的报告时,可能会发生 java.awt.color.CMMException。
- Konqueror 不是受支持的浏览器。当运行 JSP 代码以便在 Konqueror 中查看报告时,可能会出现错误消息。
变通方法:使用受支持的 Web 浏览器。
- 在 Sun JVM 1.4.2 上,当将报告段值导出为 XML 时,可能会出现不一致的结果。
- 在 SUSE Linux® 平台上,联机帮助中的搜索功能不起作用。
变通方法:在“帮助内容”中查找信息。
- 要撤销文本对象中的拖放操作,必须单击两次“撤销”。
- 在文本对象编辑方式下,不会显示在段落开头的字段对象前插入的第一个制表符标记。
- 在报告中创建新的文本对象时,如果将文本对象的“第一行缩进”属性设置为负数值,则仅当光标越过左边的缩进部分时,该文本才会显示。
- 在文本对象中编辑段落时,该文本对象将显示第一个制表符标记,但不会显示随后的任何制表符标记。
- 在文本对象中,格式化多行段落中的文本会导致将该文本格式化为新的一行。
- 要选择某个框下方的对象,首先必须将该框移到后面。
- 报告段的“相对位置”属性不会应用于该报告段中的线和框。
- 在 Crystal Reports Designer 的“日期格式”属性中,将“星期包围字符”选项设置为“括号”或“正向括号”并不会在“样本”区域中体现任何区别。
下表描述了在运行时打开和保存包含下列不受支持特性的报告时的 JRC 行为。
特性 |
打开包含此特性的报告时的 JRC 行为 |
保存包含此特性的报告时的 JRC 行为 |
报告警报 |
不会触发警报。 |
将保留报告定义中的警报信息。但是,不会保留警报视图。 |
地图 |
显示为空白对象。 |
保留在报告定义中。 |
带有纹理和图片的 Crystal Reports 9 报告图表 |
不显示。 |
保留在报告定义中。 |
图表标签布置 |
如果移动了标签,则会将它们恢复到缺省位置。 |
保留在报告定义中。 |
具有 Crystal Enterprise 上下文的特殊字段:当前 CE 用户标识 |
映射至垂直页号。 |
将保留特殊字段。 |
动态图像 |
不支持。 |
完全支持。 |
参数化排序 |
支持。 |
完全支持。 |
水平组排序 |
支持。 |
完全支持。 |
添加的公式函数 |
支持(Crystal Enterprise 时区除外)。 |
完全支持。 |
动态提示 |
不支持。 |
不保留。 |
网格增强功能 |
对于 Crosstab,支持平铺列标题。 |
保留平铺的列标题。不保留深入钻取视图。 |
- Oracle JDBC 驱动程序不支持使用连接类型“全部外连接”连接的表。出现了以下消息:不支持全部外连接。
- 使用 setTableLocation 将数据库表位置设置为 ODBC 可能会导致报告对象被删除。
变通方法:将表位置设置为 JDBC、JNDI、XML 或 Java 结果集。
- 在装入 SunOne8 应用程序服务器或 Oracle 10g 应用程序服务器上的报告时,必须指定绝对路径,不能指定相对路径。
- 如果使用 JRC 的“设置位置”命令将表位置由 ODBC 更改为 JDBC/JNDI,则将只能在 JRC 中刷新该报告。
变通方法:要使报告刷新操作在 Crystal Reports Designer 中起作用,请在“设置位置”命令中提供 JNDI 服务器信息。
- Informix® 驱动程序不支持从 Informix 数据库添加到报告的 Blob 字段。
- 由于 Informix JDBC 驱动程序的问题,在查看包含存储过程的 Informix 报告时,可能会发生以下错误:无法解析例程 prc_decimal。
- 在从 Designer 中连接至 Microsoft® SQL Server
数据库时,输入数据库名称后,数据库资源管理器将显示用户的缺省数据库。
变通方法:指定完整的连接字符串,包括数据库名称。
- 如果报告中的“数据字段”字段是一个公式字段,则该字段的属性将不包括“不进行摘要”选项。
- 在预览 SQL Server 类型为“实型”的数据库字段的报告时,可能会出现以下错误消息:“JDBC 错误:无法将值转换为所请求的类型”。此问题是由 Microsoft JDBC 问题引起的。
- 如果对 SQL 代码片断编辑测试窗页面添加多个 SQL 语句(右键单击
Crystal Reports > 添加到新报告),则只会将第一个 SQL 语句添加到报告中。在使用 Derby 数据库时,会发生此问题。
- 如果创建新的 DB2® UDB iSeries®
版数据库连接时输入了不正确的密码,Eclipse 进程可能会意外终止。有关更多信息,请参阅 Eclipse Bugzilla 错误 148920。
- 在 Java 设计器中创建新的 SQL Server 数据库连接时,如果在连接 URL 中包括了密码信息,然后更新连接属性,则
Java 设计器无法识别仍在使用同一个连接。因此,它可能会生成包含跨数据库连接的 SQL,即使所有表来自同一个数据库亦如此。
变通方法:保存该报告,然后将其重新打开。在创建新连接时,建议您不要在 URL 中包括密码信息。
- 对 Crystal 报告添加 SQL 语句时,请使用 SQL 编辑器,而不要使用“打开 SQL 文件”这一缺省设置。
- 在连接至 Rational Software Development Platform 附带交付的 Derby
样本数据库时,可能会出现以下错误消息:未能添加对象。登录错误:用户名(用户标识)无效。
变通方法:修改数据库连接,确保连接详细信息包含用户标识。
- 在生成本地化的文档时,并非所有语言包都可用。因此,某些 UI 项在最新的一组语言包中可能已翻译为本地语言,但在文档中仍是英文的。
- JRC 在段落级解释从右到左的文本,但不在字符级进行此解释,因此,如果段落同时包含从右到左和从左到右的文本,则无法正确显示。
- 导出为 RTF 格式时,阿拉伯语和希伯莱语字符的编码不正确。
- 在诸如德语或意大利语等使用逗号作为数字分隔符的操作系统语言环境中,数字对齐功能由于 Swing 中的错误而不起作用。
- 在使用 JRC 将报告导出为 PDF 格式时,某些语言可能会将一些字符显示为问号或方框。
- 在意大利语环境中,某些 Crystal Reports Designer 对话框无法正确地显示数字分隔符。但是,可以配置报告中要使用的正确意大利语数字分隔符。
- 在非英语操作系统中,为了避免显示无用的字符,请确保所选字体的字符集包含象形文字。
- 在波兰语环境中,“格式化货币”对话框显示的货币值在符号与金额之间遗漏了空格。
- 要使诸如 JAWS 之类的屏幕朗读器正确地与 Crystal Reports Designer 配合工作,必须安装
Java Access Bridge。可以从以下网址安装 Java Access Bridge:http://java.sun.com/products/accessbridge。
要将 Java Access Bridge 与 IBM JVM 1.5 配合使用,必须重新分发某些
Jar 文件。有关更多信息,请参阅以下网址处提供的 readme.txt
文件:http://java.sun.com/products/accessbridge/README.txt。
- 屏幕朗读器 JAWS 映射了与 Crystal Reports 中使用的组合键不同的快捷键。
变通方法:在 JAWS Keyboard Manager 中,复位 Alt+向上箭头键、Alt+向下箭头键、Ctrl+Home 和 Ctrl+End
的键绑定,使它们与 Crystal Reports 中那些组合键的功能匹配。
- “预览”页面中的向下钻取功能无法通过键盘完成。
- JAWS 无法声明 Crystal Reports Designer 选用板中的字段。有关更多信息,请参阅 Eclipse Bugzilla 错误 146620。
- JAWS 将 Crystal Reports Designer 选用板标签声明为滑块。有关更多信息,请参阅 Eclipse Bugzilla 错误 146859。
- 在“数据库资源管理器”视图中,某些热键由于未被指定到唯一的操作而不起作用。发生此问题的原因是,在 JAWS 中有一项局限性,即只读取上下文菜单项的第一个字母。
- 要使用键盘将字段对象插入到文本对象中,请选择这两个对象,然后从快捷菜单中选择“将字段添加至文本”选项。