Parallel testing concurrently tests multiple applications or components of an application in order to reduce overall test execution time and to increase test coverage. Now UFT also support parallel test execution with the version 14.03 .UFT got capability to run parallel testing on mobile. Use the ParallelRunner CLI tool to run multiple UFT One tests in parallel. You can run GUI tests on mobile devices and web browsers, and you can also run API tests. The ParallelRunner also supports API tests called by GUI tests, and vice versa.

Prerequisite

1.Each web test consumes a single concurrent license and requires a concurrent license server to test in parallel.

2.Close UFT One. ParallelRunner and UFT One cannot run at the same time.

Parallel Test Execution

ParallelRunner is a Command Line Interface (CLI) tool, which enables the capability to run tests in parallel. It means that you need to use or run this tool via command prompt.

Run your tests in parallel from the command line, defining your test and environment details using the following methods:

1. Passing test and environment details as command line parameters.
2. Passing test and environment details within a .json file.

Passing test and environment details as command line parameters

This method is simple and easy to use when you have single test or configuration. You will need to run east test separately with individual commands

• Launch Command Prompt
• Change directory to UFT Installation bin folder if not already
• Use command below to run your test

Command line options

Use the following options when running tests directly from the command line.

• Option names are not case sensitive.
• Use the a dash (-) followed by the option abbreviation, or a double-dash (--) followed by the option’s full name.

To run tests from the command line, use the syntaxes defined in the sections below. Use semicolons (;) to separate the alternatives. Parallel runner runs the test as many times as necessary, to test all combinations of the alternatives you provide.

Web test command line syntax

ParallelRunner -t <test path> -b <browser> -r<results path>

For example:

ParallelRunner -t "C:\GUIWebTest_Demo" -b "Chrome;IE;Firefox" -r "C:\parallelexecution"

If you specify multiple browsers, the test is run multiple times, one run on each browser.

Mobile test command line syntax

From the command line, run each mobile test using the following syntax:

ParallelRunner -t <test path> -d <device details> -r <results path>

For example:

ParallelRunner -t "C:\GUITest_Demo" -d "deviceID:HT69K0201987;manufacturer:samsung,osType:Android,osVersion:>6.0;manufacturer:motorola,model:Nexus 6" -r "C:\parallelexecution"

API test command line syntax

From the command line, run each API test using the following syntax:

ParallelRunner -t <test path> -r <results path>

For example:

ParallelRunner -t "C:\APITest" -r "C:\API_TestResults"

Example for different scenarios: 

Run the test three times, one for each browser:

ParallelRunner -t "C:\GUIWebTest" -b "Chrome;IE;Firefox"

Run the test four times, one for each data table on each browser:

ParallelRunner -t "C:\GUIWebTest" -b "Chrome;Firefox" -dt ".\Datatable1.xlsx;.\Datatable2.xlsx"

Run the test 8 times, testing on each browser, using each data table with each set of test parameters.

ParallelRunner -t "C:\GUIWebTest" -b "Chrome;Firefox" -dt ".\Datatable1.xlsx;.\Datatable2.xlsx" -tp "param1:value1, param2:value2; param1:value3, param2:value4"

Passing test and environment details within a .json file

Run ParallelRunner and reference a .json configuration file directly from the command line.In the .json file, you can:

• Specify multiple tests to run in parallel.
• Define multiple environments and parameters to use for multiple runs.

To run the ParallelRunner with a .json configuration file

1. In a .json file, add separate lines for each test run. Use the .json options to describe the environment and parameters to use for each run.
2. Reference the .json file in the command line using the following command line option:

Use the following syntax:

ParallelRunner -c <.json file path>

For example:

ParallelRunner -c C:/UFTTests/parallelexecution.json

Sample json file for Mobile

{
   "reportPath":"C:\\parallelexecution",
   "reportName":"My Report Title",
   "waitForEnvironment":true,
   "parallelRuns":[
      {
         "test":"C:\\Users\\qtp\\Documents\\Unified Functional Testing",
         "dataTable":"C:\\Data Tables\\Datatable1.xls",
         "testParameter":{
            "para1":"val1",
            "para2":"val2"
         },
        "reportSuffix":"Samsung_OS_above_6",
         "env":{
            "mobile":{
               "device":{
                  "manufacturer":"samsung",
                  "osVersion":">6.0",
                  "osType":"Android"
               }
            }
         }
      }
   ]
}

Sample json file for Web

{
 "reportPath": "C:\\parallelexecution",
 "reportName":"My Report Title",
 "waitForEnvironment":true,
 "parallelRuns": [
  {
   "test": "C:\\Users\\qtp\\Documents\\Unified Functional Testing",
   "reportSuffix": "Web_Chrome",
   "env": {
    "web": {
     "browser": "Chrome"
    }
   }
  } 
 ]
}

Sample json file for API

{
 "reportPath": "C:\\parallelexecution",
 "reportName":"My Report Title",
 "waitForEnvironment":true,
 "parallelRuns": [
  {
   "test": "C:\\Users\\qtp\\Documents\\API Test",
   "reportSuffix": "API"
  } 
 ]
}

Stop the parallel execution

To quit the test runs from the command line, press CTRL+C on the keyboard.

• Any test with a status of Running or Pending, indicating that it has not yet finished, will stop immediately.
• No run results are generated for these canceled tests.

ParallelRunner response and run results

The following code shows a sample response displayed in the command line after running tests using ParallelRunner.

>ParallelRunner -t ".\GUITest_Demo" -d "manufacturer:samsung,osType:Android,osVersion:Any;deviceID:N2F4C15923006550" -r "C:\parallelexecution" -rn "My Report Name"

Report Folder: C:\parallelexecution\Res1

ProcessId, Test, Report, Status

3328, GUITest_Demo, GUITest_Demo_[1], Running -

3348, GUITest_Demo, GUITest_Demo_[2], Pass

n this example, when the run is complete, the following result files are saved in the C:\parallelexecution\Res1 directory:

• GUITest_Demo_[1]
• GUITest_Demo_[2]

The parallelrun_results.html file shows results for all tests run in parallel. The report name in the browser tab is My Report Name.

Limitations of ParallelRunner

• Parallel Runner Supports running upto four tests in parallel. Which is good for the cases, where you need to run on multiple combination. It will need to wait till execution of your first four combinations are done
• All Web 2.0 toolkits (ASP dot NET AJAX, Dojo, Ext-JS, GWT, jQueryUI, SiebelOpenUI, and YahooUI) are not supported when using ParallelRunner.
• Below test objects and methods are not supported if used in your script
  • .Object method
  • WebFile objects
  • SystemUtil.Run method (recommended WebUtil.LaunchBrowser)
• Run results can be viewed in IE versions 10 or higher

References

https://admhelp.microfocus.com/uft/en/15.0-15.0.2/UFT_Help/Content/User_Guide/parallel-test-runs.htm