可以将 Rational® Requirements Composer 定义为 Rational Publishing Engine 中的数据源。
提示: Rational Publishing Engine 安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅
创建 REST 样本模板。
开始之前
- 熟悉使用 Rational Publishing Engine 时从 Rational Requirements Composer 抽取数据所需的 Rational Requirements Composer REST 服务和各种 URL。要找到与您的 Rational Requirements Composer 版本对应的信息中心,请参阅关于 Rational Requirements Composer 信息中心。
- 连接至数据源模式。请参阅添加数据源模式。
- 模式可以位于本地文件系统上。例如,https://server:port/jts/service/com.ibm.rrc.project.artifacts.xsd 是一个使用 artifacts 参数的模式文件。可以使用此模式从 Rational Requirements Composer 项目添加特定数据部分。
- 模式可以是可从计算机访问的任何 URI。打开数据源模式,然后从 XML 文件中获取特定资源的 URI。在 URI 末尾添加 ?metadata=schema。典型的 URI 是:https://server:port/jts/service/com.ibm.rrc.project.artifacts?metadata=schema。
- 可以使用数据源模式中的元素在模板中添加查询。这些查询指定在报告中生成的信息。
- 连接至数据源模式之后,可以创建或导入模板设计。使用 Rational Publishing Engine Document Studio,可以构建报告模板设计。此设计将确定报告的布局。请参阅使用 Document Studio 来编写模板。
- 连接至数据源模式之后,可以规划文档的结构并定义内容以抽取数据。请参阅设计文档模板,以获取模板开发流程的概述。对于大型文档,可以为每个文档块创建单独的模板。
- Rational Publishing Engine 具有可用来构造文档的全面模板元素集。可以将元素拖到模板内容编辑器。有关更多详细信息,请参阅 “选用板”视图中的模板元素。
- 使用查询、属性和变量将数据添加至模板。
- 可以使用数据源配置元素来定义运行时的一些未知属性。请参阅添加数据源配置元素。例如,可以使用此模式 - https://server:port/jts/service/com.ibm.rrc.project.artifacts.xsd,并从 Rational Requirements Composer 项目针对模板中的特定数据部分,动态配置此模式。
- 可以使用过滤器(常规数据源 URI 的更具体版本)来指向特定的数据子集,以免 Rational Publishing Engine 在生成报告期间尝试从 Rational Requirements Composer 存储库检索额外的信息。这些过滤器必须足够广泛才能检索到模板引用的所有必需数据,否则生成的报告无法包含完整数据集。请参阅使用本机过滤器来抽取数据。
- 创建报告模板并填之以 Rational Requirements Composer 数据点之后,可以生成各种格式的报告。生成报告时,必须通过指定一个指向 Rational Requirements Composer 存储库(内含相关数据)的 URI 来连接至包含信息的数据源。请参阅连接至数据源。
- 如果在将某个模板分配给文档规范之后又向该模板添加了数据源模式,那么该文档规范将不同步。可以手动同步文档规范,或选择首选项来使文档规范与当前模板自动同步。请参阅设置文档设计首选项以获取有关如何设置是否使文档规范与当前模板保持同步?首选项的信息。
- 发布文档之前,请参阅指定输出属性主题,以获取有关可以选择的可用输出选项以及哪个选项对于模板中所使用元素最适用的更多信息。
- 您现在已准备就绪,可以发布文档。请参阅生成文档。
注: 从 Rational Requirements Composer 创建并发布文档。