Run scripts

This topic explains how to run a codeless automation script locally and how to associate it with tests and units.

Overview

While designing a script, you can run it locally, to make sure that it functions as you expect.

You can use the same script to test multiple applications or environments. You can select an application when you run the script, or you can add applications to the script's application list and run on one or more in a single run session.

After the script is ready, associate it with a codeless test or a unit. You can then include the script in a scheduled run or an MBT test.

If you associate your script to a unit, and run it as part of an MBT test, the whole MBT test runs only on the first application defined for the script associated with the first unit in the test.

Prerequisites

Review the following requirements:

Open a codeless automation script:

Submodule	How to open a script
Design	On the Design Home page, click the name of a script to open it.
Quality	On the Details tab of a codeless test, click Open in Design.
Model-Based Testing	On the Details tab of an MBT unit whose Testing tool type is FT Design, click Open in Design.

Your browser must be set up to work with FT Design. See Set up the browser extension.

Run a script

Perform the following steps to run a codeless automation script.

To begin a run:

Add your applications to the Script applications pane. See Configure your applications.
Click the Run button.

To omit a step temporarily from your test run, right-click the step or block, and select Exclude from the test run.

To re-include a step, right-click it, and select Include in test run.

Similarly, you can exclude or re-include a condition block in the test run by selecting the If or Else step and using the exclude options available.
In the dialog box that opens, select the applications on which you want to run the script.

(Optional) Select the option to Keep the application open after the run.
Click Start running. The run session starts. A progress bar is displayed on each application card in the Script applications pane.
Click Stop to end the run session, or Pause to stop it temporarily.

Note:

When running a script containing input and output parameters locally, only default values of input parameters are used. Output parameters are not exported outside of the script.

To pass non-default values to the script's parameters, you must run its associated codeless test or unit, with data sets defined in the codeless test or MBT test.
When a run session is paused you cannot make any changes in FT Design.

Analyze run results

After the run session ends, the Editor displays the run result of each step (including conditional steps if there are any) for the selected applications.

Hover over a failed step to show the reason for the failure.

On the right, you can see the applications on which the script ran, and which runs passed or failed.

Click View last report to see a visual HTML report of the steps that ran and their status. This report is similar in format to UFT One reports, and saved to %localappdata%\VEFTDesign\CodelessAgent\Reports\Codeless folder.

If input parameters are used in your script, the report contains detailed parameter information, including parameter names and values.
If the script included Verify steps, the report shows the expected and actual values encountered by the step,

Click Back To Editor to go to the Editor.

Associate or unassociate your script

After you make sure that your script works correctly, associate it with a codeless test or a unit.

Note: Skip this section if your script is marked with an icon that indicates that it is already associated.

To associate a script:

Click the Associate button on the top toolbar of the script Editor.
Select the entity you want to associate:
- A New Codeless Test.
- A New Unit
- Existing Codeless Test or Unit
  
  A list displays all of the codeless tests and MBT units defined in this workspace that are not yet associated.
  
  You can filter the list by entity type or entity ID, and search by entity name.
  
  Select the entity to associate.
Click Associate to complete the association.

If you selected to associate with a new codeless test or unit, the entity is created and associated with the script.

Note: Before completing the association, any unsaved changes in the script are automatically saved.

Synchronizing parameters
- Parameters defined in the script are created in the associated test or unit.
- Parameters defined in an existing entity that you associate, are created in the script after you refresh the script and save it.
- If a parameter with the same name is defined in the script and the associated entity, both parameters are kept.
  
  The script's parameters are renamed by adding a script_ prefix to the name.
  
  The parameters are renamed in the Parameters pane as well as in the script steps.
  
  Review the list of parameters after association and decide which ones to keep.
Click the displayed entity link to view the codeless test or unit.

Alternatively, find the script on the FT Design Home page and click the ID of the associated entity to open it.

The associated entity opens in a new tab. The module in which the entity is opened depends on which submodule you used most recently. This might be the Backlog, Quality module, or Execution submodule.

To unassociate a script:

To remove the association between a script and its codeless test or unit:

Open an associated script.
Click the down arrow next to the associated item's icon .
Select Unassociate. The association between the script and the codeless test or unit is removed.

Note: When unassociating a script, any unsaved changes in the script are saved.

After unassociating a script, you can create a new test or unit for the script by clicking Associate. Alternatively, you can create a new script for the test or unit by clicking Open in Design in the test or unit.

Run codeless tests or units

After you associate your codeless scripts with a codeless test or unit, you can include it in your scheduled run or MBT model.

Add the codeless test to a test suite in the Quality module or run it in the cloud from the Execution module.

Add the unit to an MBT model and include it in you MBT test run.

You can add parameters to your test or unit, and define data sets that provide values for the parameters during a run.

In a codeless test or unit, in the Parameters tab, add parameters. You can also assign a default value to a parameter.

In a codeless test or MBT test, in the Data Sets tab, add values for each of the parameters.

When you run your test with a data set, the script runs iteratively, using one row of parameter values from the data set for each iteration.