Handling OLE Object Links in ReqIF Imports to Jama Connect

Overview

This article explains why some images in ReqIF imports appear as OLE Object links in Jama Connect, why some of these links fail, and how to properly handle OLE file attachments.

1. Why Do Some Images Show as OLE Object Links?

✔ OLE (Object Linking and Embedding) is a Microsoft technology that allows files (e.g., Word, Excel) to be embedded inside other applications.
✔ ReqIF files from Integrity or DOORS may include OLE objects as links rather than standard image files.
✔ Jama does not natively support OLE files, so DX:

• Imports a preview image for the OLE.

• Creates a separate attachment link for the OLE file.

• The OLE file must be downloaded and opened externally in a compatible program (e.g., Word, Excel).

2. Why Do Some OLE Links Work While Others Fail?

✔ Possible Causes for Broken OLE Links:

• The OLE file did not have a file extension, causing DX to fail the upload.

• The original OLE file was missing or corrupted in the ReqIF package.

• DX created the attachment record but failed to upload the file, leading to a null reference.

✔ Solution:

• Check the original ReqIF directory to verify that each OLE file has a proper file extension.

• Update the ReqIF file to manually add file extensions and correct broken references.

• Ensure DX uploads the actual OLE file and does not create an empty attachment.

3. Can OLE Links Be Removed, Keeping Only Preview Images?

✔ Yes, if the customer only needs the image preview, the OLE link can be deleted.
✔ This removes the broken link while keeping the visual reference.
✔ The decision should be made in collaboration with the customer, as some workflows may require access to the original OLE file.

4. Best Practices for Handling OLE Attachments in ReqIF Imports

✅ Ensure all attachments have file extensions before import.
✅ Check that the ReqIF file properly references each attachment.
✅ Communicate with the customer to determine whether OLE links should be retained.
✅ Consider testing JCI (Jama Connect Interchange) for alternative ReqIF handling.

5. Conclusion

• OLE Object links appear in Jama when ReqIF attachments use Microsoft OLE embedding.

• DX imports an image preview but requires external access to the OLE file.

• Broken OLE links are usually caused by missing file extensions or upload failures.

• Links can be removed if only the preview image is needed.