Run a script

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.

Back to top

Prerequisites

Review the following requirements:

  • Open a codeless automation script:

    ValueEdge module How to open a script
    Functional Test > 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.
    Functional Test > 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 Functional Test Design.

Back to top

Run a script

Perform the following steps to run a codeless automation script.

To begin a run:

  1. Add your applications to the Script applications pane. See Configure your applications.

  2. 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.

  3. In the dialog box that opens, select the applications on which you want to run the script and click Start running.

    The run session starts. A progress bar is displayed on each application card in the Script applications pane.

  4. 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.

Back to top

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.

Back to top

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 with a Codeless Test or a Unit.

To associate a script:

  1. Click the Associate button on the top toolbar.

  2. Select the entity type you want to create and associate: New Codeless Test or New Unit.

  3. Click Associate. A new Codeless Test or Unit is created and associated with the script. Any parameters defined in the script are created in the test or unit as well.

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

  4. 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 ValueEdge module in which the entity is opened depends on which module you used most recently. This might be the Backlog submodule, the Quality module, or the Execution submodule.

To unassociate a script:

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

  1. Open an associated script.

  2. Click the down arrow next to the associated item's icon .

  3. 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.

Back to top

See also: