Import Requirements From ReqIF

Documentation / Import

Requirements Interchange Format (ReqIF) is an open industry standard for exchanging requirements between organizations using different requirements management (RM) tools.

The main advantage of ReqIF compared to CSV format is that it supports synchronization of complete requirements specifications including requirements hierarchy, attributes, attachments and traceability without any information loss.

You can use ReqIF to collaborate with your customers that use another RM tool during requirements clarification process or to migrate entire requirements projects from another RM tool. Popular RM tools that support ReqIF include IBM DOORS and IBM DOORS Next Generation (DNG), Polarion Requirements, Windchill, or Visure. For more information about ReqIF use cases see How to Exchange Requirements Between Tools via ReqIF blog post.

Import ReqIF Packages

You can import requirements from a ReqIF package, including their hierarchy, attributes, relations, and attachments, using an automatic one-click import process. No configuration should be required for ReqIF packages that follow the recommended attribute naming conventions, see ReqIF Implementation Guide by prostep ivip association for details.

To import a ReqIF package into a new ReqView project, click Project, select Create Project. In the Create Project dialog choose From ReqIF, and enter an ID of the new project, and press OK.

To import a ReqIF package into the current ReqView project, click File, mouseover Import, and select ReqIF Package.

Then, in the file picker dialog, choose a ReqIF file (.xml, .reqif, .reqifz or .zip) to import. The application will load the ReqIF package and open the Import ReqIF Package dialog displaying the list of specifications found in the ReqIF package:

Simple configuration of ReqIF import in ReqView

You can edit the list of ReqIF specifications to import, see Select ReqIF Specifications.

If you press the Customize button, the dialog will load advanced configuration for your ReqIF package in JSON format. The configuration is based on the current input, showing settings only for the selected specifications and taking the input attribute mapping into account. Press the button again after making some changes to the config to refresh the configuration.

Finally, press the OK button to import the chosen ReqIF specifications as new documents into your current project.

Note: OLE attachments are only imported when they are enclosed in a RTF-file, which contains the OLE-object as an embedded file. ReqView cannot extract the embedded files from RTF files, this has to be done manually.

Select ReqIF Specifications

To select ReqIF specifications to import, list the value of either LONG-NAME or IDENTIFIER for each desired ReqIF specification in the reqifSpecifications configuration property (array). All ReqIF specifications will be imported if the reqifSpecifications array is not present in the config.

Example: Import ReqIF specification with LONG-NAME set to "AMR Stakeholder Requirements Specification".

{
"reqifSpecifications": [
"AMR Stakeholder Requirements Specification"
]
}

Set Document Properties

To map ReqIF specification attributes to ReqView documents properties, set the reqviewDocumentProperties configuration property (object):

  • key: ReqView document property — id or name (string)
  • value:
    • ReqIF specification attribute (string)
    • list of ReqIF specification attributes (array)
    • map of user-defined values (object)
      • key: LONG-NAME or IDENTIFIER of the imported ReqIF specification (string)
      • value: user-defined value of the ReqView document property (string)

Example: Set the ReqView document identifier to the value of LONG-NAME for all imported ReqIF specifications.

{
"reqviewDocumentProperties": {
"id": "LONG-NAME"
}
}

Example: Set the ReqView document identifier to the value of ReqIF.Prefix or IDENTIFIER (in order of preference) for all imported ReqIF specifications:

{
"reqviewDocumentProperties": {
"id": ["ReqIF.Prefix", "IDENTIFIER"]
}
}

Example: Set the ReqView document identifier to "SRS" for the imported ReqIF specification with LONG-NAME equal to "Software Requirements Specification".

{
"reqviewDocumentProperties": {
"id": {
"Software Requirements Specification": "SRS"
}
}
}

The default configuration for setting values of ReqView document properties is:

{
"reqviewDocumentProperties": {
"id": ["ReqIF.ForeignID", "ReqIF.Prefix", "LONG-NAME", "IDENTIFIER"],
"name": ["ReqIF.Description", "ReqIF.Name", "LONG-NAME"]
}
}

Set Object Attributes

By default, ReqView imports all attributes of ReqIF specification objects. ReqView document object attributes have unique identifiers created from LONG-NAME or IDENTIFIER of ReqIF specification object type attribute definitions. "ReqIF." prefix is removed from all attribute IDs. If attribute data types clash then attribute IDs are prefixed with LONG-NAME or IDENTIFIER of the ReqIF specification object type attribute to disambiguate them.

To configure the attributes mapping from ReqIF specification objects to ReqView document objects, set the reqifObjectAttributes configuration property (object):

  • key: LONG-NAME or IDENTIFIER of an imported ReqIF specification object attribute (string)
  • value:
    • ReqView document object attribute ID (string)
    • null to ignore the attribute

If the ReqIF specification object attribute is not defined for any imported specification object then it is ignored. You can also explicitly ignore a ReqIF specification object attribute by setting the null value in the configuration.

Example: Set values of ReqView system attribute text from ReqIF specification object attribute RichText for all imported document objects.

{
"reqifObjectAttributes": {
"RichText": "text"
}
}

