Mapping Name Fields Between Jama and DOORS Using ReqIF

Mapping Name Fields Between Jama and DOORS Using ReqIF

Overview

This article addresses issues when mapping name fields between Jama and DOORS using ReqIF and Data Exchange (DX). It provides guidance on potential causes, known limitations, and best practices for troubleshooting.

1. Issue Summary

✔ Problem: A customer is experiencing difficulty mapping a name field from Jama to DOORS using a ReqIF file and DX.
✔ Observation:

• DOORS → Jama: Works fine, and the name field is mapped correctly.

• Jama → DOORS: The name field is missing or not being mapped properly.
  ✔ Customer’s Setup:

• They are using DOORS 9.6.

• They exported a ReqIF file from Jama using Data Exchange.

• The same ReqIF file works for new projects in Jama but fails when mapping name fields in DOORS.

2. Possible Causes & Troubleshooting Steps

🚨 Potential IBM-Specific Issue:

• This issue might be related to IBM DOORS, not DX or Jama.

• Recommendation: The DOORS user should contact IBM support for guidance.

🔍 ReqIF Specification Differences:

• ReqIF handles names differently in Jama and DOORS.

• DOORS may expect the name field in a different attribute (e.g., "Object Heading" vs. "Object Text").

🛠 Workarounds & Fixes:

• Verify field mapping in the DX import configuration.

• Check if DOORS requires the name field to be mapped to a specific attribute (e.g., ReqIF.ChapterName or ReqIF.Text).

• If necessary, manually edit the ReqIF file to ensure the name attribute is properly defined.

• Consider using alternative name fields (e.g., "Object Identifier" or "Object Short Name") if applicable.

3. Best Practices for Mapping Name Fields in ReqIF

✅ Ensure the correct ReqIF attributes are mapped between Jama and DOORS.
✅ Test imports with different name field attributes (e.g., ChapterName, Text, etc.).
✅ Verify DOORS settings to confirm it accepts the name field from Jama.
✅ Reach out to IBM support if DOORS does not recognize the expected field.
✅ Use a small test ReqIF file to isolate the issue before performing a full migration.

4. Conclusion

✔ Jama and DX appear to be working correctly based on customer feedback.
✔ The issue is likely on the DOORS side, requiring IBM support to resolve.
✔ Mapping adjustments in DX or manual ReqIF edits may help resolve the name field discrepancy.
✔ Testing different name field attributes in DOORS can improve compatibility.