使用 Rational® Focal Point™ 来捕获客户、项目干系人和市场研究的业务需要并划分业务需要的优先级,以决定哪项业务需要可以给业务带来最大价值。
提示: Rational Publishing Engine 安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅
创建 REST 样本模板。
开始之前
- 熟悉使用 Rational Publishing Engine 时从 Rational Focal Point 抽取数据所需的 Rational Focal Point REST 服务和各种 URL。要找到适用于 Rational Focal Point 版本的信息中心,请参阅关于 Rational Focal Point 信息中心。
- 连接至数据源模式。请参阅添加数据源模式。
- 连接至数据源模式之后,可以规划文档的结构并定义内容以抽取数据。请参阅设计文档模板,以获取模板开发流程的概述。对于大型文档,可以为每个文档块创建单独的模板。
- Rational Publishing Engine 具有可用来构造文档的全面模板元素集。只需将元素拖到模板内容编辑器。有关更多详细信息,请参阅 “选用板”视图中的模板元素。
- 连接至数据源模式之后,可以规划文档的结构并定义内容以抽取数据。请参阅使用 Document Studio 来编写模板。可以导入包含母版页、标题和部分的现有模板。
- 使用查询、属性和变量将数据添加至模板。
- 可以使用数据源配置元素来定义运行时的一些未知属性。请参阅添加数据源配置元素。例如,可以添加 Rational Focal Point 项目并生成报告。
- 可以使用过滤器(常规数据源 URI 的更具体版本)来指向特定的数据子集,以免 Rational Publishing Engine 在生成报告期间尝试从数据源检索额外的信息。这些过滤器必须足够广泛才能检索到模板引用的所有必需数据,否则生成的报告无法包含完整数据集。请参阅使用本机过滤器来抽取数据。
- 创建报告模板并填之以 Rational Focal Point 数据点之后,可以生成各种格式的报告。生成报告时,必须通过指定一个指向 Rational Focal Point 存储库(内含相关数据)的 URI 来连接至包含信息的数据源。
- 要确定 Rational Focal Point 的典型数据源 URI,请采用数据源模式 URL(已用来将模式添加至模板),并删除 ?metadata=schema 后缀。例如,如果模板中使用的数据源模式 URL 是 http://server:port/fp/resources/?metadata=schema,那么相应的数据源 URI 是 http://server:port/fp/resources。
- 如果您计划访问的数据包含在较小的模式部分内,那么可以构造更具体的 URI。例如,http://server:port/fp/resources/workspaces/4/modules/1/elements/?metadata=schema 会返回所有条件资源元素的 id 字段,而 http://server:port/fp/resources/workspaces/4/modules/1/elements/ 会返回所有项目资源元素的 id 字段和 summary 字段。
请参阅连接至数据源。
- 如果在将某个模板分配给文档规范之后又向该模板添加了数据源模式,那么该文档规范将不同步。可以手动同步文档规范,或选择首选项来使文档规范与当前模板自动同步。请参阅设置文档设计首选项以获取有关如何设置是否使文档规范与当前模板保持同步?首选项的信息。
- 发布文档之前,请参阅指定输出属性主题,以获取有关可以选择的可用输出选项以及哪个选项对于模板中所使用元素最适用的更多信息。
- 发布文档之前,请参阅此主题设置输出格式,以了解可供您选择的可用输出选项。
- 您现在已准备就绪,可以发布文档。请参阅生成文档。