Jira Datacenter supports archiving of issues and projects since v8.1. By archiving issues, Jira will remove them from the indexes. The archived issues will still be accessible in read-only mode, however, they will not appear in Jira searches. This enhances Jira performance because Jira it stores less data .

This page describes the known impact and limitations of archiving issues in Xray.

...

in the indexes.

Xray supports this feature. Archiving its issue types has the same effect of archiving any other Jira issue type. Additionally, Xray extends this feature by archiving its related data as well.

Archiving Test Executions

Archiving old Test Executions is a good

...

use case for archiving Xray issues

...

, especially if continuous integration processes

...

are used. These can quickly create many Test Execution issues while importing new execution results into Xray on a daily basis.

...

This feature is on our Roadmap.

These issues are good candidates to be archived.

Archiving a Test Execution issue automatically archives its related Test Runs as well. Archiving Test Runs will not delete the Test Run information from database, they are just hidden from issue views, reports, gadgets and are no longer used for the calculation of the Test Run Status and Requirement Status. It is still possible to browse archived Test Runs and even navigate into the execution page to see the execution results.

Archiving Tests

Archiving a Test issue automatically archives its related Test Runs with the same effects described previously. Additionally, archived Tests no longer participate in the calculation of the Requirement Status and on the Requirement Test Coverage analysis.

Archiving Test Plans

Impact of Issue Archiving on the issue data tables sections

For more information on archiving issues please visit JIRA documentation.

Test Run Status

Archiving a Test issue

Even though the Test is read only, it still can be executed from the Test Runs section and the fields from the execution page can be edited (evidences, steps, comments, custom fields, etc).

Archiving a Test Execution

The Test Execution will still contribute for the Test Run Status of the Test. However the Test Execution will not be listed in the Test Run Section of the Test and there will be no indication that an archived Issue is affecting the Test Run Status.

Image Removed

Requirement Status and Coverage

Archiving a Test

The Test Issue still contributes to the Requirement Status, even after reseting this custom field. However the Test is not included in the Test Coverage and there is no indication that an archived Test is affecting the Requirement Status.

Image Removed

When clicking on the link in the Requirement Status bar the Test will not be found in the JQL search.

Image Removed

Archiving a Test Plan

In the Test Coverage Section we will not be able to perform the analysis in the scope of the archived Test Plan because the Issue will not be found in the selector. However, the Test Plan still contributes for the coverage.

Test Execution Overall Execution Status

When archiving a Test it will still contributes to the Overall Execution Status. However, the Test will not be listed in the Tests Section.

Image Removed

Test Plan Overall Execution Status

When archiving a Test issue it will still be included in the Overall Execution Status. However, it will be count with the wrong status (in the example bellow it should be FAIL) and will not be included in the Test list.

Image Removed

The Overall Execution Status bar of the Test Plan board behaves the same way.

Image Removed

Issue Section data tables

Issue sections will not display the associated archived issue. Instead it will display an empty filtered table. See the example bellow for a Test associated with an archived Test Set.

Image Removed

This will affect the following Issue page sections:

• Tests Section of Pre-Condition page
• Tests Section of Test Execution page
• Tests Section of Test Plan page
• Tests Section of Test Set page
• Test Runs Section of Test Page
• Test Plans Section of Test Page
• Test Sets Section of Test Page
• Pre-Conditions Section of Test Page

Test Repository/Test Plan Board

There is an incorrect Test count if the archived Test is associated with a folder. Also the Test will be visible if associated with a folder, otherwise it will not appear in the orphans.

Image Removed

Automated Steps Library

When archiving a Test it still being included in Tests count but the JQL link will not work.

Image Removed

Reports

According to JIRA documentation, archived Issues will no longer appear on the reports. This is not always the case for Xray reports.

All Requirement reports

• Requirement Status is still affected by archived Test
• Test Plan scope analysis is not possible because the archived Test Plan is not found by the selector component

Traceability Report

• Archived Tests are included in the report
• Archived Test Executions are Included in the report
• Archived Defect Issues are included in the report.

Overall Requirement Coverage Report

• Archived Tests are included in Tests counts but JQL link will not work

Test Plans report

• Archived Test is included in Tests counts and included in wrong status (it is wrongly included in TODO). JQL link will not work.
• Archived Test Execution is included in the #Test Executions column but the JQL link will not work.
• Archived Defects are included in the report but JQL link will not work.

Test Executions Report

• Archived Test is included in Tests counts but the JQL links will not work.
• Archived Defects are included in the report but JQL link will not work.

Test Runs Report

• Test Run for archived Test is included in the Report.
• Test Run for archived Test Execution is not included in the Report. This is not coherent with the archived Test behavior.
• Archived Defects are included in the report but JQL link will not work.

Gadgets

According to JIRA documentation, archived Issues will no longer appear on dashboards. This is not always the case for Xray gadgets.

Tests Evolution gadget

The archived Test is being included in the Total value but not on statuses.

Image Removed

Test Runs List gadget

• The archived Test is listed in the gadget.

Requirements List gadget

• Archived Test is still affecting the Requirement Status
• Test is included in Tests counts but JQL link will not work

Test Runs Summary

• Test Run from archived Test is included in the report.

Historical Daily Requirement Coverage Report

• Archived Test is still affecting the Requirement Status.

Overall Requirement Coverage Report

• Archived Test is still affecting the Requirement Status.

REST API V1.0

Test Runs

Even though the Test is read-only, the Test Run can still be edited using the endpoints (PUT|POST|DELETE) /rest/raven/1.0/api/testrun/{id}/status/*.

see Test Runs - REST.

Test Repository

When Using GET /rest/raven/1.0/api/testrepository/<projectKey>/folders the archived Test is included in counts.

PUT and POST can also be executed, even though the Test Issue is read-only.

see Test Repository - REST.

Import Execution Results

• Execution results can be imported even though the Test issue is archived
• For archived Test Execution it will return an error

REST API V2.0

Test Runs

• PUT on /testrun is possible even when Test is archived
• PUT on /testrun is not possible when Test Execution is archived

Import Execution Results

• Execution results can be imported even though the Test issue is archived
• For archived Test Execution it will return an error

JQL Functions

The cases noted in the table below are not necessary wrong, but due to their peculiarity deserve some reflection.

...

requirements

...

requirementsWithStatusByTestPlan

...

testTestSet

...

testTestSet

...

testsWithNoTestSet

...

testPreConditions

...

preConditionTests

...

testRequirements

...

requirementTests

...

testExecutionTests

...

testTestExecutions

...

testSetPartiallyIn

...

testSetFullyIn

...

testPlanTests

...

testPlanTestExecutions

...

testPlanRequirements

...

testTestPlan

...

Xray Integrity Checker

There is a peculiarity with the following entries of the Xray Integrity Checker

• Clear Test Set Test Count and Test Plan Test Count Custom Field
• Clear Test Execution Defects Custom Field

...