Pre- and Post-Processing Tools for ReqIF in DX & JCI

Overview

This article provides an overview of pre- and post-processing tools for ReqIF handling in DX and Jama Connect Interchange (JCI), including bullet formatting, object conversion, and tag sanitization.

1. Available ReqIF Processing Tools

A. Clean Bullet Point Formatting

✔ Purpose: Ensures proper spacing and formatting of bullet points in ReqIF files.
✔ Relevant for: DX imports where text formatting is critical.
✔ GitHub Repo:

• ReqIF Bullet Points Spacing Sanitizer

B. Object Converter (Headings to Folders in Jama)

✔ Purpose: Converts heading objects into Folders during import.
✔ Relevant for: Mapping DOORS/DNG structured ReqIF exports to Jama's hierarchy.
✔ GitHub Repo:

• ReqIF Object Converter

C. Tag Sanitizer (Removes Unsupported HTML in ReqIF)

✔ Purpose: Cleans up unsupported HTML tags before import into Jama.
✔ Relevant for: ReqIF files containing rich text or HTML that might break DX imports.
✔ GitHub Repo:

• ReqIF XHTML Tag Sanitizer

D. ReqIF Fixing Script for DNG Corrupt Files

✔ Purpose: Repairs corrupt ReqIF files exported from DOORS Next Generation (DNG).
✔ Relevant for: DX imports failing due to ReqIF corruption.
✔ GitHub Repo:

• Fix DNG ReqIF
  ✔ JIRA Task Reference:

• CON-29012: Corrupt ReqIF Files Need Repair

2. Are These Tools Specific to DOORS or DNG?

✔ These scripts were custom-built for specific customers but may work for both DOORS & DNG.
✔ The Object Converter is the most relevant for JCI, but built-in conversion may be added later.

✔ Note:

• The object converter script is only for migration, not round-trip exchanges.

• JCI plans to integrate a built-in object converter, but the script may serve as a temporary stopgap solution.

3. Best Practices for Using These Tools in DX/JCI

✅ Use the bullet cleaner and tag sanitizer before importing ReqIF files.
✅ Apply the object converter if heading-to-folder conversion is needed.
✅ If importing from DNG, run the ReqIF fixing script before attempting a DX import.
✅ Test conversions in a sandbox environment before production use.

4. Conclusion

• Several pre- and post-processing tools exist to fix formatting, clean tags, and convert objects in ReqIF files.

• The Object Converter is most relevant for JCI, but a built-in solution is planned.

• DX/JCI users should validate ReqIF data before import to avoid errors.