设计模型报告的技巧

可将 IBM® Rational® 产品的功能和商业智能与报告工具 (BIRT) 的功能配合使用,以微调用于 UML 和 EMF 模型的数据源、数据集和报告设计。下列技巧提供了有关设计模型报告的有用信息以及指向提供了其他信息的站点的链接。
通过样本模型完成报告设计过程
要获取有关如何设计报告的逐步演示,请参阅名为“为 UML 模型创建 BIRT 报告设计”的教程。该教程说明如何创建报告设计以及将常用模型元素添加至报告。
将常用类型的模型信息添加至报告
要将信息包括在报告中,必须将相应元素添加至报告设计。对于通常包括在报告中的某些类型的信息(例如模型元素文档),必须遵循特殊过程。有关更多信息,请参阅主题“将常用类型的模型信息添加至报告”。
查找可用的定制 XPath 函数
要获取 IBM Rational 提供的 XPath 函数,请参阅主题“用于 EMF 和 UML 数据集的其他 XPath 函数”。当这些函数不足以构建需要的数据集时,可以编写您自己的 XPath 函数并使用名为 org.eclipse.jet.xpathFunctions 的扩展点来对它们进行注册。有关信息,请参阅主题“编写定制 XPath 函数”。
另请参阅“数据集”向导的“列映射”页面的上下文帮助,可在该向导中指定 XPath 函数。
对 XPath 表达式进行故障诊断
您可能遇到在“数据集”对话框中似乎有效但当对它们进行预览时没有产生任何结果的 XPath 表达式。
“数据集”对话框仅验证 XPath 语法。它不会捕获诸如对模型中不存在的导航路径的引用之类的错误。
连接数据集
如果连接数据集且需要关键字来唯一地标识模型对象,那么最佳关键字是模型对象的 URI,因为它在资源范围内唯一。getURI() XPath 函数会返回模型中任何对象的 URI。resolveURI() 函数会解析 URI。
例如,如果具有包含 URI 列的“类”数据集 (getURI(.)) 以及包含 containerURI 列的“操作”数据集 (getURI(..)),那么可使用该 URI 和 containerURI 来连接这两个数据集。
有关其他信息,请参阅“BIRT 的字段指南”中的主题“如何连接数据集”。
在生成报告时避免出现装入不可用字体的提示
如果报告用户在他们生成报告时接收到装入不可用字体的提示,请通过将字体设置为“自动”或通过在每个元素的“属性”视图中指定字体来修改报告设计。请不要使用诸如缺省有衬线字体之类的缺省字体。
例如,如果报告要求使用日语文本,那么在报告设计中使用缺省有衬线字体可导致出现下载中文字体的意外提示。
选择用于设计报告的最佳实例模型
设计报告时,请确保在设计时使用的实例模型是数据的代表,但是足够小从而不会妨碍报告设计任务的速度。在整个设计阶段,可能重新装入这些模型多次,因此使用较小的模型会节省时间。
用于开始报告设计的备用方法
除了使用“报告资源管理器”窗口来开始报告设计之外,可使用“BIRT 报告”向导。
要打开“报告资源管理器”窗口,请单击窗口 > 显示视图 > 其他,展开报告,并双击报告资源管理器
要打开“BIRT 新建报告”向导,请单击文件 > 新建,展开商业智能和报告工具,并双击报告
如果要以现有的报告设计作为基础来创建报告,请使用“报告资源管理器”窗口。
将 BIRT 报告作为插件来部署
要将 BIRT 报告作为插件来部署,请创建包含该报告并扩展 com.ibm.ccl.erf.birt 插件中名为 com.ibm.ccl.erf.birt.reports 的扩展点的插件。
要创建该插件:请开始新的插件项目并确保激活程序位于 /src 文件夹中。将包含该报告的 RPTDESIGN 文件添加至该项目,并将该项目的构建配置设置为将该报告包括在输出中。确保该构建配置将 bin 目录包括在二进制构建中。将 com.ibm.ccl.erf.birt 作为依赖项添加,并将 com.ibm.ccl.erf.birt.reports 设置为该插件的扩展点。对该扩展点,添加该报告的类别,然后将该报告本身添加至该类别。对于该报告的 URL,请使用平台插件路径:platform:/plugin/<plug-in name>/<path to RPTDESIGN file>
要部署该插件,请将它导出,将输出 JAR 文件复制到 IBM Rational 产品安装目录的 SDP\plugins 文件夹,并重新启动该产品。
注: 某些信息(例如与 Eclipse 文档或开发者指南的链接)只能从随产品安装的帮助主题中获取。

反馈