通过 OSLC 服务扩展 Rational DOORS

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

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

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

Rational DOORS 快速指南

下表列出了 Rational DOORS 使用的 OSLC 域和服务以及可以对这些域的资源执行的操作。Rational DOORS V9.3 中引入了变更管理 V1。Rational DOORS V9.4 中添加了对所有其他域和服务的支持。

下表列出了 Rational DOORS V9.4 和更高版本使用的 OSLC 域和服务以及可以对这些域的资源执行的操作。

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

下表列出了在各不同规程之间链接工件时所使用的 OSLC 关系:

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

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

实现

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

表 3. 变更管理 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

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

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

验证

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

表 5. 质量管理 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

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

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

阐述

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

表 7. 需求管理 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

表 8. 体系结构管理 V2 规程间的链接
体系结构管理 V2 间的链接
出局链接 入局链接
不适用 优化

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

不适用 满足

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

不适用 跟踪

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

当用户在 Rational DOORS 中打开模块时,与其他生命周期产品之间的外部 OSLC 链接将被“发现”,并且结果存储在数据库级高速缓存中,以便在将来更加快速地打开模块。当打开模块时,此链接发现过程会对性能产生潜在影响,具体取决于集成产品的性能。高速缓存的缺省超时值为 5 分钟。在经过该时间后,需要“重新发现”链接,以便高速缓存具有链接的最新状态。可以使用 DXL perm setCachedExternalLinkLifeTime 来更改此超时值。 有关更多信息,请参阅 DXL 参考手册中的“OSLC 链接发现”,此内容以 PDF 形式提供,也可以从“帮助”菜单中获取。

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

OSLC RM V1 UI 元素和操作

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

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

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

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

Rational DOORS 内部链接(入向或出向)不在 VI GET 结果中显示。

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

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

OSLC RM V2 UI 元素和操作

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

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

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

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

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

根服务

如果 Rational DOORS Web Access Server 安装在 {SERVER}(例如 http://doors.example.com/)中,那么可在以下位置找到“根服务”文档:
  • 对于低于 1.4.0.2 的 Rational DOORS Web Access 版本,该位置为 {SERVER}/rm/discovery/rootservices
  • 对于 Rational DOORS Web Access 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 的 OSLC DXL 服务。另请参阅使用 DXL(Rational DOORS 扩展语言)


反馈