Why Extra "Text" Items Appear in ReqIF Imports from DNG

Overview

This article explains why extra text items appear when importing ReqIF files from DOORS Next Generation (DNG) into Jama Connect via DX, particularly for images and file attachments.

1. Why Do Extra Text Items Appear in ReqIF Imports?

✔ These "Text" items act as placeholders for images and file attachments.
✔ DNG stores images and attachments as separate "Items", rather than embedding them directly within a requirement.
✔ During import, DX recreates these attachment reference items as "Text" objects in Jama Connect.

2. How DNG Handles Attachments vs. Jama Connect

DNG Behavior	DX Import Result in Jama Connect
Images and attachments are stored as separate items.	DX creates extra "Text" items for the attachments.
Multiple requirements can reference the same attachment.	The imported "Text" items contain links to the actual files.
Attachments are referenced in requirement descriptions.	Attachment references may appear as separate Text objects.

3. How to Verify Attachment Import in Jama Connect

✔ Check the imported project settings in Jama.
✔ Locate the attachments stored in the system, even if they appear as separate "Text" items.
✔ Compare the imported ReqIF file structure to confirm the attachment behavior.

4. Best Practices to Manage Attachments in ReqIF Imports

✅ Understand that extra "Text" items are attachment placeholders, not errors.
✅ Manually review imported attachments to confirm correct placement.
✅ If necessary, restructure the imported items to match Jama’s preferred format.
✅ Check the ReqIF file structure in DNG before exporting to ensure clarity in attachment handling.

5. Conclusion

DNG stores images/attachments as separate items, leading to extra "Text" objects in Jama after import.
DX imports these attachment references rather than embedding them directly.
Verifying imported attachments in Jama helps confirm correct ReqIF behavior.

Why Extra "Text" Items Appear in ReqIF Imports from DNG