# Versioning

**Version Management**

aqua offers the user the option to manage versions of all elements such as requirements, defects, test cases and test scenarios. This allows you to store auditable requirements, test cases and defects. It enables you to work with different versions of elements and to restore the old document status of individual elements. Changes can be easily tracked by the software cycle and are displayed visually. New or alternative versions of elements can be managed.

**Item Version**

The key element is `Item version` which specifies the versions of elements. (Project Configuration -> Template)

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FLWvmxaDoN59POV11a7m9%2Fimage.png?alt=media&#x26;token=a0a2b964-e4df-473c-8d96-1fe95acb30e8" alt=""><figcaption></figcaption></figure>

The values for `Item version` can be edited by using the corresponding buttons. In addition, a default value for all newly created elements can be set. Metric scales (e.g. 3.4 or 5.0) and non-metric code names (e.g. 4.0 beta, lollipop, jelly beans) can be used. To create a new version of an element, select this element in the navigation and select `Create New Version` in the context menu.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FKjlhFRrQ3ON6GGeiPyIM%2Fimage.png?alt=media&#x26;token=0288b992-f441-44ee-ad6e-4ddaa06c5e0e" alt=""><figcaption></figcaption></figure>

This opens a dialogue window in which the new version can be selected. The new version of an element must always be higher than the version from which it is created. This linear hierarchy is defined by the ranking of the values of the value `Item version`.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2Fui0KTJ3fzHcXEjXFel7d%2Fimage.png?alt=media&#x26;token=56c434c5-8a1a-4481-95c9-a268bd729032" alt=""><figcaption></figcaption></figure>

You can expand the choice of elements for the creation of a new version by selecting some more elements in the element browser and selecting `Include in create new version dialog` within the context menu.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FYuMmjHs9MMmbDGcfuXjK%2Fimage.png?alt=media&#x26;token=4d7ff61b-ffca-4a78-81ef-acc9b19b4751" alt=""><figcaption></figcaption></figure>

To add all relevant elements of one or more elements, select `Find dependent` in the context menu.

<figure><img src="http://aquawiki.andagon.com/pictures/drex_versioning_rich_client_custom_5.png" alt=""><figcaption></figcaption></figure>

As a simplification, aqua offers the option to include the new version of test cases of a test scenario by choosing the `Add related` button.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FxzAvdcvAULR6VEyL9Gx4%2Fimage.png?alt=media&#x26;token=d801c624-dc60-45ff-9327-59b9cb21328e" alt=""><figcaption></figcaption></figure>

The `Version` column provides information on the version of the element. The elements can be listed, grouped, or sorted by version. You can also create filters for an individual representation of the elements.&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_versioning_rich_client_custom_7.png" alt=""><figcaption></figcaption></figure>

The dependencies of the individual elements can also be viewed within the context menu or the `dependencies` button. It displays which element is the newer, the older, or an alternative version.

&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_versioning_rich_client_custom_8.png" alt=""><figcaption></figcaption></figure>

&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_versioning_rich_client_custom_9.png" alt=""><figcaption></figcaption></figure>

<figure><img src="http://aquawiki.andagon.com/pictures/drex_versioning_rich_client_custom_10.png" alt=""><figcaption></figcaption></figure>

aqua displays the version hierarchy dependencies graphically. In order to clearly make the differences between versions of elements, you can use the `Compare` function for two selected elements.

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FgSLmkubn4qLlZoKvlx7v%2Fimage.png?alt=media&#x26;token=d82f5d4f-e2c5-4ff8-b9a2-51df5d12231f" alt=""><figcaption></figcaption></figure>

By selecting `Compare` in the context menu, aqua generates a so-called, `DiffReport` which highlights the differences between two items by means of colours. If the button is grayed out, you have to import the `DiffReports.aquarep` report template in the aqua report module.

You can also compare versions of test cases. The `DiffReportsTC.aquarep` report template is required for this. You can download both report templates [here](https://cdn.andagon.com/aquawiki/Reporting/DiffReports.zip).

The report templates compare all standard fields and the descriptions of the two items and, in the case of test cases, also the associated steps including the individual step descriptions.&#x20;

{% hint style="warning" %}
Do not rename the report template names.
{% endhint %}

**Modifying the Report**

If you want to modify the report to your needs, you can use the report designer to remove or replace fields within the table in the report template, e.g. with individual fields. Alternatively, you can also commission your individual customization requests for this template via <mark style="color:orange;"><welcome@aqua-cloud.io>.</mark>

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FvKMSNRVFgUD7INBVXJCp%2Fimage.png?alt=media&#x26;token=78643331-0b09-4b28-a376-1c848676b85a" alt=""><figcaption></figcaption></figure>
