Import a ReqIF file to Jama Connect
Complete these steps to import items, relationships, and other objects from a ReqIF file to Jama Connect. At present, only ReqIF files from Jama Connect or from IBM® DOORS® Legacy are formally supported for import.
On the Conversations page, select an existing conversation to use for the import, or create a new conversation. For more information, see Create a new ReqIF conversation.
Select the Import tab:
In the Upload File section, select Upload and select the .reqIF or .reqIFZ file from your computer for upload.
In the Select Import Location section, choose Select Location and select the Jama Connect location to upload the ReqIF file data.
After both the Upload File and Select Import Location sections are completed, data mapping fields are automatically generated on the lower half of the page. This process can take a few minutes to complete, depending on the size and complexity of the ReqIF file.
On the Item Types/Modules subtab:
Set the ON/OFF toggle to ON for each specification that you want to import.
A row is listed for each specification present in the file.
For ReqIF files exported from Jama Connect, these specifications correspond to sets containing one or more items.
For ReqIF files exported from DOORS, these specifications correspond to modules containing one or more objects.
When these specifications are imported into Jama Connect, each specification is imported as an individual set in the Jama Connect Explorer Tree.
In the left drop-down list for each row that you enabled, select the Jama Connect item type to assign to the set and items being imported.
Select Next.
On the Fields/Attributes subtab:
Set the ON/OFF toggle to ON for each attribute (field value) that you want to import.
In the left drop-down list for each row that you enable, select the Jama Connect field to write the values to.
Name and Description fields are mapped automatically, but can be modified if necessary.
When you map single-select and/or multi-select fields, you must also map the corresponding picklist values, which are nested under the field mapping row.
Be sure to map all required fields for the Jama Connect item type; otherwise, the items cannot be created and error messages will be generated in the logs. The left drop-down list indicates which fields are required.
Select the Map to additional field link if you want to map the same value from the ReqIF file to multiple fields on the Jama Connect item.
Note
If you attempt to map multiple fields in the ReqIF file to the same Jama Connect field, only one mapping is honored; all other mappings are ignored.
If your import contains multiple specifications, repeat step 4 for each specification listed in the left navigation bar.
Select Save.
On the Relationships subtab:
Set the ON/OFF toggle to ON for each spec relation type in the ReqIF file that contains relationships you want to import to Jama Connect.
In the left drop-down list for each row you enabled, select the Jama Connect relationship type to use for these relationships.
Make sure that Jama Connect relationship rules are configured to allow the relationship types and relationship directions that you are attempting to import.
To reverse the upstream/downstream direction from the default direction listed in the ReqIF file, select the Reverse checkbox for that row. By default, “Source” items in the ReqIF file are imported as “Upstream” items and “Target” items in the ReqIF file are imported as “Downstream” items.
Select Initiate Import to import the file.
Select the Logs tab to check the status of the import.