Execution Templates

Overview

Through execution templates you can wrap test cases at runtime to use your defined execution conditions for multiple scenarios. For example, instead of copying, pasting, and maintaining multiple test cases, you can create a single template that acts as a boilerplate to wrap the test cases at runtime.

Note: Available for test automation only.

Dependencies

• Testing Activities Package
• System Activitities v21.10.0 or higher

Conditions

• When you run or debug the file, the test case and its associated execution template are merged into a temporary file. The collection of arguments and variables from both files are compared by name at runtime. If the execution template shares a matching argument or variable name with the test case, it will be linked in the Invoked Workflow File after the merge. If the test case does not have any matching arguments with the execution template, the arguments from the former file will be copied to the latter.
• Moving or renaming an execution template automatically updates its associated test cases.
• When publishing a project with execution templates, any publishable test cases are merged with the execution templates. The resulting files are the project entry points.

How it works

The execution template acts as a wrapper for test cases. In the Designer panel, you can see a Placeholder activity within the execution template.

This activity is going to be replaced at runtime with an Invoke activtity, adding the invoked test case to the execution template, as you can see in the following image.

Working With Execution Templates

To run a test case inside an execution template at runtime, you need to follow these procedures:

1. Create execution template
2. Add test case to execution template

Create execution template

Create an execution template before setting it to a test cases.

1. Open your workflow in Studio.
2. In the Projects panel, right-click the File Templates folder to open the dropdown menu.
3. Navigate to Add > Execution Template.

4. Enter a Name for your execution template and choose the Location where it is going to be stored.

   
   

   

   
   

   A new tab opens in the Designer panel with your execution template. You can build the template to match your testing needs.

   
   

   

   
   
5. Click Save when your execution template is done.

Add test case to execution template

To run or debug a test case with an execution template, you need to add it to an execution template (Set Execution Template). Alternatively, you can set an execution template for a newly created test case.

1. Open your test case in Studio. If you do not have one yet, you can create a test case.
2. In the Projects panel, right-click a test case to open the dropdown menu.
3. Click Set Execution Template and select a template from the dropdown list.

4. Click Ok to confirm. The execution template is added to the test case. Running or debugging this test case will proceed according to your associated execution template.

   
   

   

   
   

Now you can run or debug the test case as it will be executed with the execution template.

Tip:

• Add test data to your test case
• Publish test case to Orchestrator

Remove execution template from test case

1. Open your workflow in Studio.

2. In the Projects panel, right-click a test case to open the dropdown menu.

   Note: Hover the mouse over a test case to show whether it is added to an execution template or not.
3. Click Set Execution Template and select <no execution template> from the dropdown list.
4. Click Ok to confirm.