使用 OSLC 服務來延伸 Rational DOORS

Open Services for Lifecycle Collaboration (OSLC) 是一個社群,能將生命週期工具一起運作的方式標準化。IBM® Rational® DOORS® 支援 OSLC 資料共用規格作為「需求管理」網域的提供者,以及作為 Rational 資料夾中其他網域的消費者。

在網域之間共用 OSLC 資料,是根據共同的資源集、格式及 REST 架構服務。

資料共用可支援下列交易:
  • 以 HTTP 通訊協定為基礎的鏈結
  • 依 URI 的資源識別
  • 使用產業標準狀態類型的資訊擷取

Rational DOORS 9.3 版快速手冊

下表列出 Rational DOORS 9.3 版所使用的 OSLC 網域和服務,以及您可以對這些網域中的資源所執行的作業。
表 1. 與 Rational DOORS 9.3 版搭配的 OSLC 網域和作業
DOORS 9.3 選取 建立 預覽(精簡呈現)
Change Management V1 支援 支援 支援

下表列出在各項紀律之間鏈結構件時,所使用的 OSLC 關係:

表 2. 使用 DOORS 9.3 版中的 Change Management V1 在紀律之間鏈結
在 Change Management V1 之間鏈結
送出的鏈結 送入的鏈結
http://jazz.net/xmlns/prod/jazz/calm/1.0/implementedBy http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirement

Rational DOORS 9.4 版快速手冊

下表列出 Rational DOORS 9.4 版所使用的 OSLC 網域和服務,以及您可以對這些網域中的資源所執行的作業。

表 3. 與 Rational DOORS 9.3 版搭配的 OSLC 網域和作業
DOORS 9.4 選取 建立 預覽(精簡呈現)
Change Management V1 支援 支援 支援
Change Management V2 支援 支援 支援
Quality Management V1 支援 支援 支援
Quality Management V2 支援 支援 支援
Requirements Management V1* 支援 支援 支援
Requirements Management V2* 支援 支援 支援
Architecture Management V2 支援 支援 支援
*DOORS 9.4 不應配置成使用其本身的 OSLC 介面。這項支援僅適用於跨儲存庫通訊。

下表列出在各項紀律之間鏈結構件時,所使用的 OSLC 關係:

表 4. 在紀律之間使用 Change Management V1 鏈結
在 Change Management V1 之間鏈結
送出的鏈結 送入的鏈結
實作者

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

實作

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

表 5. 在紀律之間使用 Change Management V2 鏈結
在 Change Management 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. 在紀律之間使用 Quality Management V1 鏈結
在 Quality Management V1 之間鏈結
送出的鏈結 送入的鏈結
驗證者

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

驗證

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

表 7. 在紀律之間使用 Quality Management V2 鏈結
在 Quality Management 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. 在紀律之間使用 Requirements Management V1 鏈結
在 Requirements Management V1 之間鏈結
送出的鏈結 送入的鏈結
詳細闡述者

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

詳細闡述

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

表 9. 在紀律之間使用 Requirements Management V2 鏈結
在 Requirements Management 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. 在紀律之間使用 Architecture Management V2 鏈結
在 Architecture Management V2 之間鏈結
送出的鏈結 送入的鏈結
不適用 詳細闡述

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

不適用 指定

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

Rational DOORS 中,可支援及使用「需求管理」網域中的下列使用者介面 (UI) 元素和作業。

OSLC RM V1 UI 元素和作業

在 DOORS 9.3 以及更新版本中具有 OSLC RM V1 介面。

下列使用者介面元素是針對 RM V1 而實作:
  • 適用於需求資源區段之委派的使用者介面。
  • 適用於需求資源建立之委派的使用者介面。
  • 適用於需求集合資源(視圖)選取之委派的使用者介面。
  • 需求資源的精簡呈現 (Rich Hover)。
  • 需求集合資源(視圖)的精簡呈現 (Rich Hover)。
  • 適用於需求資源程式化建立的原廠資源。
已針對 RM V1 實作下列作業:
  • Service Discovery。
  • 適用於需求建立的 POST。公佈將會建立新的需求作為模組中的第一個物件。
  • 「需求集合」上的 GET。
  • 「需求集合」上的 PUT
  • 「需求」上的 GET。
  • 「需求」上的 PUT。

在服務探索樹狀結構的資料庫層次上無法使用 POST。

「需求集合 URI」會參照任一模組或是已套用視圖的模組。

DOORS 內部鏈結(進或出)不會公開在 V1 GET 結果中。

DOORS 外部鏈結不會公開在 V1 GET 結果中。

如需相關資訊,請參閱 OSLC RM V1 規格

OSLC RM V2 使用者介面元素和作業

在 DOORS 9.4 以及更新版本中具有 OSLC RM V2 介面。

下列使用者介面元素是針對 RM V2 而實作:
  • 適用於需求資源區段之委派的使用者介面。
  • 適用於需求資源建立之委派的使用者介面。
  • 適用於需求集合資源(視圖)選取之委派的使用者介面。
  • 需求資源的精簡呈現 (Rich Hover)。
  • 需求集合資源(視圖)的精簡呈現 (Rich Hover)。
  • 適用於需求資源程式化建立的原廠資源。
已針對 RM V2 實作下列作業:
  • Service Discovery。
  • Resource Shape。
  • 適用於需求建立的 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 規格

Root Services

如果 DOORS Web Access Server 已安裝在 {SERVER} 上,例如, http://doors.example.com/,即可在下列位置上找到 Root Services 文件:
  • 若是早於 1.4.0.2 版的 DWA,此位置是 {SERVER}/rm/discovery/rootservices
  • 若是 1.4.0.2 版以及更新版本的 DWA,此位置是 {SERVER}/public/rootservices
Root Services 文件不是 OSLC 規格的一部分,但是它可提供 OSLC Service Discovery 文件的進入點,以及使用 OSLC 服務時所需的其他配置 URL。

安全

安全是必要項目,並且使用 OAuth 1.0a 來提供。OAuth 是一種開放式通訊協定,可容許從桌面和 Web 應用程式,以簡單且標準的方法來進行安全 API 授權。

幾乎所有的 OSLC URI (Service Discovery、Requirements、Requirement Collections),都只能由已鑑別使用者來存取。Root Services URI 則是這項規則的例外。如需相關資訊,請參閱 OAuth 1.0a 規格

如需使用 DXL 服務來延伸 Rational DOORS 的相關資訊,請參閱 Rational DOORS 9.4 的 OSLC DXL 服務


意見