Introduction
As an Xray administrator, you can configure thresholds for archiving Test Executions.
Test Execution Archiving enables the cleanup of unused Test Runs and Test Executions, reducing the number of historical Test Runs that may add complexity without providing value or defining the status of any Requirements.
Check Test Run Archiving and Archiving Xray Issues for additional information.
How it Works
Archiving Test Executions allows you to hide them in Xray/Jira while preserving their data, so you can access it if needed later. This helps reduce clutter in Xray and Jira views, especially when importing automated Test results into Xray.
Test Runs can accumulate quickly, but usually, only the latest results are relevant. Older Test Execution Issues can be archived automatically by Xray, using Jira's Issue archiving mechanism.
Archived Test Executions Data
Archiving Test Executions does not delete Test Run data. Archived Test Execution Issues are hidden from Issue views, Xray reports and gadgets, and will not appear in Issue searches. To locate them, you will need to save their Issue key.
You can access archived Test Executions like any other archived Issues in Jira; however, Test Run data will only be visible once the Test Execution Issue is unarchived.
Test Executions Eligible for Archiving
All Test Executions within the selected projects (Figure 2 - 3) are eligible for archiving, except those with Test Runs that directly impact Requirement status. For example, if Requirement A is marked as "FAIL/NOT OK" due to Test Run A, this Test Run will not be archived, as it reflects the current status of Requirement A in Xray reports. The same holds true for Test Runs that affect the latest results in a specific version, Test Plan, or environment. Therefore, a Test Execution will only be archived if none of its Test Runs affect the Requirement status and all Issues it contains are eligible for archiving.
Unarchived Test Executions
If a Test Execution is manually unarchived, it will not be affected by the scheduled automated Test Execution Archiving process again within 24 hours due to performance reasons.
Access
On your Jira Data Center instance, click the gear icon (Figure 1 - 1) and then select Manage Apps (Figure 1 - 2).
An Xray menu will open on the left side of the screen. There, click the Test Execution Archiving option (Figure 2 - 1) and the Test Execution Archiving screen opens (Figure 2).
Figure 2 - Menu
Configuration
Feature Enablement
Use the toggle (Figure 2 - 2) to enable/disable the Test Execution Archiving.
Adding Projects
You can add Projects by clicking the Add Projects button (Figure 2 - 3) and selecting the projects containing the Test Execution Issues you wish to archive. Then, they will appear right there (Figure 2 - 3).
Configuring the Threshold for Archiving Test Executions
The threshold can be set to a value between one day and two years. Use the slider (Figure 2 - 4) or select one of the predefined time frames (Figure 2 - 5) to choose the desired value, with a maximum limit of two years.
You can also specify how frequently you want Test Execution Issues to be archived (Figure 2 - 6).
Once you're finished, click Save (Figure 2 - 7).