Test script versioning

Using native version control, ALM Octane tracks every saved version of your test.

Save test versions

ALM Octane uses different types of versions for tests:

Unlabeled versions. Versions not named by you. If you do not enter a name, ALM Octane creates a new test version each time you save the test. For automated Gherkin tests, view when the script version is injected from an external source.
Labeled versions. Versions named by you.

To create labeled versions:

After making changes in the Steps tab (manual tests) or the Script tab (Gherkin test), click Save Version.
Enter a label and click Save.

View versions

It can be useful to view versions for comparison or other reasons.

To view versions of your test:

In the Steps tab (manual tests) or the Script tab (Gherkin test) for your test, click Versions. ALM Octane displays the Versions View window.
By default, ALM Octane displays only named versions. To see all versions, clear Show major versions only.
Look at each version.

For example, for automated Gherkin tests, identify if a script is injected from an external source. In the Revision column, the 3rd digit on the right displays the relevant number, and the Is external column displays Yes.

Revert to a previous version

At times, you may need to revert to an older version of a script.

To revert to previous versions of a script:

In the Steps tab (manual tests) or the Script tab (Gherkin test) for your test, click Versions. ALM Octane displays the Versions View window.
Select the version and click Set as latest version.

This creates a new version with the same content as the version you selected. This new version becomes the current and latest version. ALM Octane discards your current test script.

The Versions window closes and you return to your test.

Next time you open the Versions window, see Reverted to and the date and time of the revert, listed as a new version.

Compare versions

Comparing versions of tests lets you see what has changed between versions.

To compare test versions:

In the Steps tab (manual tests) or the Script tab (Gherkin test), click Versions. ALM Octane displays the Versions View window.
Select one of the versions you want to compare.
Click Compare. ALM Octane displays the Compare window. The selected versions display side-by-side.

ALM Octane highlights the differences between the versions in yellow.

Manage releases assigned to versions

When you run a test, ALM Octane selects the version of the script associated with the release assigned in the run details. Edit this association in case of a mistake or if you need to associate a version without running it.

This is useful when planning or running tests from previous releases. Use the script version associated with the previous release without the later changes.

To assign a version to a specific release:

In the Steps tab (manual tests) or the Script tab (Gherkin test), click Versions. The Versions dialog box is displayed.
In the Releases column, click in the required row, and select a release from the drop-down list. In the autocomplete search box, you can type numerical values to search for releases.