Configure round-trip settings for ReqIF import and export
Round-trip exchanges involve multiple back-and-forth imports/exports of the same dataset. On subsequent updates, the original requirements in Jama Connect must be located and updated, rather than duplicated. To facilitate this, requirements in Jama Connect are matched to the corresponding spec objects in the ReqIF file and those matches are maintained throughout the life of the exchange.
In each ReqIF conversation in Jama Connect Interchange, you can choose which matching methodology to use for round-trip exchanges:
Jama Connect matching — (Default) Automatically pairs Jama Connect API IDs with ReqIF identifiers and maintains these associations within the conversation. This method requires no configuration; however, the same conversation must be used throughout the exchange lifecycle. Creating a new conversation results in the generation of duplicate items rather than updates to existing items.
Round Trip ID matching — Utilizes a designated text field within the Jama Connect item to store the corresponding ReqIF identifier. During the initial import or export, this field is automatically populated with the corresponding ReqIF identifier and subsequently referenced in all future exchanges. With Round Trip ID matching, the same conversation is not required throughout the exchange lifecycle, as long as the Round Trip ID field is properly populated and the ReqIF identifier remains unchanged.
To configure round-trip settings:
(Round Trip ID matching only) In Jama Connect, configure a new text field to hold the ReqIF identifier.
For information on how to create a field, see Add, edit, or delete fields.
If you are exchanging requirements for multiple item types, add the new field to each item type, making sure to use the same display name for each.
On the Conversations page, select the conversation you want to configure for a round trip.
Select Import or Export, then select Additional settings.
In the Global settings section, select one of these options:
JUse Jama Connect matching (Default)
Use Round Trip ID matching
(Round Trip ID matching only) In the Jama Connect Round Trip ID field, enter the display name of the Jama Connect field that will hold the ReqIF identifier. For example, Round Trip ID.
Select Save.