資源說明架構 (RDF) 表示法

這個主題說明必須用來將產品樹狀結構匯入至 Rational® Engineering Lifecycle Manager 的 RDF 表示法。

RDF 格式

移轉檔是由下列其中一個 W3C 標準 RDF 序列化格式的 RDF 內容所組成:
  • RDFD/XML
  • Turtle
  • JSON
  • N-3
  • N-Triple

名稱空間

下列名稱空間用來匯入產品:
@prefix dcterms: <http://purl.org/dc/terms/> . 
@prefix pd_ext: <http://jazz.net/ns/pd/extensions#> .

最外層陳述式

RDF 內容必須包括下列形式的一或多個陳述式:
<subjectUri> pd_ext:product <resourceUri>

subjectUri 無特定相關性。它可能是某個外部工具提供者的 URI,或某個製造商 URI。每一個 resourceUri 代表一個產品版本。

產品節點 RDF 表示法

每一個產品資源必須使用下列表格中顯示的 RDF 詞彙。述詞不能包含空格。

表 1. 產品陳述式
述詞 發生次數 範圍 說明
dcterms:identifier 1.. 1 字串 識別資源的唯一不透明字串。
dcterms:title 1.. 1 字串 產品節點的標題字串。
pd_ext:conceptIdentifier 1.. 1 字串 表示此版本化產品節點之概念資源的唯一不透明字串。概念資源的所有版本必須使用相同概念 ID 值。
pd_ext:snapshotName 0.. 1 字串 選用的 Snapshot 名稱。如果沒有指定,則會使用預設名稱。
pd_ext:property 0.. * 資源 (Resource) 使用本端 Rational Engineering Lifecycle Manager 使用慣例的自訂內容。 資源通常是空白節點。如需詳細資料,請參閱表格 2。
dcterms:references 0.. * 資源 (Resource) 不含鏈結內容的其他構件鏈結。 鏈結通常是相關構件(包括但不限於工作項目、需求、模型元素及測試案例)的絕對 URI。
pd_ext:link 0.. * 資源 (Resource) 資源鏈結,通常是空白節點,其定義含有選用鏈結內容的構件鏈結。如需詳細資料,請參閱表格 3。
表 2. 自訂內容陳述式
述詞 發生次數 範圍 說明
dcterms:title 1.. 1 字串 自訂內容的名稱。此名稱顯示為自訂內容的標籤。
rdf:value 1.. 1 字串 自訂內容的值。 目前僅支援一般字串。
表 3. 含有內容的鏈結
述詞 發生次數 範圍 說明
dcterms:references 1.. 1 資源 (Resource) 不含鏈結內容的另一個構件鏈結,通常是相關構件(如工作項目、需求、模型元素或測試案例)的絕對 URI。
dcterms:title 0.. 1 字串或 XML 文字 鏈結的標題或名稱。
dcterms:description 0.. 1 字串或 XML 文字 鏈結的說明。
dcterms:isVersionOf 0.. 1 資源 (Resource) 構件的概念資源鏈結,例如鏈結的構件已版本化時。
表 4. 維度
述詞 發生次數 範圍 說明
dcterms:title 1.. 1 字串 維度的名稱。
pd_ext:shared 0.. 1 Xsd:boolean 維度為共用 (true) 或產品本端 (false)。
rdf:value 1.. 1 字串 維度值。
pd_ext:predecessorIdentifier 0.. 1 字串

可依其 ID 來識別歷程前一版本的唯一不透明字串。前一版本可如下定義:

  • 定義為相同匯入 RDF 檔中的資源。
  • 由前一個移轉定義。

如果此內容違反產品定義商業邏輯限制,您可以予以忽略。比方說,如果前一版本位於相同分支上且不是最新版本, 則新版本會在最新版本之後出現。

如果產品節點未在此 RDF 內容中定義或不是由先前的移轉所定義,則該節點會報告為無效資料。

參照的產品資源必須具有與此資源相同的項目 GUID。換言之,此產品及其前一版本都必須是相同概念資源的版本。

如果在相同概念資源有多個版本時未指定 pd_ext:predecessorIdentifier,則匯入資料中不同版本之間的歷程順序會保持未定義。

如果定義了歷程循環,則結果歷程順序為未定義。

如果匯入資料無效(例如在這些情況下),則會向使用者報告訊息,並且立即停止匯入。 只有在沒有這類錯誤時才會完成匯入。

pd_ext:childIdentifier 0.. * 字串 指定子項資源 ID 的唯一不透明字串。子項資源可如下定義:
  • 定義為相同匯入 RDF 檔中的資源
  • 由前一個移轉定義
如果產品節點未在此 RDF 內容中定義或不是由先前的移轉所定義,則資料會報告為無效。

意見