Crystal Reports Toolkit for the Rational Software Development Platform 发行说明
关于本发行说明
本说明包含有关此产品版本的重要信息,其中包括安装问题、其他已知问题,以及用于客户从早期版本升级的信息。在安装此产品前,请阅读整篇文档。
安装
在 UNIX 上,Crystal Reports 需由不是以“root”身份登录的用户进行安装。
限制
以下限制适用于此版本的 Crystal Reports Toolkit for the Rational Software Development Platform:
- Crystal Reports Java Reporting Component 只能处理利用 Crystal Reports 9 或更高版本创建的报表。对于由 Crystal Reports 较早版本创建的报表,可从 Business Objects 网站下载“报表转换工具”对其进行转换。
- 此版本中未提供用于 Crystal Reports Java Reporting Component 的报表创建和修改 API。
- 不能使用访问以下数据源的报表:
- 使用 Java Reporting Component 时,只能将报表导出为 PDF、RPT、CSV 和 RTF。
- 本版本不支持下列功能:
- 报表模板
- 地图功能
- Crystal Reports 资源库
- 报表警报
- 动态提示
- 无法打开包含多个组(组排序选项设置为原始顺序)的报表。
- 要利用 Crystal Reports Java Reporting Component 导出报表,必须将 java.io.tmpdir 设置为绝对路径。
Crystal Reports 设计器
- Crystal Reports 设计器不允许同时在多个窗口中编辑同一报表。
- 命名组条件中若带有“分组依据”字段以外的字段,则包含该条件的报表将无法在以前版本的 Crystal Reports 设计器中正确显示。
- 无法预览在自定义查询表和数据库表之间包含链接的报表。
InfoView
- 如果在系统字段中使用了服务器 IP 地址,则无法登录到 BusinessObjects Enterprise Java InfoView。
解决方法:使用中央管理服务器(CMS)的主机名登录。
- 从 Rational Software Development Platform 中运行 InfoView 时,用于创建新报表的选项(顶部面板工具栏 >“新建”>“Crystal 报表”)不起作用。
解决方法 1:使用 Crystal Reports 设计器来创建新报表。
解决方法 2:从外部浏览器中启动 InfoView。
- 从 BusinessObjects Enterprise 注销时,必须清除包含缓存的报表源的所有会话变量,以确保报表查看器将使用更新的凭据连接到 BusinessObjects Enterprise。
发布
Java Reporting Component
- 将进程内 JRC 与 JSF 查看器一起使用时,JSF 必须处于服务器端状态保存模式下。
- 创建新的 JSP 页面时,请清除“使用 JSP 模板”复选框;在 Crystal Reports 代码段中,查看器自身的页面默认情况下设置为真,且使用模板可能导致重复的 HTML 标签。
- 除非为 Web 项目定义了运行时环境,否则 JRCHelperSample 应用程序将不会编译。
解决方法:在“属性”菜单上,单击“目标运行时”以设置运行时环境。
- 从项目中删除 JRC 构面后,未自动删除 JRCHelperSample 类,因为该类可能已被修改。
- 无法在页面设计器的“设计”视图中插入 Crystal Reports 代码段。
解决方法:要插入代码段,请切换到页面设计器的“源”视图。
- 为了让 JSF 查看器正确显示报表,必须将 DOCTYPE 声明更改为 <!DOCTYPE html PUBLIC"-//W3C//DTD HTML 4.01 Transitional//EN">。
- 将控件与使用“使用最新实例”选项创建的 EnterpriseItem Bean 同步时,页面代码中可能会出现错误。
解决方法:在页面代码中,将“getParentItemID”更改为“getItemID”,并将“setParentItemID”更改为“setItemID”。
- 在页面数据视图中,无法修改页面 Bean 类别下项目的配置。
解决方法:改为修改 Faces 托管 Bean 下相同项目的配置。
报表功能
- 如果预览包含保存的数据的报表,且该报表的“首次刷新时验证”选项设置为“真”,则保存的数据将被丢弃,并且会出现一条警告消息。
解决方法:预览报表之前,请在 Crystal Reports 设计器中打开此报表,清除“首次刷新时验证”报表选项,然后保存该报表。
- 在另一项操作正在执行时打开页面可能会导致 java.lang.IndexOutOfBoundsException 异常。当使用 JSF 查看器并且将 javax.faces.STATE_SAVING_METHOD 设置为“服务器”时,会出现此问题。此问题是由 Sun 的 JSF 实施中的错误造成的。
解决方法:更新到比版本 1.1 更新的 Sun JSF 实施,或者使用替代的 JSF 实施。
- 为 java.sql.ResultSet 设置了数据源后,如果 OldTableAlias 和 NewTableName 不同,RAS SDK 将无法使用 NewTableName 的值来为新表命名。
- 预览报表时,DataEngine 无法获取 java.util.Date 类型中的 POJO 数据。
解决方法:改为使用 java.sql.Date 类型。
- 导出按需子报表时,只能将主报表第一页上的那些子报表导出为 CSV 格式。
- 修改图表时,在将“排序顺序”设置为“前 N 名”、“后 N 名”、“前百分之 N”或“后百分之 N”后,将无法更改“分组依据”属性。
解决方法:修改“分组依据”字段之前,请将“排序依据”更改为“升序”或“降序”。
- 数据库资源管理器不支持存储过程。这是已知的 Eclipse 问题。有关更多信息,请参阅 Eclipse Bugzilla 错误 132107。
解决方法:要获得可能的代码解决方法,请参阅以下位置的论坛线索:http://diamond.businessobjects.com/node/520#comment-209。
特定于平台的问题
- 在 Sun JVM 上,可能会出现以下错误消息:“java.lang.OutOfMemoryError:永久保存区域”(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 上,导出功能可能不适用于所有导出格式。
解决方法 1:使用 JSF Crystal Reports 页面查看器将报表导出为多种格式。
解决方法 2:确保查看器代码是页面上的唯一输出。
- 在版本 1.5.0_07 以前的 Sun JVM 上,在加载包含 OLE 对象图像的报表时,多线程环境中可能会发生 java.awt.color.CMMException。
- Konqueror 不是受支持的浏览器。在运行 JSP 代码以在 Konqueror 中查看报表时,可能会出现一条错误消息。
解决方法:使用受支持的 Web 浏览器。
- 在 Sun JVM 1.4.2 上将节的值导出为 XML 时,可能会出现不一致的结果。
- 在 SUSE Linux 平台上,联机帮助中的搜索功能不起使用。
解决方法:在“帮助内容”中查看信息。
格式设置和呈现
- 若要撤消文本对象内的拖放操作,请单击“撤消”两次。
- 在文本对象编辑模式下,在段落开头处的字段对象前插入的第一个标签标记未能显示。
- 在报表中创建新的文本对象时,如果文本对象的“第一行缩进”属性设置为负值,则只在光标移过左缩进后才会显示文本。
- 在文本对象中编辑段落时,文本对象将显示第一个标签标记,但不显示后随的任何标签标记。
- 在文本对象中,如果为多行段落中的文本设置格式,将导致被设置格式的文本断开为新的行。
- 要选择位于框下方的对象,请先将框移到后面。
- 节的“相对位置”属性不会应用于节中的线和框。
- 在 Crystal Reports 设计器的“日期格式”属性中,如果将“星期日期括号”选项设置为“圆括号”或“圆括号(加空格)”,示例区域中显示不出差异。
- 下表描述了在运行时打开和保存带有以下不受支持的功能的报表时 JRC 的行为方式:
功能 | 在打开带有此功能的报表时 JRC 的行为 | 在保存带有此功能的报表时 JRC 的行为
|
---|
报表警报 | 不触发警报。 | 保留报表定义中的警报信息。但是,不保留警报视图。 |
地图 | 显示为空白对象。 | 在报表定义中保留。 |
带有纹理和图片的 Crystal Reports 9 报表图表 | 不显示。 | 在报表定义中保留。 |
图表标签位置 | 如果移动标签,则它们会被重置为其默认位置。 | 在报表定义中保留。 |
带有 Crystal Enterprise 上下文“当前 Crystal Enterprise 用户 ID”的特殊字段。
| 映射到“垂直页码”。
| 保留特殊字段。 |
动态图像 | 不支持。 | 完全支持。 |
参数化排序 | 支持。 | 完全支持。 |
层次组排序 | 支持。 | 完全支持。 |
公式函数添加 | 支持(Crystal Enterprise 时区除外)。 | 完全支持。 |
动态提示 | 不支持。 | 不保留。 |
网格增强 | 支持平展交叉表的列标题。 | 保留平展的列标题。不保留贯穿钻取视图。 |
关系数据库和 SQL 语句
- Oracle JDBC 驱动程序不支持使用联接类型“完全外部联接”联接的表。将出现以下消息:“不支持完全外部联接。”
- 使用 setTableLocation 将数据库表位置设置为 ODBC 可能会导致报表对象被删除。
解决方法:将表位置设置为 JDBC、JNDI、XML 或 Java 结果集。
- 在 SunOne8 应用程序服务器或 Oracle 10g 应用程序服务器上加载报表时,必须指定绝对路径(而不是相对路径)。
- 使用 JRC“设置位置”命令将表的位置从 ODBC 更改为 JDBC/JNDI 后,只能在 JRC 中刷新报表。
解决方法:为了能够在 Crystal Reports 设计器中使用报表刷新功能,请在“设置位置”命令中提供 JNDI 服务器信息。
- Informix 驱动程序不支持从 Informix 数据库添加到报表的 Blob 字段。
- 由于 Informix JDBC 驱动程序的问题,在查看包含存储过程的 Informix 报表时,将出现以下错误:“无法解析例程 (prc_decimal)”(Routine (prc_decimal) cannot be resolved)。
- 在从设计器连接到 Microsoft SQL Server 数据库时,输入数据库名称后,数据库资源管理器将显示用户的默认数据库。
解决方法:指定完整的连接字符串(包括数据库名称)。
- 如果报表中的 Datafields 字段是公式字段,则字段的属性中将缺少“不汇总”选项。
- 在预览具有“Real”类型的 SQL Server 数据库字段的报表时,可能会出现以下错误消息:“JDBC 错误:值无法转换为请求的类型”(JDBC Error: Value cannot be converted to requested type)。此问题是由 Microsoft JDBC 的问题所致。
- 将多个 SQL 语句添加到 SQL 剪贴簿页面(右击“Crystal Reports”>“添加到新报表”)时,只会将第一个 SQL 语句添加到报表。在使用 Derby 数据库时会出现此问题。
- 在创建新的 DB2 UDB iSeries 数据库连接时,如果键入一个不正确的密码,则 Eclipse 进程可能会意外终止。有关更多信息,请参阅 Eclipse Bugzilla 错误 148920。
- 在 Java 设计器中创建新的 SQL Server 数据库连接时,如果在连接 URL 中包括密码信息,然后更新连接属性,则 Java 设计器可能无法识别出这是相同的连接,因而,即使所有表都来自同一数据库,它仍可能会生成包含跨数据库联接的 SQL。
解决方法:保存报表,然后重新打开报表。建议在创建新的连接时不要在 URL 中包括密码信息。
- 将 SQL 语句添加到 Crystal 报表时,请使用 SQL 编辑器(而不是默认设置)来打开 SQL 文件。
- 连接到 Rational Software Development Platform 随附的 Derby 示例数据库时,可能会出现以下错误消息:“无法添加对象。登录错误:用户名‘{userid}’无效。”(Could not Add Object. Logon Error: The user name '{userid}' is not valid.)
解决方法:修改数据库连接以确保在连接详细信息中输入用户 ID。
特定于语言的问题
- 在制作本地化文档时,并非所有语言包都可用。因此,某些在最新的语言包集中可能已翻译的 UI 术语在文档中保留为英文。
- JRC 在段落级别(而不是在字符级别)解释从右到左的文本;因此段落中混合的从右到左和从左到右的文本可能无法正确显示。
- 在导出为 RTF 格式时,无法正确对阿拉伯语和希伯来语字符进行编码。
- 在使用逗号作为小数分隔符的操作系统区域设置(例如德语或意大利语)中,由于 Swing 程序缺陷,小数对齐功能不正常。
- 如果使用 JRC 将报表导出为 PDF 格式,某些语言可能会将一些字符显示为问号或方框。
- 在意大利语环境中,小数分隔符在某些 Crystal Reports 设计器对话框中显示不正确。不过,可以配置要在报表中使用的正确的意大利语小数分隔符。
- 在非英语操作系统中,为了避免显示乱码字符,请确保所选字体的字符集中包含符号。
- 在波兰语环境中,设置货币格式对话框中显示的货币值在符号和金额之间缺少空格。
辅助功能
- 若要使屏幕阅读器(如 JAWS)能够正确地与 Crystal Reports 设计器一起使用,必须安装 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 键盘管理器中,重置 Alt+向上键、Alt+向下键、Ctrl+Home 和 Ctrl+End 键绑定,以匹配 Crystal Reports 中那些组合键的功能。
- 无法通过键盘使用“预览”页面中的向下钻取功能。
- JAWS 无法读出 Crystal Reports 设计器选项板中的字段。有关更多信息,请参阅 Eclipse Bugzilla 错误 146620。
- JAWS 将 Crystal Reports 设计器选项板标签解读为滑块。有关更多信息,请参阅 Eclipse Bugzilla 错误 146859。
- 在数据库资源管理器视图中,某些热键可能不起作用,原因是未将它们分配给唯一的操作。此问题是 JAWS 的限制所致,它只读出上下文菜单项的第一个字母。
- 要使用键盘将字段对象插入文本对象,请选择这两个对象,然后从快捷菜单中单击 “向文本对象中添加字段”选项。