Test case versioning

The version history feature in Test Management allows you to track and review changes made to test cases over time. You can see who edited the test case, when the edits were made, and what specific changes occurred. This enables you to understand modifications and revert to earlier versions if necessary.

View test case version history

To view the version history of a specific test case:

1. Navigate to the folder which has the test case you wish to review.
2. In the Test Case details view panel on the right, click the versions (displayed as a clock with a number indicating the count of changes).

The Version History panel opens showing all past versions and edits.

Details in the version history log

Each entry in the version history log includes:

• Date and time: When the change was made, shown in your local system time.
• User: The name of the person who made the change.
• Changed fields: The specific fields that were updated, along with their previous and new values.

Tracked fields

The following fields are tracked for test case version history:

Attachments and template type changes

• Adding or removing attachments: When attachments are added or removed, thumbnails of both the old and new attachments are displayed in the version history log.

• If the template type of a test case is changed:

  • An entry is added to indicate the change in template type.
  • Another entry records any changes to the steps data resulting from the template change.

Special cases

Move a test case

If the test cases is moved:

• Within the same folder: No version history entry is added.
• To a different folder: The new folder path is recorded in the version history.
• To a different project: The new project and folder path are recorded.

Copy a test case

When a test case is copied, the version history is not carried over. The new test case starts with a creation entry in its version history log.

Automation status updates

When a test case’s automation status changes (for example, from “Manual” to “Automated”), the change is recorded in the version history.

Custom fields

Changes to custom field values

Updates to the values of custom fields are recorded in the version history.

Linking or unlinking custom fields

• Linking a custom field: No entry is added until data is added or updated in that field.
• Unlinking a custom field: No entry is recorded in the version history log.

Archived test cases

• Archiving a test case: An entry is added stating that the test case was archived.
• Restoring a test case: An entry is added stating that the test case was restored.

The version history feature ensures all changes to test cases are documented, allowing for easy tracking and review. This helps maintain clarity and consistency in test case management, making it simple to understand the evolution of each test case over time.

Restore a previous version of a test case

To restore a previous version of a test case:

1. Go to the folder containing your test case.
2. In the Test Case details view panel on the right, click versions (clock icon with the version count).
3. In the version history panel, locate the version you want to restore.
4. Click the options menu (⋮) next to the chosen version, then select Restore as current version.
5. In the confirmation dialog, click Restore.

The selected version replaces the current version of your test case.

Compare test case versions

You can compare two versions of a test case to review differences before restoring:

1. Go to the folder containing your test case.
2. In the Test Case details view panel on the right, click versions (clock icon with the version count).
3. Click the options menu (⋮) next to the chosen version, then select Add to compare.
4. Select the checkboxes for two versions you want to compare.
5. Click the Compare icon.

Changes between the two versions are highlighted for easy review. After comparing, you can directly restore a version.