在将 Rational DOORS 用作数据源的情况下设计模板

报告设计者可使用 Document Studio 来导入数据源模式和构建报告模板。

开始之前

提示: Rational® Publishing Engine 安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅创建 Rational DOORS® 样本模板
检查您计划使用的 Rational DOORS 模块及其内容。要找到与您的 Rational DOORS 版本对应的信息中心,请参阅关于 Rational DOORS 信息中心

可以使用模块中存储的模块属性、对象属性和视图的组合。查看模块中的可用视图,以获取包含可跟踪性视图的计算列,或可能是布局 DXL 列。这些视图不与 Rational DOORS 属性对应,但可能是您希望包含在报告中的内容。

过程

  1. 查看设计文档模板,以获取模板开发流程的概述。 开始规划文档的结构以及可包括的数据。 例如,决定是将从一个模板还是从多个模板文件(每个文件都包含可复用的内容部分)生成最终文档。
  2. 在 Document Studio 应用程序中,创建文档模板
  3. 识别数据源中的数据源模式。 可通过两种方式来添加数据源:通过“DOORS 模式发现”向导或“数据源模式”向导。要使用“数据源模式”向导添加数据源,请执行以下操作:
    1. 在 Document Studio 中,单击数据 > 添加数据源模式
    2. 预定义字段中,选择 Doors 数据库模式。
    3. 类型中,从列表中选择模式类型。 针对 Rational DOORS,选择 DOORS
    4. 如果需要,编辑模式字段,或单击浏览以选择模式文件的路径。
    5. 如果资源位于受保护的服务器中,请指定用户名
    6. 如果资源位于受保护的服务器中,请指定密码
    7. 从列表中选择认证类型 针对 Rational DOORS,认证类型为 OAuth-OSLC。如果没有选择 OAuth-OSLC,那么会测试每种认证类型,直到找到正确的类型,这会延长文档生成时间。

    要使用“DOORS 模式发现”向导添加数据源,请执行以下操作:

    1. 在 Document Studio 中,单击数据 > 模式发现 > DOORS 模式发现
    2. 指定连接详细信息:
      • 要使用正在运行的 Rational DOORS 实例,请选择使用正在运行的 DOORS 实例
      • 要在后台运行 Rational DOORS,请选择运行新的后台 DOORS 进程。 指定用户名、密码、数据库和 doors.exe 的路径。
    3. 选择视图:
      • “数据库”视图
      • “项目”视图
    4. 单击下一步
    5. 选择属性类型:
      • 要向主要对象 Module/Object 模式元素添加属性,请选择模块和对象属性
      • 要为链接对象 Module/Object/Link/Linked 模式元素添加属性,请选择链接对象的属性
    6. 在“DOORS 模块选择”窗口中,从 Rational DOORS 数据库结构选择模块,然后单击下一步
    7. 在“DOORS 基线”窗口中,为模块选择基线。您选择的基线将确定要使用的属性集。
    8. 在“DOORS 属性”窗口中,将显示以下属性信息:
      • 属性名称:列出选定基线中可用的属性。
      • 作用域:将属性的作用域显示为模块或对象。
      • 提升名称:属性的提升名称是脚本表达式中使用的名称。将从 Rational DOORS 属性名称生成一个有效名称,以防止输入无效值。提升的属性允许直接从 Module/Object 上下文访问该属性值。非提升的属性值只能从 Module/Object/Attribute 上下文访问。

      选中复选框以指定属性,或单击全选以选择所有属性。全部不选将清除所有属性。单击下一步

    9. 在“DOORS 视图和列”窗口中,选择视图。然后选中某个列名的复选框以选择该列,或单击全选以选择所有列名。单击下一步
      注: 列的提升名称将显示在提升名称列中。可以从任意数目的视图提升列。可在以后设计模板时提升属性。 属性将声明式信息添加到除了通常的预定义关键字之外的元素。只能通过标准 Rational DOORS 模式文件中的 Attribute 节点来访问用户定义的 Rational DOORS 属性。要使用这些属性,可以使用 XML 模式发现向导将属性值提升为 XML 属性。属性可以具有单个实例,例如 Module NameLast Modified On 属性。属性可能适用于某个对象,但是具有多个实例,例如,Object HeadingObject Text
    10. 在“选择模式选项”窗口中,为以下字段输入详细信息:
      • 选择模式位置:单击浏览以选择用于保存数据源模式的位置。
      • 数据源模式标识:输入数据源模式的标识。
      • 选中将数据源模式添加至当前模板复选框,以将此模式添加至打开的模板。单击下一步
      • 保存模式,以便无需再次运行“模式发现向导”就可以在其他模板中复用这些模式。
    11. 查看摘要窗口中的信息,然后单击完成
  4. 处理属性。 可发现哪些对象属性存在于 Rational DOORS 模块中,然后评估它们是否必须出现在 Rational Publishing Engine 报告中。 可使用编辑 > 属性菜单选择来访问模块中所包含属性的列表。
  5. 将元素添加至模板。 Rational Publishing Engine 具有一组全面的模板元素,可以用于构造文档。可以将元素拖动到模板内容编辑器中。例如,可添加容器元素来保存若干段。 每段都可由一个测试条件控制,该条件使该段仅与特定数据关联。关于更多信息,请参阅“选用板”视图中的模板元素将元素添加至模板
    容器元素
    可以将容器元素(而非表)用于 1x1 表中所包含的 Rational DOORS Analyst 图。
    图像元素
    使用属性值从 Rational DOORS 模块抽取图像。无法只查询图像。
    要配置抽取图像的大小,请指定图像最大宽度图像最大高度属性。可以在两个位置指定这些属性:
    • 元素格式信息定义该模板元素中所含图像的大小。仅适用于文本模板元素。
    • 文档规范元数据定义所有模板中的图像的大小。元素格式值覆盖这些全局值。
    表元素
    可能无法将Rational DOORS 表准确重现在 Rational Publishing Engine 中,正如在 Rational DOORS 中一样;您可以使用可用的 Rational DOORS 表属性,并生成新表。
    使用 Rational DOORS 模式向导来截取有关 Rational DOORS 表的信息。示例:TableCellWidthWidth of Cell in screen pixels。存在以下两种用于从 Rational DOORS 中截取列信息的方法:
    • 使用 module/object/column 来获取对象查询中的列名称和值。当 Rational DOORS 数据按对象迭代时,这种做法很有用。
    • 使用 module/view/column 来从用于文档生成的 Rational DOORS 视图获取列名。需要当前视图中定义的列及其属性时,“按视图迭代”很有用。可以使用 Rational Publishing Engine 样本模板来测试这些方法。
      注: 要访问列数据,请在查询中使用 module/object/column/(@Column Text)

    如果在 Rational DOORS 表中具有跨多个行的单元格,那么 Rational Publishing Engine 会生成第一个单元格并且跨度中的其余单元格会除去。

    有关表的更多信息,请参阅添加表元素

  6. 使用查询属性变量来向模板添加数据。这些项指定会在报告中生成哪些信息部分。 IBM® Rational DOORS 中的查询的开头是根元素(模块),接着是其子元素(对象),然后是对象的子属性。例如,Module/Object/Attribute/Name。有关更多信息,请参阅Rational DOORS 模式
  7. 格式设置和样式添加至这些元素,以控制它们在输出中的显示方式。
  8. 创建过滤器,以精简拉入报告中的数据。 过滤器是通用数据源 URI 的详细版本;可以使用过滤器来指向特定的数据子集,以便使 Rational Publishing Engine 在报告生成期间仅尝试从数据源检索必需的信息。这些过滤器必须足够广泛,能够检索由模板引用的所有必需数据,否则生成的报告就无法包含完整的数据。 可以在链接查询上定义本机过滤器。有关更多信息,请参阅示例:Rational DOORS 本机过滤器
  9. 创建排序,以对报告中的数据进行组织。 对于 Rational DOORS,本机排序文本必须采用 Rational DOORS 排序的格式。 有关更多信息,请参阅示例:Rational DOORS 中的本机排序

下一步做什么

如果从 Document Studio 应用程序预览数据,那么会使用缺省基线和视图来检索数据。

反馈