Handling Embedded Images in ReqIF Imports Using DX

Overview

This article explains how DX handles embedded images in ReqIF imports, common issues with missing images, and how to resolve them.

1. Why Are Embedded Images Not Appearing in the Imported Description Field?

✔ DX does not embed images directly in the Description field but instead references the image file.
✔ The source HTML in ReqIF may contain <img> tags pointing to external image files (e.g., .png).
✔ If the target system does not preserve image references, the images may not appear in the imported Description field.

🚨 Common Issue:

• The ReqIF file contains an <img> tag referencing an image, but the image is not included in the corresponding Jama field.

• DNG ReqIF uses <img> for embedded images, but some tools (e.g., Jama) expect ‘object’ tags instead.

• Fix available in DX v3.9.1: Images are now transformed from <img> to ‘object’ HTML tags on import.

2. How to Fix Missing Images in ReqIF Imports?

🔹 Solution 1: Verify Image References in the ReqIF File
✔ Open the ReqIF file in a text editor and look for <img src="image.png">.
✔ If the image source is missing, check whether it was included in the ReqIF package.
✔ If needed, manually add the image file to the ReqIF package.

🔹 Solution 2: Upgrade to DX v3.9.1 or Later
✔ DX v3.9.1 fixes an issue where images were not transformed correctly during import.
✔ Ensure you are using DX v3.9.1 or later to take advantage of this fix.

🔹 Solution 3: Use ‘Object’ HTML Tags Instead of ‘Img’ Tags
✔ If migrating from DNG, replace <img> tags with <object> tags in the ReqIF HTML description.
✔ Example transformation:

html

CopyEdit

<object data="image.png" type="image/png"></object>

✔ This ensures compatibility with tools that expect object references.

3. Best Practices for Handling Images in ReqIF Imports

✅ Ensure all referenced images are included in the ReqIF package.
✅ Upgrade to DX v3.9.1+ to ensure correct image handling.
✅ Manually verify the source HTML field in the ReqIF file before import.
✅ If needed, convert <img> tags to <object> for better compatibility.

4. Conclusion

• DX does not embed images directly but references them via HTML <img> or <object> tags.

• Missing images may be due to incorrect references or missing files in the ReqIF package.

• DX v3.9.1+ resolves issues with incorrect HTML tags for images during import.

• Using <object> tags instead of <img> improves compatibility.