# Test environment tracking with labels (tags)

When executing tests, it is often really important to track detailed information about the environment and / or the system under test. &#x20;

**Example A: Testing a Webshop**

When testing a web shop process, it could be important to track the

* Browser (possibly including version)
* Operating System
* Payment provider API Version
* deployed Shop Modules&#x20;

**Example B: Testing a health monitor watch**&#x20;

When testing a health monitoring device, it could be important to track the

* Prototype Number
* Software Version&#x20;
* Firmware Version
* Sensor Type
* Test chamber A

  consisting of&#x20;

  * National Instruments Testing Device A
  * Rohde & Schwarz Measuring Device B
  * …
  * Fluke Oscilloscope Z

Of course, it’s always possible to just put this information to the ‘actual result’ of a test case. But this approach has downsides when it comes to Analysis & Reporting. The information is there but hidden.

&#x20; &#x20;

{% hint style="success" %}
Now you can add your own fields to the Test run configurator in the [Project Template settings.](https://docs.aqua-cloud.io/documentation/project-configuration/old-project-template-configuration-fields)
{% endhint %}

### **Enter aqua Test Execution Labels** <a href="#enter_aqua_test_execution_labels" id="enter_aqua_test_execution_labels"></a>

&#x20;With aqua Test Execution Labels, testers can easily track detailed information like given in the examples above:        &#x20;

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FxvcyRvyNn5S5nPbzMbCT%2Fimage.png?alt=media&#x26;token=bf159f34-321f-461f-a98a-83417fab26ac" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FDA22XJuepfGzS8KVbtLK%2Fimage.png?alt=media&#x26;token=a1a3e13a-cb04-47a9-8452-41373ba22c4e" alt=""><figcaption></figcaption></figure>

&#x20;                  &#x20;

Labels can represent&#x20;

* Information about the System under Test / Application under Test / Device under Test
* Information about the Test Environment
* any other information about the executed test&#x20;

&#x20;&#x20;

### **How to add a new label** <a href="#how_to_add_a_new_label" id="how_to_add_a_new_label"></a>

&#x20;New labels can be added in the run configuration before the execution or in the execution himself. To add a new label, klick on the ![](http://aquawiki.andagon.com/pictures/drex_test_environment_tracking_with_labels__custom_3.png) and start typing to create a new label.  &#x20;

### **Adding an existing label** <a href="#adding_an_existing_label" id="adding_an_existing_label"></a>

To add an existing label also klick on the ![](http://aquawiki.andagon.com/pictures/drex_test_environment_tracking_with_labels__custom_3.png) and search/select for an existing label. With a click on it, it will be shown in the pool of selected labels. The already selected labels are highlighted in gray.  &#x20;

<figure><img src="https://3920520305-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyZbW8vbNs5hz8x57emJJ%2Fuploads%2FvLQ4BPc2Cqwr1WHvnaSu%2Fimage.png?alt=media&#x26;token=f6b9497b-adcd-4462-8f20-cb0cdf93baa8" alt=""><figcaption><p>Adding an existing label</p></figcaption></figure>

### **Editing Labels** <a href="#editing_labels" id="editing_labels"></a>

&#x20;  &#x20;

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

To edit a label, klick on it and select 'Edit'.&#x20;

This is possible in the run configuration and in unfinished executions. The name can be changed in this window. It is also possible to add a short description and to add sub-labels in the form of new or existing labels.

{% hint style="info" %}
Note: Changing the name or description does not affect old, existing executions that used the same label.
{% endhint %}

### **Super Labels aka Complex Labels** <a href="#super_labels_aka_complex_labels" id="super_labels_aka_complex_labels"></a>

&#x20; &#x20;

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

### **Deleting Labels** <a href="#deleting_labels" id="deleting_labels"></a>

Deleting a label removes it from the pool of labels presented to users in the autocomplete dialog box. Cleaning up the list of labels by deleting old or misspelled labels can make it easier and faster for the team to find and use the correct labels.

{% hint style="warning" %}
Important information: Deleting a label will never remove the label from existing trials! So even if you delete a label, your old test-runs are safe and unaffected.
{% endhint %}
