Resolving Missing Images in DX ReqIF Imports

Overview

This article explains how to troubleshoot and resolve missing images in Data Exchange (DX) ReqIF imports, based on an issue encountered by Halcon Systems.

1. Problem: Images Are Missing in DX Import

✔ Observed Behavior:

• The AFuzion package was imported via DX, but images were missing.

• DX logs show an error locating attachments:

  vbnet

  CopyEdit

  ERROR | a.r.d.AttachmentAssembler | Sorry, wasn't able to locate attachment [D:\Official_Documents\Jama_Connect\Data_Exchange\...] - SKIPPING

• The directory where DX looks for the images is empty.

✔ Possible Causes:

• Images were not included in the ReqIF package during export.

• Attachment paths are incorrect or point to missing files.

• DX skipped images due to file format restrictions.

2. How to Fix Missing Images in DX Imports

A. Verify If Images Were Included in the ReqIF Export

✔ Open the original ReqIF package folder and check for an attachments directory.
✔ Ensure that image files (PNG, JPG, SVG) exist in the package.
✔ If missing, re-export the ReqIF from the source tool with attachments included.

B. Check ReqIF References to Attachments

✔ Open the ReqIF XML file in a text editor.
✔ Look for image references, such as:

xml

CopyEdit

<xhtml:object type="application/png" data="b2896769-9f33-4f23-b7e0-67812d5a5272.png"/>

✔ Verify that the image file exists in the attachments folder.
✔ If the file is missing, manually place the correct image file in the expected folder.

C. Regenerate the ReqIF File with Proper Image Embedding

✔ If the source tool (e.g., DOORS, Jama, System Composer) did not package images, regenerate the ReqIF export with full attachment inclusion.
✔ For Jama exports: Ensure "Include Attachments" is enabled.
✔ For DOORS exports: Make sure OLE and embedded images are preserved in the ReqIF file.

3. Best Practices for Ensuring Images Import Correctly

✅ Always verify that the ReqIF export includes an attachments folder.
✅ Manually check ReqIF XML files to confirm correct image paths.
✅ Re-export the ReqIF if images are missing from the original package.
✅ If necessary, manually add missing images to the correct directory before import.

4. Conclusion

• DX does not import images if they were missing from the original ReqIF export.

• Verifying attachment directories and image paths ensures successful imports.

• Re-exporting ReqIF files with proper attachment settings can fix missing images.