通过 OSLC 服务扩展 Rational DOORS

生命周期协作开放服务 (OSLC) 是将生命周期工具协作的方式标准化的社区。IBM® Rational® DOORS® 以“需求管理”领域的提供者或 Rational 产品服务组合中其他领域的使用者身份来支持 OSLC 数据共享规范。

域之间的 OSLC 数据共享基于一组常用的资源、格式和 REST 体系结构服务。

数据共享支持以下事务:
  • 基于 HTTP 协议的链接
  • 按 URI 的资源识别
  • 使用行业标准介质类型的信息检索

Rational DOORS V9.3 快速指南

下表列出了 Rational DOORS V9.3 使用的 OSLC 域和服务,以及可通过这些域中的资源执行的操作。
表 1. Rational DOORS V9.3 的相关 OSLC 域和操作
DOORS 9.3 选择 创建 预览(密集呈现)
变更管理 V1 受支持 受支持 受支持

下表列出了跨各种规程链接工件时使用的 OSLC 关系:

表 2. DOORS V9.3 中变更管理 V1 规程间的链接
变更管理 V1 间的链接
出局链接 入局链接
http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

Rational DOORS V9.4 快速指南

下表列出了 Rational DOORS V9.4 使用的 OSLC 域和服务,以及可通过这些域中的资源执行的操作。

表 3. Rational DOORS V9.4 的相关 OSLC 域和操作
DOORS 9.4 选择 创建 预览(密集呈现)
变更管理 V1 受支持 受支持 受支持
变更管理 V2 受支持 受支持 受支持
质量管理 V1 受支持 受支持 受支持
质量管理 V2 受支持 受支持 受支持
需求管理 V1* 受支持 受支持 受支持
需求管理 V2* 受支持 受支持 受支持
体系结构管理 V2 受支持 受支持 受支持
*DOORS 9.4 不应配置为使用其自己的 OSLC 接口。该支持仅用于跨存储库通信。

下表列出了跨各种规程链接工件时使用的 OSLC 关系:

表 4. 变更管理 V1 规程间的链接
变更管理 V1 间的链接
出局链接 入局链接
实现者

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy

实现

http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

表 5. 变更管理 V2 规程间的链接
变更管理 V2 间的链接
出局链接 入局链接
影响人

http://open-services.net/ns/rm#affectedBy

影响

http://open-services.net/ns/cm#affectsRequirement

实现者

http://open-services.net/ns/rm#implementedBy

实现

http://open-services.net/ns/cm#implementsRequirement

跟踪人

http://open-services.net/ns/rm#trackedBy

跟踪

http://open-services.net/ns/cm#tracksRequirement

表 6. 质量管理 V1 规程间的链接
质量管理 V1 间的链接
出局链接 入局链接
验证人

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatedBy

验证

http://jazz.net/xmlns/prod/jazz/calm/1.0/validatesRequirement

表 7. 质量管理 V2 规程间的链接
质量管理 V2 间的链接
出局链接 入局链接
验证人

http://open-services.net/ns/rm#validatedBy

验证

http://open-services.net/ns/qm#validatesRequirement

验证人

http://open-services.net/ns/rm#validatedBy

验证

http://open-services.net/ns/qm#validatesRequirementCollection

表 8. 需求管理 V1 规程间的链接
需求管理 V1 间的链接
出局链接 入局链接
阐述人

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratedBy

阐述

http://jazz.net/xmlns/prod/jazz/calm/1.0/elaboratesRequirement

表 9. 需求管理 V2 规程间的链接
需求管理 V2 间的链接
出局链接 入局链接
阐述人

http://open-services.net/ns/rm#elaboratedBy

阐述

http://open-services.net/ns/rm#elaborates

指定人

http://open-services.net/ns/rm#specifiedBy

指定

http://open-services.net/ns/rm#specifies

表 10. 体系结构管理 V2 规程间的链接
体系结构管理 V2 间的链接
出局链接 入局链接
不适用 阐述

http://jazz.net/ns/dm/linktypes#elaborates

不适用 指定

http://purl.org/dc/terms/relation

