与 Rational Publishing Engine 和其他 REST 客户机集成

IBM® Rational® Publishing Engine 1.1 可以通过将 Rational Change OSLC-CM 1.0 API 作为 REST 数据源添加来报告 Rational Change CR。有关添加新数据源的更多详细信息,请参阅 Rational Publishing Engine 文档。本主题中的详细信息有助于您将 Rational Change 与其他能够使用 REST 风格的 Web Service 的工具一起使用。要使用现有 Rational Change CR 查询或报告,请遵循该过程。

过程

  1. 使用现有查询和报告,以使用您现有的 Rational Change CR 查询或报告。
    1. 要查找指向查询报告服务的 URL,请遵循发现服务中的步骤。
    2. 将该 URL 输入到 Internet Explorer 7 或者 Firefox 3 或更新的浏览器窗口中,以浏览您的查询或报告。
    3. 找到所需的查询或报告,然后复制 URL。

      需要其他用户输入的报告(如趋势分析报告)不可用。如果使用 Internet Explorer 6,那么您下载的文档包含指向顶级文件夹的 URL。 在浏览器窗口中输入这些 URL,以查找这些文件夹的内容。重复此过程,直至您找到指向所需查询或报告的 URL。

    4. (可选)您可以按 API 规范中所述,通过传递 oslc_cm.properties 参数来定制从该 URL 返回的准确属性。该步骤对于 Rational Publishing Engine 通常不是必需的。它会根据您的文档规范,自动请求需要的属性。
    5. 在 Rational Publishing Engine 中创建文档规范时,请使用您复制的 URL 作为 REST 数据源的 URI。另外,请确保输入要运行查询或报告的用户的用户名和密码。
  2. 检索模式。

    在 Rational Publishing Engine Document Studio 中设计文档时,您需要一个数据源模式,用于描述从查询或报告返回的 CR。要检索模式,请针对查询或报告使用同一 URL,但向其附加以下行:

    ?metadata=schema

    例如:.../reports/personal/Assigned%20CRs?metadata=schema

    如果您更倾向于将 OSLC-CM 查询直接嵌入 URL 中,那么还可以将 metadata=schema 参数与从 simpleQuery 服务返回的 CR 一起使用。在 Rational Publishing Engine 中浏览模式时,CR 元素位于 feed/entry/content/ChangeRequest 下。


反馈