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 查询或报告,请遵循该过程。
过程
- 使用现有查询和报告,以使用您现有的 Rational Change CR 查询或报告。
- 要查找指向查询或报告服务的 URL,请遵循发现服务中的步骤。
- 将该 URL 输入到 Internet Explorer 7 或者 Firefox 3 或更新的浏览器窗口中,以浏览您的查询或报告。
- 找到所需的查询或报告,然后复制 URL。
需要其他用户输入的报告(如趋势分析报告)不可用。如果使用 Internet Explorer
6,那么您下载的文档包含指向顶级文件夹的 URL。
在浏览器窗口中输入这些 URL,以查找这些文件夹的内容。重复此过程,直至您找到指向所需查询或报告的 URL。
- (可选)您可以按 API 规范中所述,通过传递 oslc_cm.properties 参数来定制从该 URL 返回的准确属性。该步骤对于 Rational Publishing
Engine 通常不是必需的。它会根据您的文档规范,自动请求需要的属性。
- 在 Rational Publishing Engine 中创建文档规范时,请使用您复制的 URL 作为 REST 数据源的 URI。另外,请确保输入要运行查询或报告的用户的用户名和密码。
- 检索模式。
在 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 下。