Manually associating automated test results with test cases

Associating automated test results with test cases is essential for viewing traceability between requirements, test cases, test results, and any related issues in Helix ALM.

When you review the results of a build in Helix ALM, you should look for automated test results that are not associated with a test case and then associate them if they are related.

When you manually associate test results with test cases, you can add the test case to the parent automation suite that contains the build the test result is in. Helix ALM automatically builds a unique name for the automated test from data in the XML report results file. Any time results for the rest are submitted after the manual association, the results will be automatically associated with the same test case. No changes to the automated test script are required. Keep in mind that changes to the script could break the association because the unique name is automatically generated by Helix ALM.

Note:  For best results, we recommend using automatic association between test results and test cases. This removes the manual intervention needed to associate test results and test cases, and ensures that association occurs for every build. See Automatically associating automated test results with test cases

1. Click Automation Suites in the left navigation area.

The Automation Suites list opens.

2. Click the suite name or number. You can also select the suite, click Actions, and choose View.

The suite page opens.

3. Click the Builds tab.

4. Click a build date or number. You can also select a build and click View.

The build page opens.

5. Click the All Results tab.

Tip:  You can also work with unassociated test results from the latest build on the Automated Test Result Status tab on the Summary tab.

6. Look for results that do not have any test cases displayed in the Associated Test Cases column. To easily see unassociated results, you can also clear Associated results and select Unassociated results in the Display Options pane.

7. Select an unassociated test result, choose Actions, and then select Associate with Test Case. This action is not available if the parent automation suite is inactive.

The Associate Automated Test Results dialog box opens.

8. Click Add to select the test cases to associate with the selected test result.

The Select Test Cases to Associate dialog box opens.

9. Select the test cases to associate with the test result.

To find test cases, you can search, apply a filter, or view a list of recently accessed items. If you know the test case URL, you can paste it in the search field to easily find it.

Note:  If an automatic association did not occur when results were submitted to Helix ALM because the test case was not in the suite indicated by the script ID, you can click the Test Cases with Script IDs tab to see those test cases.

10. Click Select.

You return to the Associate Automated Test Results dialog box. A preview of the selected test cases, results associated with the test cases, and the status is displayed so you can understand how the association will affect the selected build and future builds. The Changes column indicates how the results will be associated with the test case. If the result and test case are already associated, the column is empty.

Tip:  Click the Expand All button to expand all test cases or the Collapse All button to collapse all expanded test cases.

11. To remove a test case from list to associate with the result, select it and click Remove.

12. Select Add test cases to parent automation suite to update the parent automation suite for the build to include the test cases when creating the association.

13. Click Associate.

The test results are associated with the test cases.