Create and execute TestEvents

A TestEvent organizes the execution of TestCases for Tosca Distributed Execution. It contains two types of objects:

• ExecutionLists, i.e. lists of TestCases ready to be run. One TestEvent can contain several ExecutionLists.

• Configurations for these ExecutionLists, i.e. a collection of parameters that define which Tosca Distribution Agents should execute the TestCases.

Once you click Execute Now, Tricentis Tosca transfers your TestEvent to the Tosca Distribution Server. The server then assigns the ExecutionLists to Tosca Distribution Agents whose configuration matches the one assigned to the TestEvent.

To create and execute TestEvents, follow the steps below:

1. Create a new TestEvent.

2. Optionally, specify configurations.

3. Execute the TestEvent.

If you use Tosca Distributed Execution with Tosca Continuous Integration, the Tosca Continuous Integration Client triggers the execution of your TestEvents.

Create a new TestEvent

To create a new TestEvent, follow the steps below:

1. In Tosca Commander, open the workspace which has access to the common repository.

2. Open the Execution section.

3. Check out the TestEvents object.

4. Right-click the TestEvents object and select Create New TestEvent from the mini toolbar.

5. Optionally, rename the new TestEvent.

6. Drag and drop ExecutionLists onto the new TestEvent.

Specify configurations

With configurations, you can specify which agents should execute which ExecutionLists. In this case, the Tosca Distribution Server assigns the ExecutionLists to Tosca Distribution Agents which match the configuration you specified for the TestEvent.

The table below lists the default configuration categories in Tosca Commander.

Category	Description
Any	Contains all agents.
RDP	Contains all agents configured for Unattended Execution.
SupportsClassic	Only contains agents with a full installation of Tosca Commander, i.e. agents that can execute TestCases created with Classic engines, 3.0 engines, or both.

You can also create your own configurations as described in chapter "Customize execution behavior".

The configuration categories contain all Tosca Distribution Agents that fit the respective category description.

One agent can be listed in several categories. For example, an agent with a full installation of Tosca Commander configured for Unattended Execution belongs to the categories Any, RDP, and SupportsClassic:

If you don't specify configurations, Tricentis Tosca automatically uses the Any configuration. In this case, the system determines which agent can handle a particular ExecutionList and forwards it accordingly.

Execution Agents do not support TestSteps created with Classic Engines. To make sure that Execution Agents do not receive TestEvents that they cannot execute, Tricentis Tosca can check whether your TestEvents contain TestSteps created with Classic Engines. By default, this check is disabled. If you work with Execution Agents and your TestEvents contain Classic TestSteps, you must activate this check in Settings->Commander->DistributedExecution.

Specify configurations

To specify configurations for your ExecutionLists, follow the steps below:

1. Drag and drop each configuration that you want to use from the Configuration folder onto the TestEvent that you have created.

2. Within the TestEvent, drag and drop the ExecutionLists onto the configurations. A configuration applies to every ExecutionList that it contains.

Update configurations

If Tosca Commander erroneously displays your Execution Agent in the SupportsClassic configuration, follow the steps below:

1. Check out the project root element.

2. In the Execution section, right-click the Configurations object and select Update configurations from Server from the context menu.

When you check in your workspace, the configuration categories no longer display the available Tosca Distribution Agents. To see them again, right-click the Configurations object and select Refresh Agents from the context menu.

Execute a TestEvent

To run your TestEvents, you must meet the following requirements:

	The Tosca Distribution Server is running.
	The Tosca Distribution Agent is started and Idle.
	The ExecutionList is checked in.

If you use Distributed Execution without AOS (Automation Object Service), you also need to make sure that the agent workspace is not open in Tosca Commander.

To execute a TestEvent, right-click on it and select Execute now from the context menu.

Tricentis Tosca then transfers your TestEvent to the Tosca Distribution Server. The server saves the TestEvent until it is executed or until you cancel the TestEvent in the Distributed Execution Monitor.

If you use Distributed Execution without AOS (Automation Object Service) and you have the same ExecutionList in two different TestEvents, the second TestEvent is blocked until the system has executed the ExecutionList for the first TestEvent (see chapter "Monitor ExecutionLists").

Once you have executed your TestCases, refresh your workspace to display the execution results in the ExecutionLists section.

You can also monitor the execution as described in chapter "Monitor tests with the Distributed Execution Monitor".