DX 3.9 Compatibility Issues with Self-Hosted Jama

Overview

This article addresses known compatibility issues with DX 3.9 and self-hosted Jama Connect (version 8.79.4) due to changes in the relationships API endpoint.

1. Summary of Compatibility Issue

✔ DX 3.9 does not work with self-hosted Jama 8.79.4 due to missing support for the updated relationships API endpoint.
✔ Jama does not include the 'labs' relationship endpoint, which allows retrieval of more than 50 relationship links per call.
✔ DX 3.8.4 works correctly with self-hosted Jama, but 3.9 introduces incompatibilities not documented in release notes.

2. Impact on Data Exchange

🚨 Symptoms of the Issue:
✔ Relationship imports or exports may fail with serialization errors.
✔ Users may see errors in logs indicating that the new endpoint is unavailable.
✔ Despite errors, DX should default to the original method, meaning relationships should still function.

🚨 Error Message Example:
"Failed Exchange: Error during EXPORT: SERIALIZATION phase. null"

3. Recommended Workarounds

✅ Use DX 3.8.4 instead of 3.9 if working with self-hosted Jama 8.79.4.
✅ If using DX 3.9, check logs—if the new endpoint is missing, DX should revert to the old method.
✅ Request Support Bundle if encountering persistent issues.
✅ Monitor release notes for potential future fixes in DX or Jama.

4. Best Practices for Self-Hosted Jama Users

✔ Verify compatibility between DX versions and self-hosted Jama versions before upgrading.
✔ If using a version of Jama without the ‘labs’ relationship endpoint, use DX 3.8.4.
✔ Report issues via support channels to track undocumented incompatibilities.

5. Conclusion

✔ DX 3.9 has known compatibility issues with self-hosted Jama 8.79.4 due to API endpoint changes. *Upgrade to the most current version of Jama Connect
✔ DX 3.8.4 remains stable and should be used instead.
✔ Workarounds exist to minimize disruptions, but long-term fixes require vendor updates.