创建 UML 数据集

“统一建模语言”(UML) 数据集是采用表格式的数据库,它的行和列从 UML 数据源中进行映射。该数据集已设置格式,因此可使用商业智能和报告工具 (BIRT) 来从它生成报告。

开始之前

要使用的数据源在开始此活动之前必须存在。如果要创建新的数据源,请参阅相关任务“创建 UML 数据源”。

过程

  1. 打开“报告资源管理器”视图。单击窗口 > 显示视图 > 其他 > 报告 > 报告资源管理器
  2. 在“报告资源管理器”视图中,右键单击报告设计;然后单击打开
  3. 打开“数据资源管理器”视图。单击窗口 > 显示视图 > 其他 > 报告设计 > 数据资源管理器
  4. 在“数据资源管理器”视图中,右键单击数据集,然后单击新建数据集

    如果需要连接多个表中的数据,那么还可以单击新建连接数据集。有关其他信息,请参阅“BIRT 的字段指南”中的主题“如何连接数据集”。

  5. 输入数据集的名称,选择 UML 数据集作为类型,选择数据源,然后单击下一步
  6. 在“查询参数”页面上,列示在数据集中定义查询所需的全部查询参数,然后单击下一步 可使用此页面来添加、除去和重命名参数以及对参数重新排序。此页面上的参数由参数的内部名称标识。该内部名称是在 XPath 表达式中使用的名称,因此它必须符合变量的 XPath 命名约定;它必须以字母或下划线 (_) 开头,并且可包含任何序列的字母、数字或下划线字符。在此页面上进行的更改还会显示在“参数”页面上;请参阅步骤 10。

    参数是灵活的很有效工具,允许您将大量特殊类型的信息包括在报告中。有关可如何使用参数的信息,请参阅名为“EMF 和 UML 数据集中的参数”的相关概念。

    注: 在定义参数之后,可通过使用其内部名称(前加美元符号 ($))来在行映射和列映射查询中引用该参数。
  7. 定义数据集的行映射。 可定义一组形成表行并且指定元素类型的元素。要定义行映射,请完成下列步骤:
    1. 进行浏览以选择其中一个在所使用数据源中指定的模型。
    2. 要定义行映射,请指定 XPath 表达式。 例如,要映射模型中的所有类,表达式应为 //Class,而类型为 Class
      注: 编写行映射 XPath 表达式时,请记住根是资源实例。有关 XPath 语法的更多信息,请参阅本主题末尾的相关链接。
      可直接输入该表达式,也可从 EMF 结构中的元素构建该表达式,可通过在 EMF 结构中选择节点,然后单击向右箭头 (>) 按钮来将这些元素添加至表达式字段。
    3. 如果该表达式从作为上下文的参数开始,而不是从资源的根开始,那么可取消选中对应于针对每个数据源实例模型进行评估复选框。 这会提高性能,因为不需要对每个资源运行该表达式。
    4. 在 EMF 结构中选择具有该 XPath 表达式所需的类型的元素,然后单击类型字段的向右箭头 (>) 按钮。 例如,对于 //Class,结果类型为 Class
    5. 指定要包括在数据集中的任何构造型。
    6. 单击下一步
  8. 定义数据集的表列。 对于列定义 XPath 表达式,根是为前一步骤中的返回类型指定的类型的对象。可采用下列方法定义列:直接在矩阵中输入列的值,或者完成下列步骤:
    1. 单击浏览以显示要浏览的类型。
    2. 选择树中要用作表列的条目,然后单击向右箭头 (>) 按钮。
    3. 指定所需的所有列。可以删除列,也可以通过单击“列映射”矩阵右边的按钮来更改列的顺序。
    4. 必要时,为每列调整“查询”和“类型”的值。
  9. 配置表之后,单击完成 这会打开“编辑数据集”窗口。
  10. 如果数据集包含参数,请使用“编辑数据集”窗口的“参数”页面来完成这些参数的定义。指定显示名称(最初设置为内部名称)、类型(最初设置为 String)、方向(最初设置为 Input)以及要绑定至数据集参数的报告参数(如果有)的名称。 在“属性绑定”页面上将值绑定至数据集参数时,可使用参数显示名称。
  11. 可继续进行编辑,单击预览结果以检查所作工作,或单击确定以关闭窗口。
    注: 要在任何时候修改数据集,请在“数据资源管理器”视图中,右键单击数据集,然后单击编辑

下一步做什么

现在,可使用 BIRT 功能部件来完成报告设计,从而合并数据集中的元素。有关信息,请参阅“BIRT 的字段指南”
注: 某些信息(例如与 Eclipse 文档或开发者指南的链接)只能从随产品安装的帮助主题中获取。

反馈