# Executing a Test Run

Once the Test Run is set up, it is recommended to set the **Test Run status** to **Executing**. This indicates to all Testers that they can start executing their Tests. The Test Run can be accessed by multiple users in parallel.

To execute a Test, **click** on the arrow/play button on the Test row and an Execution object will be displayed. Data from the Test Case, Configuration, and Test Run is automatically copied to the Execution copy according to the definition in the templates. Fill out the necessary fields in the Test Result object. If applicable, creates and assign Issues/Deviations to test steps that are not passed.

![](/files/-MOpkTcl1gPGLYJAsNjy)

Save the Test Result object. The Test Run will now indicate the result of the execution in the Test Grid and in the progress bar on the Test Run main page. 

![](/files/-MOpkete_uBvgzxE8HYH)

### Editing Test Cases, Configurations, and Test Results in a Test Run

As long as a Test Case has not been executed, the user is free to update the Test Case. The Test Run will automatically update itself to reflect your changes. The same goes for the Configurations.

However, as soon as a Test has been executed, updating the Test might invalidate the result. Therefore, when opening a Test that has been executed and is part of a non-completed Test Run, you will be duly warned that editing the Test might invalidate the current Test Result.

![](/files/-MOplNZMjwcodX_jcDSr)

If you go on and update the Test, Aligned Elements will: 

* Mark the Test row as invalid in the Test Run, painting the corresponding row grey.
* Prevent you from making any changes to the objects in the Test Row.

![](/files/-MOplrIeAXHw-2UabToi)

The Test Run is now in an inconsistent state. To resolve the situation, you must use the **Refresh** button. This will present you with two choices:

![](/files/-MOpm-jsXDE3XD-QUuK3)

1\) Update the Test to the most current revision and invalidate the Test Result. The Test Result is removed from the Test Run. This situation is applicable if the change to the Test was major and makes the existing result invalid.

{% hint style="info" %}
Note! Even though the Test Result is removed from the Test Run, the trace between Test Case and the Test Result remains.
{% endhint %}

2\) Update the Test to the most current revision and declare the existing Test Result to be consistent with the update of the Test. This implies automatic copying of the attribute values in the Test Case to the Executed Test Case where applicable. This situation is applicable if the update to the Test was minor and does not affect the result. In this case, the data from the Test Case is written into Executed Test Case.

{% hint style="info" %}
Note! This second option is not applicable if the same Test Case has been executed in a different Test Run with the same configuration.
{% endhint %}

{% hint style="info" %}
Note! The second option cannot be applied if the Test Case has changed the number of rows as part of its change.
{% endhint %}

A similar behaviour is triggered if you modify a Configuration that has been used in a Test Result.

### Removing a Test Case

Click **Remove** and confirm to remove the Test case from the Test Run.

{% hint style="info" %}
Note! Removing a Test case (and its Test Result) from a Test Run does not mean that the Test or Test Results are disabled or that the Test Run information is removed from the Test Result.
{% endhint %}

{% hint style="info" %}
Note! If a Test Case was executed to create a Test Result, then remove from the Test Run and then added back, the Test Result (and, if applicable, the Configuration) will also be added back to the Test Run.  
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aligned.ch/aligned-elements-web-client-user-manual/3.2.287.25450/manage-tests/test-runs/untitled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.