How to Continue a ReqIF Exchange Initiated via Data Exchange

Patrick Garman
Patrick Garman
  • Updated
Audience: Everyone

Products and Versions Covered: 

  • Jama Connect Interchange™ for ReqIF imports
  • Data Exchange

IMPORTANT: Access to the REST API is limited to users with a Named Creator Jama Connect license, including endpoints in v1, labs, and SCIM. Users without a Named Creator Jama Connect license, including those with a Creator Float License, do not have access.

Summary

After migrating from Data Exchange to Jama Connect Interchange™ for ReqIF imports and exports, you may need to continue an existing round-trip exchange that was originally initiated in Data Exchange.

This article explains how to configure a new conversation in Jama Connect Interchange™ that matches existing items using previously generated ReqIF IDs. Because Jama Connect Interchange™ does not accept Data Exchange mapping files, you must recreate mappings before initiating the import.

Resolution

Follow the steps below to continue a ReqIF round-trip exchange that was initiated in Data Exchange.

  1. Log in to Jama Connect Interchange™. In the top navigation bar, click Connectors and confirm that your Jama Connect® instance is connected and active.Screenshot 2026-02-11 at 2.01.56 PM.png
  2. If your Jama Connect® instance is not connected, click Add Connector in the upper-right corner of the screen to create a new connection.Screenshot 2026-02-11 at 2.02.03 PM.png
  3. Enter a name for the connector. This name is visible only to Jama Connect Interchange™ users.Screenshot 2026-02-11 at 2.02.09 PM.png
  4. Enter the Base URL for your Jama Connect® instance, select the authentication type, and provide the service account credentials.Screenshot 2026-02-11 at 2.02.14 PM.png
  5. Click Save. Jama Connect Interchange™ tests the connection and displays an error message if the connection fails.Screenshot 2026-02-11 at 2.02.20 PM.png
  6. In the top navigation bar, click Conversations to view and manage your data exchange conversations.Screenshot 2026-02-11 at 2.02.27 PM.png
  7. Click Add Conversation to start creating a new data exchange conversation.Screenshot 2026-02-11 at 2.02.33 PM.png
  8. Select the external tool you want to exchange data with.Screenshot 2026-02-11 at 2.07.55 PM.png
  9. Click Save Screenshot 2026-02-11 at 2.08.01 PM.png
  10. Select the Jama Connect® instance where you want to import or export ReqIF files.Screenshot 2026-02-11 at 2.08.06 PM.png
  11. Click Next Screenshot 2026-02-11 at 2.08.12 PM.png
  12. Choose the project in which you want to import or export ReqIF files.Screenshot 2026-02-11 at 2.08.19 PM.png
  13. Click Next. Screenshot 2026-02-11 at 2.08.26 PM.png
  14. Enter a descriptive name for the conversation so Jama Connect Interchange™ users can easily identify it.Screenshot 2026-02-11 at 2.08.32 PM.png
  15. Click Submit Screenshot 2026-02-11 at 2.08.37 PM.png
  16. Click ImportScreenshot 2026-02-11 at 2.08.44 PM.png
  17. Click Additional settingsScreenshot 2026-02-11 at 2.08.51 PM.png
  18. In Additional Settings, set Round Trip to Use round trip ID matching.Screenshot 2026-02-11 at 2.08.56 PM.png
  19. Enter the display name of the Jama Connect® field that stores the ReqIF IDs previously generated by Data Exchange. This is typically a field such as External ID or ReqIF ID.Screenshot 2026-02-11 at 2.09.01 PM.png
  20. Click Save Screenshot 2026-02-11 at 2.09.06 PM.png
  21. Click Upload and select the ReqIF file containing the updates you want to import.Screenshot 2026-02-11 at 2.09.10 PM.png
  22. Click Select Location and choose where in the project you want to import the updates.Screenshot 2026-02-11 at 2.09.15 PM.png
  23. Recreate all item type, field, and relationship mappings. Jama Connect Interchange™ does not accept mapping files generated by Data Exchange. For detailed guidance on creating mappings, see the Jama Connect Interchange Help Guide
  24. After all mappings are complete, click Initiate Import. When prompted, select Update existing items to apply updates rather than importing new items.

  25. Monitor the import progress on the Logs tab of the conversation. Jama Connect Interchange™ matches each item in the ReqIF file to existing items in the Jama Connect® project using the specified ReqIF ID field.

Additional Resources 

Feedback:
We welcome your input! Please sign in to leave any comments, suggestions, or improvement ideas below.

 

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.