To configure the mapping for a given ReqIF specification object type, set values of the reqifObjectAttributes configuration property as follows:

  • key: LONG-NAME or IDENTIFIER of an imported ReqIF specification object type (string)
  • value: attributes mapping for the ReqIF specification object type (object)
    • key: LONG-NAME or IDENTIFIER of an imported ReqIF specification object attribute (string)
    • value:
      • ReqView document object attribute ID (string)
      • null to ignore the attribute

Example: Set values of ReqView system attribute heading from ReqIF specification object attribute Title defined for the ReqIF specification object type Section Type.

{
"reqifObjectAttributes": {
"Section Type": {
"Title": "heading"
}
}
}

Example: Ignore import of attribute ReqIF.ChapterNumber defined for all ReqIF specification objects and attribute Description defined for ReqIF specification object type Section Type.

{
"reqifObjectAttributes": {
"ReqIF.ChapterNumber": null,
"Section Type": {
"Description": null
}
}
}

Unless explicitly overridden, the following default mapping is applied automatically (it doesn’t need to be added manually):

{
"reqifObjectAttributes": {
"ReqIF.ChapterName": "heading",
"ReqIF.Text": "text"
}
}

Note: To keep the config concise, the Customize function will not prefill those defaults.

Example ReqIF Import

Let’s assume that we have received a ReqIF file exported from ProR open-source RM tool. Download the example ReqIF file used in this tutorial.

We need to import ReqIF specifications Specification Document and Glossary as new ReqView documents with IDs SPEC and GLOSSARY and set their names. We need to map ReqIF specification object attributes to ReqView document attributes as follows:

  • Map ReqIF attribute Description → ReqView system attribute text
  • Override mapping of ReqIF attribute Description for specification object types Section Type and Use Case Type → ReqView system attribute heading
  • Ignore ReqIF attribute Known Problems
  • Map all other ReqIF attributes → ReqView custom attributes

Follow these steps:

  1. Click File, then Import, and finally ReqIF Package from the main menu.

  2. Select the imported ReqIF file

  3. In the Import ReqIF Package dialog, click Customize to prefill the configuration details automatically.

  4. Adjust the JSON configuration as follows:

    {
    "reqifSpecifications": [
    "Specification Document",
    "Glossary"
    ],
    "reqviewDocumentProperties": {
    "id": {
    "Specification Document": "SPEC",
    "Glossary": "GLOSSARY"
    },
    "name": {
    "Specification Document": "Specification",
    "Glossary": "Glossary"
    }
    },
    "reqifObjectAttributes": {
    "Description": "text",
    "Known Problems": null,
    "Section Type": {
    "Description": "heading"
    },
    "Use Case Type": {
    "Description": "heading"
    }
    }
    }
  5. Click Customize again to update the configuration by default values.

  6. Click OK to import the ReqIF file.

As a result, ReqView successfully imports SPEC document with a list of use cases, GLOSSARY document with the definition of common terms, and traceability links between use cases to the related terms in the glossary:

ReqIF specifications imported from ProR into ReqView

Update From ReqIF

You can iteratively update ReqView documents imported from ReqIF, for instance stakeholder requirements from a customer using another RM tool.

ReqView importer persists ReqIF metadata describing the necessary IDs, types etc. to match documents and objects during successive imports. Mapping of attribute IDs that were already imported cannot be changed. You can press Customize and check the Show only new attributes checkbox in the Import ReqIF Package dialog to hide the already mapped attributes and see only new attributes in the ReqIF package.

Simple configuration of ReqIF import & update in ReqView

You can prevent updating a specific subset of attributes imported from a ReqIF file. For instance, if attributes describing supplier status and comment for stakeholder requirements are updated in ReqView and not in the original RM tool of the ReqIF file provided by your customer. To prevent overwriting a specific attribute during ReqIF import map the attribute to null in the Import ReqIF Package dialog, see Set Object Attributes.

Note: You can update ReqView documents imported from ReqIF using ReqView v2.15 and later. Please contact us if you need help with updating documents imported from ReqIF with ReqView v2.14.

ReqIF SRC Round-trip

You can collaborate with your customers on Stakeholder Request Clarification (SRC) by exchanging ReqIF files, see Workflow for ReqIF Round-trip Between IBM DOORS and ReqView.

IBM DOORS is a legacy requirements management tool, which has been used widely for the development of complex HW/SW products in the aerospace & defense, automotive, and railway industries. IBM DOORS Next Generation (DNG) is its successor based on modern IBM Engineering Lifecycle Management (ELM) platform.

The original RM tool used by your customer can match updated requirements during ReqIF round-trip because ReqView stores ReqIF metadata (such as ReqIF IDs) in project files when you import a ReqIF package and reuses the saved ReqIF metadata when exporting a document back to the customer. For more information how to export ReqIF files from ReqView see Export Requirements to ReqIF.

Example: Import initial version of AMR Stakeholder Requirements Specification from DNG to ReqView to provide supplier feedback via ReqIF round-trip.

Export ReqIF from DNG:

ReqIF SRC Workflow - Customer creates stakeholder requirements specification in IBM DOORS Next Generation (DNG)

Import ReqIF to ReqView:

ReqIF SRC Workflow - Supplier imports stakeholder requirements specification in ReqView
Updated for version 2.16.0