Re-Use-Artefakte können nur dann erfolgreich mit dem ReqIF-Manager importiert werden, wenn die ReqIF(z)-Datei direkt von DNG (eigene Funktion) oder dem ReqiIF-Manager selbst stammt und die Funktion "Partner uses DNG" aktiviert ist.
Was sind wiederverwendete Artefakte / Re-Use-Artefakte?
Artefakte, die in mehr als einem Modul verwendet werden, oder solche, die mehrfach innerhalb desselben Moduls vorkommen, werden als Re-Use-Artefakte bezeichnet. Module mit Re-Use-Artefakten können nur dann erfolgreich mit dem ReqIF-Manager importiert werden, wenn die ReqIF(z)-Datei direkt aus DNG (mithilfe der eigenen Export-Funktion) oder dem ReqIF-Manager selbst erstellt wurde.
Re-Use-Artefakte, die aus anderen ReqIF-Tools stammen (z. B. Reqtify oder PREEvision), können derzeit nicht importiert werden.
Unser Tipp:
Verwenden Sie oder Ihr Austauschpartner derzeit keine Re-Use-Artefakte, da dies erhebliche Probleme beim ReqIF-Austausch verursachen kann.
Fehlermeldungen bei Re-Use-Artefakten (nach Version):
Wir haben das Verhalten des ReqIF-Managers beim Umgang mit Re-Use Artefakten immer wieder angepasst. Je nach verwendeter Version können Sie unterschiedliche Fehlermeldungen erhalten:
- Version 4.6 und neuer, Fehler im ReqIF Check:
- Version 4.5 und neuer, Fehler im Modul Log:
E296: The Spec-Object with the identifier "<spec_object_identifier>" occurs multiple times in the Spec-Hierarchy.
- Version 4.4 und älter, Fehlerkombination im Modul Log und DNG Log:
E287: Import for module <placeholder_moduleName> (<placeholder_moduleName>_Hierarchy) (Initial import to folder <placeholder_folderName>)' unsuccessful!
Error importing Artifact into module <placeholder_moduleName>_Hierarchy: Propagated exception; original message [NotFoundException: Propagated exception; original message [NotFoundException: Item URI: <placeholder_folderURI>, ID: <placeholder_ID>.]]: Propagated exception; original message [NotFoundException: Propagated exception; original message [NotFoundException: Item URI: <placeholder_folderURI>, ID: <placeholder_ID>.]]
- Version 4.4, alternative Fehlerkombination in Module Log und DNG Log:
E280: Errors occurred during the import process. Please refer to the log for detailed information.
E290: The module with the ReqIF identifier "<module_identifier>" could not be found after importing it into DNG.<placeholder_ModuleURI>
Refused to import a module [<module_identifier>], because its structure failed validation.
- Warnung W266 alle Versionen, im Modul Log bei OSLC Import:
W266: The artifact with identifier "<artifact_identifier>" occurs multiple times.
Vorgehen:
- Falls Ihnen das ReqIF-Tool Ihres Austauschpartner unbekannt ist, fragen Sie direkt bei Ihm nach oder ermitteln Sie es über die ReqIF-Tool-ID in der Datei. Einen Artikel zur Ermittlung der ReqIF-Tool-ID finden Sie hier.
- Nutzen Sie die Fehlermeldung(en), um die betroffenen Re-Use-Artefakte in der ReqIF-Datei zu identifizieren.
- Informieren Sie Ihren Austauschpartner über die ermittelten Artefakte, damit diese aus dem Austausch ausgeschlossen werden können.
- Das neu konfigurierte Modul muss danach durch Ihren Austauschpartner erneut exportiert werden. Anschließend können Sie versuchen, es erneut zu importieren.
- Die folgende Tabelle unterstützt Sie bei der korrekten Auswahl der Checkbox „Partner uses DNG“ und zeigt das zu erwartende Verhalten:
ReqIFToolID | Erstimport | Update | Verhalten |
DNG / ReqIF-Manager | Partner uses DNG | Partner uses DNG | ReUse |
DNG / ReqIF-Manager | ohne Partner uses DNG | ohne Partner uses DNG | Kopien |
andere ReqIF-Tools | ohne Partner uses DNG | ohne Partner uses DNG | Kopien/ Fehler |
- Während des Imports ohne diese Option wird die Datei transformiert: Die Re-Use-Artefakte erhalten dabei eigene IDs und werden zu Kopien. Diese Kopien könnte Ihr Austauschpartner beim erneuten Export zurückerhalten. Informieren Sie ihn daher unbedingt darüber.
ReqIF-Hintergrund:
Re-Use-Artefakte können in der ReqIF-Datei schema-konform als doppelte Einträge im Bereich <SPEC HIERARCHY> dargestellt werden. Die Verarbeitung dieser mehrfach auftretenden IDs muss jedoch vom jeweiligen Anforderungstool unterstützt werden.
Einige Tools hinterlegen die Re-Use-Information im Bereich <TOOL EXTENSION>. Laut der ReqIF-Implementierungsrichtlinie muss dieser Bereich jedoch nicht von verarbeitenden Tools ausgewertet werden. Es bleibt jedem Tool überlassen, welche Informationen dort und in welcher Form gespeichert werden. Dieser Bereich kann daher als Wildcard verstanden werden.
Die offizielle Aussage von IBM zu dieser Problematik finden Sie hier