Versioning

Versioning enables you to view previous versions of your MBT model diagrams and unit steps. You can also see which model version is related to each MBT test. Understanding what changed from one version to the next helps analyze changes in test run behavior.

Saving versions

Version numbers have the format: <major>.<minor>.0

The following table describes how and when major and minor versions are created.

Major version Minor version
Created manually

Created automatically

After you make changes to a unit's steps or a model's diagram, clicking the Save version button.

This opens a dialog box that lets you define more information about the version, such as Version name, Release, and Description.

The version number is updated automatically, increasing the major part of the number.

A new minor version is created when you perform the following actions: 

  • Make changes to a unit's steps and save them.

  • Generate a test for a model path

  • Import a BPMN file

  • Import a model from a Json file

View versions

You can view older versions of a model's diagram, unit steps, or the model version associated with an MBT test. Viewing previous version can help analyze changes and their effects.

To view model or unit versions: 

  1. In a model, open the Model tab. In a unit, open the Steps tab.

  2. Click the Versions button.

  3. Select or clear the Show major versions only option to control which versions are visible.

  4. The table displays information about each version, such as Author, Creation time and Description. You can filter the list of versions by these fields as well.

    Select a version to view the unit steps or the model diagram of that version, in a read-only view.

    In units, you can click the Compare button to view versions side by side.

To see the model version related to a test:

In an MBT test, in the Details tab, the Model Version field displays the version ID of the model that is related to this test.

Tip: The Model Version field is not editable. If you want to relate a test to a newer version of the model, you need to create a new MBT test from that version.

In test grids showing MBT tests, you can filter the list by various attributes of the associated model version, such as Author, Description, and Version name.

See also