Pre-Requisites

• Windows PowerShell script execution policy must be set to RemoteSigned.
  To do so, 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.

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 configure the Configames and their associated execution settingswith settings used for test case executions.
• 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 executes the offline suite.
• 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 notepad editor.
2. Enter the required information as shown in the following table.

Configuring the Confignames 

A Confignames is a pre-defined set of configured settings for different instances used to execute test cases.  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.

If you do not specify any setting, then Qualitia uses the values defined in the associated execution profile.

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
  
  Note: 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.
   This file contains all the master list of configurations. A configuration contains confignames and arguments under this configuration.
2. Do one of the following: 

• Adding All the Parameters in the arguments Cell 

  Anchor
  AllInOne AllInOne

  
  

  Under the arguments column, you can add all the values of parameters in the key=value format and separate parameters with a single space.

  The following screenshot is an example of adding arguments.

  

  • Adding all the Parameters Separately in Different Columns

   

  Anchor
  Separate Separate

  
  You need to define columns for each parameter for every configname . For every confignames, add values for each paarameter. 
  
  The following screenshot shows an example on how to add parameters for each setting.
  
   

Mapping the Configured Confignames for Test Cases

For every test case, you need to map with the different confignames for having executions on different browsers, environments, and settings.

To map the configured Confignames with Test Cases:

1. Open the test-configs.csv file in any CSV supported file such as MS-Excel.
2. Enter the A1 cell as TestCase_Name.
3. Under the TestCase_Name column, enter every test case name in different cells as specified in Offline Suite folder.
4. Starting from B1, enter all the config names in each cell of the top row as defined in master-configs.csv.
5. Under the TestCase_Name column, for every test case, enter Y against each Confignnames that you want to execute. Else, enter as N, if you do not want execution for a Configname.
   
   The following screenshot shows an example of how to map confignames with test cases.

Parallel Execution of Test cases using Windows PowerShell 

Anchor
ExecutionofTestcasesusingWindowsPowerShell ExecutionofTestcasesusingWindowsPowerShell

To execute test cases using Windows PowerShell:

1. Launch Windows PowerShell.
2. Enter cd and the location of the execution scripts folder. For example, enter as cd C:\Qualitia\Scripts.
3. Run the following command to start parallel execution for the test cases of the offline suite: 
   .\exec-parallel.ps1

Suite Execution Summary Report

After the test case execution completes, Qualitia generates a high-level summary report for the test cases executed in the specified environments. The suite execution summary report displays the test case names and the number of total passed and failed test cases. You need to click the execution status (Pass/Fail) to view the step-by-step report of test case execution.

You need to manually update a test case execution result in Real Time Reporting Portal. For more information, refer to Uploading a Test case or Test Suite Execution.