资源描述框架 (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 字符串 表示此已版本化产品节点的概念资源的不透明字符串。所有版本的概念资源都必须使用同一概念标识值。
pd_ext:snapshotName 0.. 1 字符串 可选快照名称。如果未指定,那么将使用缺省名称。
pd_ext:property 0.. * 资源 使用本地 Rational Engineering Lifecycle Manager 约定的定制属性。通常,资源是空白节点。请参阅表 2 以了解更多详细信息。
dcterms:references 0.. * 资源 指向其他工件的链接(不带链接属性)。通常,这些链接是相关工件的绝对 URI,这些工件包括但不仅限于工作项、需求、模型元素和测试用例。
pd_ext:link 0.. * 资源 指向资源的链接(带可选链接属性),通常资源是定义指向工件的链接的空白节点。请参阅表 3 以了解更多详细信息。
表 2. 定制属性语句
谓词 出现次数 范围 描述
dcterms:title 1.. 1 字符串 定制属性的名称。此名称作为定制属性的标签显示。
rdf:value 1.. 1 字符串 定制属性的值。当前只有纯字符串受支持。
表 3. 带有属性的链接
谓词 出现次数 范围 描述
dcterms:references 1.. 1 资源 指向另一工件的链接(不带链接属性),通常是诸如工作项、需求、模型元素或测试用例等的相关工件的绝对 URI。
dcterms:title 0.. 1 字符串或 XML 文字 标题或者链接的名称。
dcterms:description 0.. 1 字符串或 XML 文字 链接的描述。
dcterms:isVersionOf 0.. 1 资源 指向工件(例如对链接工件进行版本化时)的概念资源的链接。
表 4. 维度
谓词 出现次数 范围 描述
dcterms:title 1.. 1 字符串 维度的名称。
pd_ext:shared 0.. 1 Xsd:boolean 维度是共享的 (true) 还是产品本地的 (false)。
rdf:value 1.. 1 字符串 维度值。
pd_ext:predecessorIdentifier 0.. 1 字符串

可能由此标识符标识历史记录先行作业的唯一不透明字符串。可采用下列方式定义先行作业:

  • 作为相同导入 RDF 文件中的资源。
  • 通过先前迁移。

如果此属性违反产品定义业务逻辑约束,那么可将其忽略。例如,如果先行作业位于同一分支并且不是最新版本,那么新版本将显示在最新版本之后。

如果产品节点未在此 RDF 内容中或者通过先前迁移进行定义,那么会将该节点报告为无效数据。

所引用的产品资源必须与此资源具有相同项 GUID。换句话说,此产品及其先行作业都必须是同一概念资源的不同版本。

如果在同一概念资源存在多个版本的情况下未指定 pd_ext:predecessorIdentifier,那么导入数据中不同版本之间的历史顺序仍未定义。

如果历史循环已定义,那么产生的历史顺序未定义。

如果导入数据无效(如以下情况中),那么会向用户报告一条消息并且立即停止导入。导入只有在不发生任何此类错误时才会完成。

pd_ext:childIdentifier 0.. * 字符串 指定子资源的标识符的唯一不透明字符串。可采用下列方式定义子资源:
  • 作为相同导入 RDF 文件中的资源
  • 通过先前迁移
如果产品节点未在此 RDF 内容中定义或者通过先前迁移进行定义,那么会将数据报告为无效数据。

反馈