“需求管理”域中的以下用户界面 (UI) 元素和操作受 Rational DOORS 的支持并在其中提供。

OSLC RM V1 UI 元素和操作

OSLC RM V1 界面在 DOORS 9.3 及更高版本中可用。

为 RM V1 实施了以下 UI 元素:
  • 用于需求资源分段的委派用户界面。
  • 用于创建需求资源的委派用户界面。
  • 用于选择需求集合资源(视图)的委派用户界面。
  • 需求资源的密集呈现(丰富悬浮呈现)。
  • 需求集合资源(视图)的密集呈现(丰富悬浮呈现)。
  • 以编程方式创建需求资源所需的工厂资源。
为 RM V1 实施了以下操作:
  • 服务发现。
  • 针对需求创建的 POST 操作。POST 将作为模块中的第一个对象来创建一个新需求。
  • 对需求集合执行的 GET 操作。
  • 对需求集合执行的 PUT 操作
  • 对需求执行的 GET 操作。
  • 对需求执行的 PUT 操作。

POST 在服务发现树的数据库级别不可用。

需求集合 URI 会引用某个模块或某个应用了视图的模块。

DOORS 内部链接(入局或出局)未在 VI GET 结果中显示。

DOORS 外部链接未在 VI GET 结果中显示。

有关更多信息,请参阅 OSLC RM V1 规范

OSLC RM V2 UI 元素和操作

OSLC RM V2 界面在 DOORS 9.4 及更高版本中可用。

为 RM V2 实施了以下 UI 元素:
  • 用于需求资源分段的委派用户界面。
  • 用于创建需求资源的委派用户界面。
  • 用于选择需求集合资源(视图)的委派用户界面。
  • 需求资源的密集呈现(丰富悬浮呈现)。
  • 需求集合资源(视图)的密集呈现(丰富悬浮呈现)。
  • 以编程方式创建需求资源所需的工厂资源。
为 RM V2 实施了以下操作:
  • 服务发现。
  • 资源定形。
  • 针对需求创建的 POST 操作。POST 将作为模块中的第一个对象来创建一个新需求。
  • 对需求集合执行的 GET 操作。
  • 对需求集合执行的 PUT 操作
  • 对需求执行的 GET 操作。
  • 对需求执行的 PUT 操作。
  • 在模块级别也支持 QUERY 操作。

POST 在服务发现树的数据库级别不可用。

需求集合 URI 会引用某个模块或某个应用了视图的模块。

DOORS 内部出局链接在 V2 GET 结果中显示。这些链接是使用链接模块资源 URI 作为名称空间 URI 并后跟“references”来表示的。例如:
http://localhost:8080/dwa/rm/urn:rational::1-46dd5d7806b96973-M-0001cc43/linkTypes/references
DOORS 外部链接在 V2 GET 结果中显示。这些链接由以下内容表示:
  • 入局链接 - http://purl.org/dc/terms/isReferencedBy
  • 出局链接 - http://purl.org/dc/terms/references
有关更多信息,请参阅 OSLC RM V2 规范

根服务

如果 DOORS Web Access Server 安装在 {SERVER} 中,例如 http://doors.example.com/,那么可在以下位置找到“根服务”文档:
  • 对于低于 1.4.0.2 的 DWA 版本,该位置为 {SERVER}/rm/discovery/rootservices
  • 对于 DWA V1.4.0.2 及更高版本,该位置为 {SERVER}/public/rootservices
“根服务”文档不是 OSLC 规范的一部分,但它提供了“OSLC 服务发现”文档的入口点以及使用 OSLC 服务所需的某些其他配置 URL。

安全性

安全性是必需的,并通过使用 OAuth 1.0a 提供。OAuth 是一种开放协议,允许以一种简单、标准的方法从桌面和 Web 应用程序进行安全 API 认证。

几乎所有 OSLC URI(服务发现、需求、需求集合)都仅能由已认证用户的访问。“根服务”URI 对于该规则是个例外。有关更多信息,请参阅 OAuth 1.0a 规范

关于使用 DXL 服务扩展 Rational DOORS 的信息,请参阅 Rational DOORS 9.4 的 OSLC DXL 服务


反馈