将 Rational® Publishing Engine 与 Rational DOORS® 集成时,可以直接从 Rational DOORS 中生成文档。
开始之前
检查您计划使用的
Rational DOORS 模块及其内容。要找到与您的
Rational DOORS 版本对应的信息中心,请参阅
关于 Rational DOORS 信息中心。
提示: 可以使用模块中存储的模块属性、对象属性和视图的组合。查看模块中的可用视图,以获取包含可跟踪性视图的计算列,或可能是布局 DXL 列。这些视图不与 Rational DOORS 属性对应,但可能是您希望包含在报告中的内容。
安装
在安装
Rational Publishing Engine 之前,安装
Rational DOORS。
Rational Publishing Engine 必须修改
Rational DOORS 创建的注册表键。
注: Windows 上的
Rational Publishing Engine 安装将更新
Rational DOORS 的几个注册表条目。如果
Rational DOORS 在
Rational Publishing Engine 之后安装,请打开
IBM® Installation Manager,然后单击
修改并完成
Rational Publishing Engine 的向导以重新设置
Rational DOORS 的配置。此操作将更新
Rational Publishing Engine 安装程序所进行的最新注册表更改。要手动更新注册表,请参阅
手动更新 Rational DOORS 注册表。
在 Rational Publishing Engine 安装期间,可以选择安装 Rational DOORS 附加组件。安装附加组件后,可以直接从 Rational DOORS 发布 Rational Publishing Engine 模板。
如果 Rational Publishing Engine 在 Rational DOORS 之前安装,那么不会更新注册表键,并且 Rational DOORS 找不到 Rational DOORS 附加组件中包含的发布插件。
构建模板
- 使用 Rational DOORS 模式发现向导来生成新模式。当您发现 Rational DOORS 模块的模式时,可以决定将使哪些属性和列可以在模板中使用。可以选择这些项目,并将它们置于模板中。请参阅使用模式发现向导添加 Rational DOORS 数据源模式。还可以在稍后设计模板时提升属性。属性向元素添加常规预定义关键字以外的说明信息。
只能通过标准 Rational DOORS 模式文件中的 Attribute 节点来访问用户定义的 Rational DOORS 属性。要使用这些属性,可以使用 XML 模式发现向导将属性值提升为 XML 属性。属性可能只出现一次,例如 Module Name 和 Last Modified On 属性。这些属性可能适用于某个对象,但是具有多个匹配项,例如,Object
Heading 和 Object Text。还可以发现哪些对象属性存在于 Rational DOORS 模块中,然后评估它们是否必须显示在您的 Rational Publishing Engine 报告中。使用菜单选择来访问模块中所包含属性的列表。
- 使用查询、属性和变量来向模板添加数据。
- 使用 Document Studio 设计模板。请参阅使用 Document Studio 来编写模板。当您连接至数据源模式之后,可以规划文档的结构以及定义内容以抽取数据。请参阅设计文档模板以获取模板开发过程的概述。对于大型文档,可以为每个文档块创建单独的模板。
- 构造一个公共容器元素,以容纳多个段。每个段都由一个测试条件控制,此条件将该段仅与源 Rational DOORS 模块中的特定数据关联。格式化控件和样式规范用于创建输出。请参阅将元素添加至模板。可以将容器元素(而非表)用于 1x1 表中所包含的 Rational DOORS Analyst 图。
- 根据 Rational DOORS 数据创建表格。请参阅添加表元素。没有直接支持能够将 Rational DOORS 表完全按其在 Rational DOORS 中的外观进行重现;可以使用可用的 Rational DOORS 表属性并生成新表。
使用
Rational DOORS 模式向导来抽取有关
Rational DOORS 表的信息。示例:
TableCellWidth –
Width of
Cell in screen pixels。请参阅
使用模式发现向导添加 Rational DOORS 数据源模式。有 2 种方法可从
Rational DOORS 抽取列信息:
- 可以使用 Data Source Configuration 元素来定义在运行时未知的某些属性。请参阅添加数据源配置元素。例如,可以添加一个尚未创建的 Rational DOORS 项目,并生成测试报告以供将来使用。
- 过滤器是通用数据源 URI 的详细版本;可以使用过滤器来指向特定的数据子集,以便使 Rational Publishing Engine 在报告生成期间仅尝试从数据源检索必需的信息。这些过滤器必须足够广泛,能够检索由模板引用的所有必需数据,否则生成的报告就无法包含完整的数据。请参阅使用本机过滤器抽取数据以了解有关如何使用 Rational Publishing Engine 本机过滤器的更多信息。
发布文档
- 当您完成报告模板创建并使用 Rational DOORS 数据点填充该模板之后,可以使用各种格式生成报告。生成报告时,您必须连接至包含报告中要包括的信息的数据源。要指向相关数据,请参阅连接至 Rational DOORS 数据源。
提示: 可以从
Rational DOORS 数据源抽取对象链接与嵌入 (OLE)。请参阅
OLE 对象。
- 如果在将某个模板分配给文档规范之后又向该模板添加了数据源模式,那么该文档规范将不同步。可以手动同步文档规范,或选择首选项来使文档规范与当前模板自动同步。请参阅设置文档设计首选项以获取有关如何设置是否使文档规范与当前模板保持同步?首选项的信息。
- 发布文档之前,请参阅指定输出属性主题,以获取有关可以选择的可用输出选项以及哪个选项对于模板中所使用元素最适用的更多信息。
- 您现在已准备就绪,可以发布文档。请参阅生成文档。
- 如果已安装 Rational DOORS 附加组件,那么可以直接从 Rational DOORS 用户界面发布。
要点: 对于本地文档生成,Rational Publishing Engine 可以连接至正在运行的 Rational DOORS 客户机,但是对于远程文档生成,该选项不可用。如果您从“数据库”或“模块”视图使用远程生成引擎进行发布,那么在生成文档之前,必须在文档规范中输入认证凭证,以使远程 Rational Publishing Engine 服务可以将新 Rational DOORS 无头客户机实例化,以便拉取报告数据。