Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

...

Qualitia provides a set of execution scripts to perform parallel execution of test cases using Windows PowerShell.

Pre-Requisites

  • Windows PowerShell script execution policy must be set to RemoteSigned.
    You need to launch PowerShell as an administrator and execute the following command: Set-ExecutionPolicy RemoteSigned.

  • Create an Offline package and the Offline Suite.  For instructions on how to create an offline package and offline suite, refer to Offline Package.

Info

You can execute Parallel Executions on Selenium Grid, but Selenium Grid cannot be used to manage the parallel executions.

Configuring the Execution Script for Parallel Execution
Anchor
ConfiguringExecutionScript
ConfiguringExecutionScript

Every machine that has Qualitia Client contains the execution script used for parallel executions at the following location:

%LocalAppData%\QualitiaWDClient\app-x.x.x\Scripts

This execution script has the following three files:

  • arguments.ps1: To configure the locations for test artifacts: Offline Package, associated offline suite, and the reports folder.

  • master-configs.csv: To define Confignames and configure their settings.

  • test-configs.csv: To map every test case with the defined Confignames.

Configuring the Locations for the Associated Test Artifacts

You need to configure the location for the following test artifacts: 

  • Offline Package: The software package that is used to execute the offline suites.

  • Offline Suite: The offline copy of a test suite that contains the test cases.

  • Reports: The test case execution results which also contains screenshots and the associated logs. 

To configure the location for the associated test artifacts:

  1. Open the arguments.ps1 

    Anchor
    arguments.ps1
    arguments.ps1
    in a text editor, such as Notepad or Notepad++.

  2. Enter the required information as shown in the following table.

Argument 

Description

$offline

Enter the absolute path for the Qualitia Offline Package. 

$suitepath

Enter the location for the offline suite folder.

$logpath

Enter the location for the folder where you want to save test case execution reports and logs.

$temppath

Enter the location for the folder where you want to save the temporary files that are generated during test case executions. 

...

Configuring the Confignames 

A Configname is a pre-defined set of configured settings used for a specific execution instance. For example, if you want a test case to execute on Internet Explorer 11, Firefox 76.x, Chrome 81.x, then you can define confignames such as IE_11, Firefox_76, and Chrome_81.

You can configure the settings of a Configname in one of the following ways:

  • Entering all the parameters in the arguments cell

  • Entering all the parameters separately in different columns

    Info

    You need to open a json file of an execution profile located in the Execution Subfolder of offline suite folder. For example for defining a browser, type as BrowserName and browser as explorer, Google Chrome and Firefox.  

    If you do not specify any value to a specific parameter for a configname, then test cases are executed as per the associated execution profile.

To configure the Confignames:

  1. Open the master-configs.csv file.

  2. Enter as configname and arguments in the cells: A1 and B1.

  3. To add values for settings of a configname, do one of the following:

To add all the parameters in the arguments Cell

Anchor
AllInOne
AllInOne

Under the arguments column, add all the values of the settings in the key=value format and separate the parameters with a single space as shown in the following screenshot:

To add all the Parameters Separately in Different Columns

Anchor
Separate
Separate

  1. In the top row next to arguments, enter the name settings in each cell as defined in the execution profile json file.

  2. For every configname, add values for each setting as shown in the following screenshot:

    Info

    If you do not specify any value to a specific parameter for a configname, then test cases are executed as per the associated execution profile.


Mapping the Configured Confignames for Test Cases

For every test case, you need to map with the different Confignames.

To map the configured Confignames with Test Cases:

  1. Open the test-configs.csv file.

  2. Enter TestCase_Name in the A1 cell.

  3. Under the TestCase_Name column, enter every name of test case of the offline suite in the same sequence.

  4. Starting from B1, enter all the Confignames in each cell of the top row as you have defined in master-configs.csv.

  5. For every test case, do the following:

    • Enter Y against the Confignnames that you want to execute.

    • Enter N against the Confignames that you do not want to execute.

The following screenshot shows how to map confignames with test cases.

...