Resolving Missing Test Steps in Jama-to-Jama ReqIF Migrations via DX

Overview

This article explains how to troubleshoot missing test steps in Jama-to-Jama migrations using DX, including known bugs, settings verification, and available workarounds.

1. Problem: Test Steps Are in the ReqIF File but Not Importing

✔ Observed Behavior:

• Test steps exist in the ReqIF export from Jama.

• Import does not display a "Steps" field to map in DX.

• Test cases are imported without their steps.

• No errors appear in DX logs, but steps do not get processed.

✔ Possible Causes:

• DX does not recognize the testCaseSteps field due to missing mappings.

• A DX version update broke XML parsing, preventing steps from being processed.

• Exchange Test Case Steps setting is not enabled.

2. Verifying Test Step Data in ReqIF Before Importing

A. Check ReqIF File for Test Step Data

✔ Open the ReqIF XML file in a text editor (Notepad++, VS Code).
✔ Search for:

css

CopyEdit

<SPEC-OBJECT>

✔ Look for fields related to testCaseSteps or test steps.

B. Confirm "Exchange Test Case Steps" is Enabled in DX

✔ Navigate to DX Settings and verify:

sql

CopyEdit

☑ Exchange Test Case Steps

✔ If this is unchecked, enable it and retry import.

3. Known Bug: DX Not Recognizing "testCaseSteps" Field

✔ Issue Identified: DX is not recognizing the tool extension for test steps.
✔ Cause:

• Recent XML parsing optimizations removed support for the testCaseSteps field.

• DX does not process steps separately after creating test cases.
  ✔ Fix Status:

• A defect has been logged (EES-EESD-440).

• A DX code update is required to resolve the issue.

4. Available Workarounds

A. Use the DX 3.9.4 Snapshot Version

✔ A temporary DX version before the XML parsing change may restore test step imports.
✔ Download Link (Internal Use Only):

pgsql

CopyEdit

DataExchange-3.9.4-SNAPSHOT.jar

✔ Steps to Use Snapshot Version:

1. Replace DX 3.8.4 or newer with DX 3.9.4 snapshot.

2. Re-run the export/import process and check test steps.

B. Manually Reinsert Test Steps Post-Import

✔ If steps do not migrate, manually add them by:

• Extracting step data from ReqIF and reimporting as a separate field.

• Using a script to map test steps after test case creation.

5. Best Practices for Test Step Migration in DX

✅ Always validate test steps in ReqIF before import.
✅ Ensure "Exchange Test Case Steps" is enabled in DX settings.
✅ If using DX 3.8.4+, test with DX 3.9.4 snapshot for step migration.
✅ If test steps do not migrate, manually extract and reinsert them.

6. Conclusion

• DX currently has a bug preventing test step recognition.

• A fix is in development, and a snapshot version is available as a workaround.

• Manually verifying test step data in ReqIF before import can prevent issues.