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

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

开始之前

熟悉 Rational® Tau UML 模型和从 Rational Publishing Engine 抽取数据所需的 Rational Tau 模式。要找到与您的 Rational Tau 版本对应的信息中心,请参阅关于 Rational Tau 和 Rational DOORS® Analyst 信息中心

过程

  1. 查看设计文档模板,以获取模板开发流程的概述。 开始规划文档的结构以及可包括的数据。 例如,决定是将从一个模板还是从多个模板文件(每个文件都包含可复用的内容部分)生成最终文档。
  2. 在 Document Studio 应用程序中,创建文档模板
  3. 识别数据源中的数据源模式。 可从下列其中一个选项识别 Rational Tau 的数据源模式:
    • 使用 Rational Publishing Engine 随附的预生成 Rational Tau 模式。 此数据源模式位于 RPE_HOME\source\Tau\schema\ttdMetamodel.xsd
    • Rational Tau UML 项目生成数据源模式。有关更多信息,请参阅检索 Rational Tau 数据源模式
  4. 将数据源模式添加至文档模板。 对于 Rational Tau,可完成下列步骤:
    1. 在 Document Studio 中,单击数据 > 添加数据源模式
    2. 预定义字段中,选择 Tau
    3. 类型中,从列表中选择模式类型。 对于 Rational Tau,选择 Tau
    4. 如果需要,编辑模式字段,或单击浏览以选择模式文件的路径。 示例:RPE_HOME\source\Tau\schema\ttdMetamodel.xsd
    5. 如果资源位于受保护的服务器中,请指定用户名
    6. 如果资源位于受保护的服务器中,请指定密码
    7. 从列表中选择认证类型 如果没有选择类型,那么会测试每种类型,直到找到正确的类型,这会延长文档生成时间。
  5. 将元素添加至模板。 Rational Publishing Engine 具有一组全面的模板元素,可以用于构造文档。可以将元素拖动到模板内容编辑器中。例如,可添加容器元素来保存若干段。 每段都可由一个测试条件控制,该条件使该段仅与特定数据关联。关于更多信息,请参阅“选用板”视图中的模板元素将元素添加至模板
  6. 使用查询属性变量来向模板添加数据。这些项指定会在报告中生成哪些信息部分。 IBM Rational Tau 中的查询在语法上类似于 XPath 语法。然而,与 XPath 不同,Rational Publishing Engine 查询并不指定过滤器;过滤器和排序子句已与查询分开。通过 Rational Tau 本机查询来定义每个模式元素(查询除外)。此查询表示为 OCL,用于访存 Rational Tau 数据。例如,模型元素 model.rootResource 下的根元素附加了 GetModelRoots() Rational Tau 查询。
    注:
    • 无法在 Rational Tau 数据源模式中创建定制属性。
    • 无法从 Launcher 或 Document Studio 应用程序预览 Rational Tau
  7. 格式设置和样式添加至这些元素,以控制它们在输出中的显示方式。
  8. 创建过滤器,以精简拉入报告中的数据。 过滤器是通用数据源 URI 的详细版本;可以使用过滤器来指向特定的数据子集,以便使 Rational Publishing Engine 在报告生成期间仅尝试从数据源检索必需的信息。这些过滤器必须足够广泛,能够检索由模板引用的所有必需数据,否则生成的报告就无法包含完整的数据。 另请参阅 REST 本机过滤器支持的过滤条件,以获取更多信息。
  9. 可以使用强制类型转换查询过滤器来优化查询结果。强制类型转换功能用作数据源元素的备用过滤器,请参阅强制类型转换Rational Tau 属性以获取详细信息。
  10. 创建排序,以对报告中的数据进行组织。 Rational Tau 数据源不支持本机排序。请使用 Rational Publishing Engine 排序。

示例

表 1. Rational Tau 多模板文档示例
模板文件名 模板内容 使用说明
titlePage.dta 标题页面和目录 从模块属性生成标题页面
Preamble.dta 引言章节 包含一个含有引言章节的 Microsoft Word 文件
Requirements.dta 系统需求 从数据源生成列出系统需求的数据
userRequirements.dta 用户需求 从数据源生成列出用户需求的数据
Design.dta 建模信息 从数据源生成列出 UML 模型信息的数据

反馈