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

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

开始之前

提示: Rational® Publishing Engine 安装附带一个样本报告集。开始发布文档之前,可以浏览此示例文档生成方案。请参阅创建 REST 样本模板
熟悉使用 Rational Publishing Engine 抽取数据的 Rational RequisitePro® 需求。要找到适用于 Rational RequisitePro 版本的信息中心,请参阅关于 Rational RequisitePro 信息中心

关于此任务

使用 REST API 来截取数据。此接口通过数据源应用程序安装和实现,独立于 Rational Publishing Engine 工作。有关数据源的 REST API 的更多信息,请参阅该数据源的文档。

过程

  1. 查看设计文档模板,以获取模板开发流程的概述。 开始规划文档的结构以及可包括的数据。 例如,决定是将从一个模板还是从多个模板文件(每个文件都包含可复用的内容部分)生成最终文档。
  2. 在 Document Studio 应用程序中,创建文档模板
  3. 将数据源模式添加至文档模板。 对于 Rational RequisitePro,可通过输入应用程序的基本 URL 来发现数据源模式。
    1. 在 Document Studio 中,单击数据 > 模式发现 > REST 模式发现
    2. 为数据源输入名称
    3. 为数据源输入描述
    4. 指定资源的基本 URL
    5. 从列表中选择认证类型 对于数据服务提供的 Rational RequisitePro 适配器,必须指定 Basic 认证。如果没有选择类型,那么会测试每种类型,直到找到正确的类型,这会延长文档生成时间。
    6. 如果资源位于受保护的服务器中,请指定用户名
    7. 如果资源位于受保护的服务器中,请指定密码
    8. 单击下一步 会对您输入的基本 URL 自动追加 ?metadata=schema
    9. 单击完成 您选择的数据源模式会显示在“数据源模式”视图中。
  4. 将元素添加至模板。 Rational Publishing Engine 具有一组全面的模板元素,可以用于构造文档。可以将元素拖动到模板内容编辑器中。例如,可添加容器元素来保存若干段。 每段都可由一个测试条件控制,该条件使该段仅与特定数据关联。关于更多信息,请参阅“选用板”视图中的模板元素将元素添加至模板
  5. 使用查询属性变量来向模板添加数据。这些项指定会在报告中生成哪些信息部分。
  6. 格式设置和样式添加至这些元素,以控制它们在输出中的显示方式。
  7. 创建过滤器,以精简拉入报告中的数据。 过滤器是通用数据源 URI 的详细版本;可以使用过滤器来指向特定的数据子集,以便使 Rational Publishing Engine 在报告生成期间仅尝试从数据源检索必需的信息。这些过滤器必须足够广泛,能够检索由模板引用的所有必需数据,否则生成的报告就无法包含完整的数据。 在可报告 Rest V1 本机过滤器中,只需要在方括号 [] 之间输入文本。过滤器的其余部分由 Rational Publishing Engine 生成。 以下可报告 Rest V1 本机过滤器示例通过使用 Stability='High' 来抽取 Rational RequisitePro PRRequirements 模式。
    将过滤表达式添加至 Appliances 下方的节点,以便仅选择由特定制造商所制造的设备。
    fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
  8. 创建排序,以对报告中的数据进行组织。 Rational RequisitePro 不支持使用本机排序。相反地,可以在 Rational RequisitePro 中创建排序:
    1. 创建表并输入数据。
    2. 对数据进行排序。
    3. 创建视图并将数据保存至视图。
    4. 导出视图以用作 Rational Publishing Engine 中的数据源模式。Reporting Data Services 应用程序会自动检测视图。
    5. 将数据源模式添加至 Rational Publishing Engine 模板。
    Rational Publishing Engine 输出中生成的 Rational RequisitePro 数据会保留视图的排序,但有些嵌套数据可能不会显示为嵌套。

反馈