ReqIF_Export_Tutorial - Helmut-Ortmann/EnterpriseArchitect_hoReverse GitHub Wiki
It took me a while to get things working. Here you find some ideas to get the export from EA to DOORS to work.
If you have experiences or advice, don't hesitate to contact me. You may also validate the ReqIF.
- Configure Settings.json as specified in Export Specification
- Create Folders:
- c:/Temp/ReqIF/
- c:/Temp/ReqIF/Store/02/
- Open EA ReqIF Tutorial ReqIfTutorial.eapx with EA
- hoReverse Add-in: Do, Export reqIF, 02: My ReqIF Export specification, see picture
- Results:
- c:/Temp/ReqIF/ReqIF_Export.reqifz Your ReqIF compressed file with all embedded files and images
- c:/Temp/ReqIF/Store/02/.. The files which are part of the requirements
- See my ReqIF_Export.reqifz with EA
- Open it in ReqIF Studio if you want to see the details
You need to insert the EA Package GUID (e.g. {3EF72685-0CE0-469f-B82B-4267E494FAE4}) of the Specification/Module into the Import/Export -Specification (ExportModule1, ModuleA, ModuleB respectively). You get the Package GUID by:
EA Projekt-Browser, Select Package, Right Click, Copy / Paste, Copy Node GUID to Clipboard
See: Settings Import, Roundtrip, Export
hoRverse, File, Settings, ReqIF,....
You may need to configure the extension *.json to your favorite editor.
or Edit
c:/users/<user>/AppData/Roaming/ho/hoReverse/Settings.json
The easiest way to check the 'ReqIF_Export.reqifz' is to import it into ReqIF Studio.
For Enums you need to define Tagged Value Types:
- Ribbon: Configure, UML Types
- Tagged Value Types
The general approach is to import from your beloved Requirement Tool and see how hoReverse converts it into EA and its:
- Tagged Values
- TaggedValue types for enums
- Linked Documents
- Notes
- Names
Procedure:
- DOORS: Export ReqIF (format: *.reqifz, zipped ReqIF with embedded files/images)
- ReqIF Studio: Import ReqIF to check the ReqIF export
- EA: Create Package for Module
- EA: Get GUID from creating Package of DOORS Module
- EA: Add Import specification to settings.json and update GUID
- EA: Import
- EA: Make your EA requirements according to the imported
- EA: Add Export specification to settings.json and update GUID
- EA: Export
- DOORS: Import
See:
Example:
The example you find in 'Resource/':
Add or edit c:/users/<user>/AppData/Roaming/ho/hoReverse/settings.json an entry behind:
"Importer":
[
{
"Name" : "1. My ReqIF Import specification",
"Description" : "Test",
"ListNo" : "1",
"InputFile" : "c:/Temp/ReqIF/Doors_import.reqifz" ,
"PackageGuidList" : ["{3EF72685-0CE0-469f-B82B-4267E494FAE4}","{A6D555F6-7812-40bf-8150-EFD71F6A3121}"],
"StereotypeDependency": "satisfy",
"ObjectType" : "Requirement",
"Stereotype" : "",
"ImportType" : "DoorsReqIF",
"StatusNew" : "Proposed",
"StatusChanged" : "None",
"RtfNameList" : ["ReqIF.Text"],
"AttrNameList" : ["ReqIF.ForeignID", "ReqIF.Chaptername", "ReqIF.Text"],
"AttrNotes" : "ReqIF.Text",
"AliasList" : ["ReqIF.ForeignID"],
"EmbeddedFileStorageDictionary" : "c:/Temp/ReqIF/Store/1/"
}
See: - Settings Import, Roundtrip, Export
- EA Repository
- Result: Doors_Export.reqifz
Add or edit c:/users/<user>/AppData/Roaming/ho/hoReverse/settings.json an entry behind:
"Importer":
[
{
"Name" : "02: My ReqIF Export specification",
"Description" : "My ReqIF Export specification",
"ListNo" : "2",
"ExportFile" : "c:/Temp/ReqIF/export.reqifz" ,
"PackageGuidList" : ["{B408F6F3-A1F9-47f7-8AD4-CBE2284627D1}"],
"ObjectType" : "Requirement",
"Stereotype" : "",
"StereotypeDependency": "satisfy",
"ImportType" : "DoorsReqIF",
"StatusNew" : "Proposed",
"EmbeddedFileStorageDictionary" : "c:/Temp/ReqIF/Store/02/"
}
Useful to improve:
- ReqIF
- ReqIF Export
- ReqIF Export Tutorial
- ReqIF Import
- ReqIF Import Tutorial
- ReqIF Roundtrip
- Eclipse ProR
- Import & Export
- OMG Specification
- ReqIF.academy
- ReqIF Helpers
- ReqIF Information of a file or folder with *.reqif or *.reqifz
- ReqIF in DOORS
- ReqIF Studio, the free ReqIF Editor & a lot more
- ReqIF Test data (Eclipse)
- Settings Import, Roundtrip, Export
- Tagged Values
- .reqif for a single ReqIF XML file
- .reqifz for a ZIP achieve containing ReqIF files and additional files
- Attribute (ReqIF) With Attributes a Requirement may contain additional information stored in the Attributes. In EA this are Tagged Values.
- EA Tagged Values are a UML/SysML compliant method to provide additional properties to UML/SysML elements and connectors. Here we use it to define arbitrary ReqIF Attributes to exchange with other tools.
- GUID Universally unique identifier used by EA to uniquely identify an object
- MCDF Microsoft Compound Document Format (used by DOORS embedded files)
- Package The Package which contains the requirements. In terms of ReqIF its the Specification or in DOORS the Module.
- ReqIF Requirements Interchange Format
- ReqIF Roundtrip, often called ReqIF Workflow. The Standard how to exchange ReqIF requirements between two partners
- ReqIF Standard of the OMG to exchange requirements between different tools, see OMG Specification
- ReqIF Workflow: ReqIF workflow specifies how to exchange requirements between tools. Often called Roundtrip
- ReqIF Tool: A tool that imports/exports ReqIF compliant XML documents
- Requirements authoring tool: A tool to create and modifying requirements
- Specification In ReqIF the container which contains the requirements. In DOORS it's named 'Module'.
- SPICE Process Reference Model to assess process maturity.
- Tagged Values UML/EA measure to add values to a classifier/requirement. For enumerations EA needs Tagged Value Types (Enum or Checklist).
- Traceability