Representación RDF (Resource Description Framework)

Este tema describe la representación RDF que debe utilizarse para importar un árbol de producto a Rational Engineering Lifecycle Manager.

Formato RDF

Un archivo de migración consta de contenido RDF en uno de los siguientes formatos de serialización RDF estándar W3C:
  • RDFD/XML
  • Tortuga
  • JSON
  • N-3
  • N-Triple

Espacios de nombres

Se utilizan los siguientes espacios de nombres para importar productos:
@prefix dcterms: <http://purl.org/dc/terms/> . 
@prefix pd_ext: <http://jazz.net/ns/pd/extensions#> .

Sentencias más externas

El contenido RDF debe incluir una o más sentencias con el formato:
<subjectUri> pd_ext:product <resourceUri>

subjectUri no es de especial relevancia. Puede ser el URI de algún proveedor de herramientas externas, o algún URI manufacturado. Cada resourceUri representa una versión del producto.

Representación RDF de nodos de producto

Cada recurso de producto debe utilizar el vocabulario RDF que se muestra en las tablas siguientes. Los predicados no pueden contener espacios.

Tabla 1. Sentencias de producto
Predicado Aparece Rango Descripción
dcterms:identifier 1.. 1 Serie Una serie opaca exclusiva que identifica el recurso.
dcterms:title 1.. 1 Serie Una serie de título para el nodo de producto.
pd_ext:conceptIdentifier 1.. 1 Serie Una serie opaca exclusiva que indica el recurso de concepto para este nodo de producto con versión. Todas las versiones del recurso de concepto deben utilizar el mismo valor de identificador de concepto.
pd_ext:snapshotName 0.. 1 Serie Un nombre de instantánea opcional. Si no se especifica, se utiliza un nombre predeterminado.
pd_ext:property 0.. * Recurso Una propiedad personalizada que utiliza convenios de Rational Engineering Lifecycle Manager locales. El recurso suele ser un nodo en blanco. Consulte la tabla 2 para más detalles.
dcterms:references 0.. * Recurso Enlaces a otros artefactos sin propiedades de enlace. Los enlaces suelen ser URI absolutos a artefactos relacionados incluidos, entre otros, elementos de trabajo, requisitos, elementos de modelo y casos de prueba.
pd_ext:link 0.. * Recurso Enlace a un recurso, generalmente un nodo en blanco que define un enlace a un artefacto con propiedades de enlace opcionales. Consulte la tabla 3 para más detalles.
Tabla 2. Sentencias de propiedad personalizada
Predicado Aparece Rango Descripción
dcterms:title 1.. 1 Serie El nombre de la propiedad personalizada. Este nombre se visualiza como una etiqueta para la propiedad personalizada.
rdf:value 1.. 1 Serie El valor de la propiedad personalizada. Actualmente sólo se da soporte a series simples.
Tabla 3. Enlaces a propiedades
Predicado Aparece Rango Descripción
dcterms:references 1.. 1 Recurso Enlace a otro artefacto sin propiedades de enlace, normalmente un URI absoluto a un artefacto relacionados, como un elemento de trabajo, requisito, elemento de modelo o caso de prueba.
dcterms:title 0.. 1 Serie o literal XML El título o nombre del enlace.
dcterms:description 0.. 1 Serie o literal XML Una descripción del enlace.
dcterms:isVersionOf 0.. 1 Recurso Enlace al recurso de concepto para el artefacto, como cuando el artefacto enlazado es con versión.
Tabla 4. Dimensiones
Predicado Aparece Rango Descripción
dcterms:title 1.. 1 Serie El nombre de la dimensión.
pd_ext:shared 0.. 1 Xsd:boolean Si la dimensión es compartida (true) o local del producto (false).
rdf:value 1.. 1 Serie El valor de dimensión.
pd_ext:predecessorIdentifier 0.. 1 Serie

Una serie opaca exclusiva que puede identificar un predecesor de historial por su identificador. El predecesor se puede definir:

  • Como un recurso en el mismo archivo RDF de importación.
  • Mediante una migración anterior.

Esta propiedad se puede omitir si viola restricciones de lógica empresarial de definición de producto. Por ejemplo, si el predecesor está en la misma rama y no es la versión más reciente, nuevas versiones aparecen después de la versión más reciente.

Si un nodo de producto no está definido en este contenido RDF o mediante una migración anterior, se considera que el nodo son datos no válidos.

El recurso de producto referenciado debe tener el mismo GUID de elemento que este recurso. En otras palabras, tanto este producto como su predecesor deben ser versiones del mismo recurso de concepto.

Si no se especifica pd_ext:predecessorIdentifier cuando hay varias versiones del mismo recurso de concepto, el orden histórico entre las diferentes versiones en los datos de importación se deja sin definir.

Si se define una circularidad histórica, el orden histórico resultante no está definido.

Si los datos de importación no son válidos (como en estos casos), se envía un mensaje al usuario y la importación se detiene inmediatamente. Una importación se completa sólo cuando no hay errores de este tipo.

pd_ext:childIdentifier 0.. * Serie Una serie opaca exclusivo que especifica el identificador de un recurso hijo. El recurso hijo se puede definir:
  • Como un recurso en el mismo archivo RDF de importación
  • Mediante una migración anterior
Si un nodo de producto no está definido en este contenido RDF o mediante una migración anterior, los datos se consideran no válidos.

Comentarios