RDF-Darstellung (Resource Description Framework)

In diesem Abschnitt wird die RDF-Darstellung beschrieben, die zum Importieren einer Produktstruktur in Rational Engineering Lifecycle Manager verwendet werden muss.

RDF-Format

Eine Migrationsdatei umfasst RDF-Inhalt in einem der folgenden RDF-Serialisierungsformate gemäß dem W3C-Standard:
  • RDFD/XML
  • Turtle
  • JSON
  • N-3
  • N-Triple

Namespaces

Die folgenden Namespaces werden zum Importieren von Produkten verwendet:
@prefix dcterms: <http://purl.org/dc/terms/> . 
@prefix pd_ext: <http://jazz.net/ns/pd/extensions#> .

Äußerste Anweisungen

Der RDF-Inhalt muss eine oder mehrere Anweisungen in folgender Form umfassen:
<Subjekt-URI> pd_ext:product <Ressourcen-URI>

Der Subjekt-URI hat keine besondere Bedeutung. Es kann sich dabei um den URI eines externen Anbieters von Tools oder einen erzeugten URI handeln. Jeder Ressourcen-URI stellt eine Produktversion dar.

RDF-Darstellung des Produktknotens

Jede Produktressource muss das RDF-Vokabular verwenden, das in den folgenden Tabellen angegeben ist. Prädikate dürfen keine Leerzeichen enthalten.

Tabelle 1. Produktanweisungen
Prädikat Vorkommen Bereich Beschreibung
dcterms:identifier 1.. 1 Zeichenfolge Eine eindeutige, nicht transparente Zeichenfolge, die die Ressource angibt.
dcterms:title 1.. 1 Zeichenfolge Eine Titelzeichenfolge für den Produktknoten.
pd_ext:conceptIdentifier 1.. 1 Zeichenfolge Eine eindeutige, nicht transparente Zeichenfolge, die die Konzeptressource für diesen versionsgesteuerten Produktknoten bezeichnet. Alle Versionen der Konzeptressource müssen denselben Konzept-ID-Wert verwenden.
pd_ext:snapshotName 0.. 1 Zeichenfolge Ein optionaler Name eines Snapshots. Wenn dieser nicht angegeben ist, wird ein Standardname verwendet.
pd_ext:property 0.. * Ressource Eine benutzerdefinierte Eigenschaft, die lokale Konventionen von Rational Engineering Lifecycle Manager verwendet. Die Ressource ist normalerweise ein leerer Knoten. Weitere Details finden Sie in Tabelle 2.
dcterms:references 0.. * Ressource Links zu anderen Artefakten ohne Linkeigenschaften. Bei Links handelt es sich normalerweise um absolute URIs für zugehörige Artefakte, zu denen unter anderem Arbeitselemente, Voraussetzungen, Modellelemente und Testfälle gehören.
pd_ext:link 0.. * Ressource Link zu einer Ressource. Dabei handelt es sich normalerweise um einen leeren Knoten, der einen Link zu einem Artefakt mit optionalen Linkeigenschaften definiert. Weitere Details finden Sie in Tabelle 3.
Tabelle 2. Anweisungen für benutzerdefinierte Eigenschaften
Prädikat Vorkommen Bereich Beschreibung
dcterms:title 1.. 1 Zeichenfolge Der Name der benutzerdefinierten Eigenschaft. Dieser Name wird als eine Beschriftung für die benutzerdefinierte Eigenschaft angezeigt.
rdf:value 1.. 1 Zeichenfolge Der Wert der benutzerdefinierten Eigenschaft. Derzeit werden nur einfache Zeichenfolgen unterstützt.
Tabelle 3. Links mit Eigenschaften
Prädikat Vorkommen Bereich Beschreibung
dcterms:references 1.. 1 Ressource Link zu einem anderen Artefakt ohne Linkeigenschaften. Dabei handelt es sich normalerweise um einen absoluten URI für ein zugehöriges Artefakt wie ein Arbeitselement, eine Voraussetzung, ein Modellelement oder einen Testfall.
dcterms:title 0.. 1 Zeichenfolge oder XML-Literal Der Titel oder Name für den Link.
dcterms:description 0.. 1 Zeichenfolge oder XML-Literal Eine Beschreibung des Links.
dcterms:isVersionOf 0.. 1 Ressource Link zur Konzeptressource für das Artefakt, z. B. wenn das verknüpfte Artefakt versionsgesteuert ist.
Tabelle 4. Dimensionen
Prädikat Vorkommen Bereich Beschreibung
dcterms:title 1.. 1 Zeichenfolge Der Name der Dimension.
pd_ext:shared 0.. 1 XSD:boolesch Gibt an, ob die Dimension gemeinsam (true) oder produktlokal (false) genutzt wird.
rdf:value 1.. 1 Zeichenfolge Der Dimensionswert.
pd_ext:predecessorIdentifier 0.. 1 Zeichenfolge

Eine eindeutige, nicht transparente Zeichenfolge, mit der ein Vorgänger im Verlaufsprotokoll anhand seiner ID angegeben werden kann. Der Vorgänger kann wie folgt definiert sein:

  • Als eine Ressource in derselben RDF-Importdatei
  • Durch eine vorherige Migration

Diese Eigenschaft kann ignoriert werden, wenn sie die Beschränkungen der Geschäftslogik für die Produktdefinition verletzt. Wenn sich z. B. der Vorgänger in derselben Verzweigung befindet und es sich nicht um die neueste Version handelt, werden neue Versionen nach der neuesten Version angezeigt.

Wenn kein Produktknoten in diesem RDF-Inhalt oder durch eine frühere Migration definiert ist, wird der Knoten als ungültige Daten gemeldet.

Die referenzierte Produktressource muss dieselbe Element-GUID wie diese Ressource aufweisen. In anderen Worten: Sowohl dieses Produkt als auch sein Vorgänger müssen Versionen derselben Konzeptressource sein.

Wenn bei Vorhandensein mehrerer Versionen derselben Konzeptressource pd_ext:predecessorIdentifier nicht angegeben ist, ist die Verlaufsreihenfolge verschiedener Versionen in den Importdaten nicht definiert.

Wenn eine Verlaufszirkularität definiert ist, ist die sich ergebende Verlaufsreihenfolge nicht definiert.

Wenn Importdaten nicht gültig sind (wie in diesen Fällen), erhält der Benutzer eine Nachricht und der Import wird sofort gestoppt. Ein Importvorgang wird nur abgeschlossen, wenn keine solchen Fehler vorliegen.

pd_ext:childIdentifier 0.. * Zeichenfolge Eine eindeutige, nicht transparente Zeichenfolge, die die ID einer untergeordneten Ressource angibt. Die untergeordnete Ressource kann wie folgt definiert sein:
  • Als eine Ressource in derselben RDF-Importdatei
  • Durch eine vorherige Migration
Wenn kein Produktknoten in diesem RDF-Inhalt oder durch eine frühere Migration definiert ist, werden die Daten als ungültig gemeldet.

Feedback