Zu Content springen
Deutsch
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Wissenswertes zu ReqIF.ForeignID

ReqIF-Implementor-Attribute und im speziellen ForeignID

Attribute, die mit „ReqIF.“ beginnen, gehören zu den Systemattributen, die vom ReqIF Implementor Forum definiert sind. Ihr Verhalten ist durch den ReqIF-Standard festgelegt und kann nicht frei angepasst werden.

Das Attribut ReqIF.ForeignID repräsentiert immer die Objekt- bzw. Artefakt-ID aus Sicht der exportierenden Seite. Es wird vom exportierenden Tool, sofern unterstützt, in die generierte ReqIF-Datei geschrieben. In dieses Attribut können keine beliebigen oder fachlichen Inhalte eingetragen werden.

Ab Version 4.9.00 des ReqIF-Managers ist es möglich, ReqIF.ForeignID aus einer ReqIF-Datei auf das DNG-Systemattribut ForeignID zu mappen und zu importieren.
Dabei gelten jedoch wichtige Einschränkungen, die Anwender kennen sollten.

Entscheidet sich ein Anwender dafür, ReqIF.ForeignID auf das Systemattribut ForeignID zu mappen und zu importieren, werden die Werte ausschließlich beim Erstellen des Artefaktes geschrieben.
Eine spätere importgestützte Aktualisierung dieser Werte ist nicht möglich.

Das bedeutet konkret:
Wird der Wert dieses Attributs auf Seite des Suppliers in DNG manuell geändert oder gelöscht, so wird der Wert bei einem folgenden Update-Import nicht mit den Werten aus der ReqIF-Datei überschrieben. Der geänderte Wert bleibt bestehen.

Da das Mapping auch einen Export erlaubt, entsteht häufig die Erwartung, dass die ursprünglich importierten Werte beim Export wieder als ReqIF.ForeignID in die ReqIF-Datei geschrieben werden.
Dies ist nicht der Fall.

Die ReqIF.ForeignID ist ausschließlich für die eindeutige Artefakt-ID der exportierenden Seite reserviert.
Unabhängig davon, ob dieses Attribut zuvor auf ein Systemattribut oder auf ein beliebiges String-Attribut gemappt oder importiert wurde, wird beim Export immer die DNG-ID der exportierenden Seite als ReqIF.ForeignID in die ReqIF-Datei geschrieben.

Sofern die Werte dieses Attributs beim Import updatefähig sein sollen, wird empfohlen, hierfür ein eigenes String-Attribut in DNG anzulegen und ReqIF.ForeignID darauf zu mappen, beispielsweise „Stakeholder ID“ oder „Customer ID“. 

Wichtiger Hinweis:

Wenn in DNG ein String-Attribut angelegt wird, dürfen die unten aufgeführten SameAs-URIs nicht verwendet werden.
Attribute mit diesen SameAs-URIs werden von DNG automatisch als Systemattribute erkannt.

http://jazz.net/ns/rm/dng/attribute#masterForeignCreatedBy

http://jazz.net/ns/rm/dng/attribute#masterForeignCreatedOn

http://jazz.net/ns/rm/dng/attribute#masterForeignId

http://jazz.net/ns/rm/dng/attribute#masterForeignModifiedBy

http://jazz.net/ns/rm/dng/attribute#masterForeignModifiedOn

Werden diese URIs verwendet, interpretiert DNG die neu angelegten Attribute automatisch als ReqIF.Foreign-Systemattribute, was zu unerwartetem Verhalten führen kann.

Zum Schluss folgt noch ein Auszug aus der IBM-Dokumentation zum Verhalten der ForeignID. 

Some ReqIF packages contain system properties. If the system property values are not usable, they do not display in the comparison wizard. This is applicable to packages from Rational DOORS and Rational DOORS Next Generation, and tools in the ProSTEP ReqIF Implementation Guide. The following attribute values are only set when, from an import, an artifact is created for the first time in a component:

  • ForeignID
  • ForeignCreatedOn
  • ForeignCreatedBy
Quelle: IBM