Introduction

In order to be competitive in the market, it is important that your application is compatible with multiple platforms and browsers. So, it is required to perform multi-browser testing for the same set of test cases to ensure the cross-platform, cross-browser compatibility of the application.

It takes a considerable amount of time to configure and test everything on every browser, executing test cases one-by-one on each browser and OS separately.

Qualitia provides the ability to configure all the required combinations of properties and perform execution of the test cases in one go. This eliminates the requirement of configuring the properties file separately for each combination differently. 

This is achieved using Windows PowerShell and parallel execution script by Qualitia.

Prerequisites

In order to do so, ensure you are meeting following prerequisites:

• Windows PowerShell script execution policy should be set to RemoteSigned. For more information about this, please refer to the PowerShell documentation.^# 
• Execution script provided by Qualitia.*
• Qualitia Offline Package including test case XMLs.
  
  

Parallel Execution

Parallel execution is a three step process:

1. Creating Qualitia Offline Package
2. Configuring Execution Script
3. Execution using Windows PowerShell

1. Creating an Offline Package 

Anchor
CreatingOfflinePackage CreatingOfflinePackage

Creating offline package includes Packaging Execution Engine and Creating Test Packages.

For more information about this, please refer to the Qualitia Offline Package section.

2. Configuring Execution Script 

Anchor
ConfiguringExecutionScript ConfiguringExecutionScript

Once you have created the test package and offline execution engine, you can control execution of these test cases using the execution script provided by Qualitia. This execution script has three different files; arguments.ps1, master-configs.csv, and test-configs.csv.

• arguments.ps1 

  Anchor
  arguments.ps1 arguments.ps1

This file contains the following locations:

 Enclose locations in quotation marks (" ").

• master-configs.csv

This file contains all the master list of configurations. A configuration contains configuration name and arguments under this configuration.

Arguments can be processed in following two different ways:

• Adding all the arguments in single cell in a combination of the key=value pairs 
• Adding Different Columns for each Key=Value pair 

Both the ways are explained below. 

1. Adding All Arguments in a Single Cell 

   Anchor
   AllInOne AllInOne

   
   

   A single configuration can have multiple arguments and you can create as many configurations as required. All the required parameters should be added in a key=value pair in the arguments column. The key=value pair should be separated by single space.

   For example:

   Image Modified

2. Adding Keys in the Top Row and Values next to Configname 

   Anchor
   Separate Separate

   
   Qualitia users can add different columns for each argument separately. Keys must be added at the top row and values for these keys should be specified next to the configname. 
   For example:
   
    

 You can refer to the qualitia.properties, browserstack.properties, and so on files for the complete list of arguments to be used when adding arguments. You can find these property files in the Config folder of Qualitia offline package or at Qualitia installed location (%localappdata%\QualitiaWDClient\app-5.0.0\WebDriver\config).

• test-configs.csv

This file specifies the configurations to execute each test case.

Here, Qualitia users can combine the test cases (from the XML folder) and the configurations (from the master-configs.csv) to execute test cases accordingly.

1. Qualitia users must list all the config names from the master-configs.csv in the top column (refer to the screenshot below)
2. Enter the test case name and specify which configuration you want to execute the test case with. You can run single test case using multiple configurations.
    Qualitia considers test cases saved in the XML path mentioned in the Cross-Browser Parallel Execution using Qualitia file only.

3. Execution of Test cases using Windows PowerShell 

Anchor
ExecutionofTestcasesusingWindowsPowerShell ExecutionofTestcasesusingWindowsPowerShell

...

1. Launch Windows PowerShell.
2. Execute following command to run the test cases as per the configurations: .\exec-parallel.ps1

Execution Reports

Once the execution is completed, Qualitia displays a high-level summary report for the test cases executed in the specified environment(s). Execution report displays the test case names and the number of total passed and failed test cases. Qualitia users can then click the execution results (Pass / Fail) to view the step-by-step report of test case execution.

...