“Eclipse 建模框架”(EMF) 数据集是采用表格式的数据库,它的行和列从 EMF 数据源中进行映射。该数据集已设置格式,因此可使用商业智能和报告工具
(BIRT) 来从它生成报告。
开始之前
要使用的数据源在开始此任务之前必须存在。要创建新的数据源,请参阅名为“创建 EMF 数据源”的相关任务。
过程
- 打开“报告资源管理器”视图。单击。
- 在“报告资源管理器”视图中,右键单击报告设计;然后单击打开。
- 打开“数据资源管理器”视图。单击。
- 在“数据资源管理器”视图中,右键单击数据集,然后单击新建数据集。
如果需要连接多个表中的数据,那么还可以单击新建连接数据集。有关其他信息,请参阅“BIRT 的字段指南”中的主题“如何连接数据集”。
- 输入数据集的名称,选择 EMF 数据集作为类型,选择数据源,然后单击下一步。
- 在“查询参数”页面上,列示在数据集中定义查询所需的全部查询参数,然后单击下一步。 可使用此页面来添加、除去和重命名参数以及对参数重新排序。此页面上的参数由参数的内部名称标识。该内部名称是在
XPath 表达式中使用的名称,因此它必须符合变量的 XPath 命名约定;它必须以字母或下划线
(_) 开头,并且可包含任何序列的字母、数字或下划线字符。在此页面上进行的更改还会显示在“参数”页面上;请参阅步骤 10。
参数是灵活的很有效工具,允许您将大量特殊类型的信息包括在报告中。有关可如何使用参数的信息,请参阅名为“EMF 和 UML 数据集中的参数”的相关概念。
注: 在定义参数之后,可通过使用其内部名称(前加美元符号 ($))来在行映射和列映射查询中引用该参数。
- 定义数据集的行映射。 可定义一组形成表行并且指定元素类型的元素。要定义行映射,请完成下列步骤:
- 进行浏览以选择其中一个在所使用数据源中指定的模型。
- 要定义行映射,请指定 XPath 表达式。 例如,要映射模型中的所有类,表达式应为 //Class,而类型为 Class。
注: 编写行映射
XPath 表达式时,请记住根是资源实例。有关 XPath 语法的更多信息,请参阅本主题末尾的相关链接。
可直接输入该表达式,也可从
EMF 结构中的元素构建该表达式,可通过在 EMF 结构中选择节点,然后单击向右箭头 (>)
按钮来将这些元素添加至表达式字段。
- 如果该表达式从作为上下文的参数开始,而不是从资源的根开始,那么可取消选中对应于针对每个数据源实例模型进行评估复选框。 这会提高性能,因为不需要对每个资源运行该表达式。
- 在 EMF 结构中选择具有该 XPath 表达式所需的类型的元素,然后单击类型字段的向右箭头 (>) 按钮。 例如,对于 //Class,结果类型为 Class。
- 单击下一步。
- 定义数据集的表列。 对于列定义 XPath 表达式,根是为前一步骤中的返回类型指定的类型的对象。可采用下列方法定义列:直接在矩阵中输入列的值,或者完成下列步骤:
- 单击浏览以显示要浏览的类型。
- 选择树中要用作表列的条目,然后单击向右箭头
(>) 按钮。
- 指定所需的所有列。可以删除列,也可以通过单击“列映射”矩阵右边的按钮来更改列的顺序。
- 必要时,为每列调整“查询”和“类型”的值。
- 配置表之后,单击完成。 这会打开“编辑数据集”窗口。
- 如果数据集包含参数,请使用“编辑数据集”窗口的“参数”页面来完成这些参数的定义。指定显示名称(最初设置为内部名称)、类型(最初设置为
String)、方向(最初设置为 Input)以及要绑定至数据集参数的报告参数(如果有)的名称。 在“属性绑定”页面上将值绑定至数据集参数时,可使用参数显示名称。
- 可继续进行编辑,单击预览结果以检查所作工作,或单击确定以关闭窗口。
注: 要在任何时候修改数据集,请在“数据资源管理器”视图中,右键单击数据集,然后单击编辑。
下一步做什么
现在,可使用 BIRT 功能部件来完成报告设计,从而合并数据集中的元素。有关信息,请参阅“BIRT 的字段指南”
。
注: 某些信息(例如与 Eclipse 文档或开发者指南的链接)只能从随产品安装的帮助主题中获取。