| Table of Contents |
|---|
The Qualitia Offline Package (QOP) is a portable and easily deployable bundle containing Qualitia Tests and Qualitia Execution Engine with ability to independently execute test cases and report results without Qualitia Test Automation Studio.
Qualitia Offline Package = Qualitia Execution Engine + Tests Package
QOP The offline package is created from the Qualitia Test Automation Studio and then executed in multiple environments. These environments DO NOT need Qualitia Test Automation Studio installed as Qualitia Offline contains the Qualitia Execution Engine to execute and report tests exactly as Qualitia Test Automation Studio does.Anchor
...
Offline Package - Creation
The Qualitia Offline Package lets you independently execute test cases without Qualitia Test Automation Studio. Creating an offline package is a two-step process.
- Packaging Execution Engine
- Creating Test Packages
Packaging Execution Engine
The first step of creating an offline package is to bundle Qualitia Execution Engineexecution engine.
To package execution engine:
- Log on to Qualitia Test Automation Studio.
- On the File menu, click Offline Package.
The Browse for Folder screen is displayed. - Select path to save the offline package. Note: It is
It is recommended to create new folder with the name Qualitia-offline to save Qualitia Offline offline package. - Click OK.
The QualitiaOffline.zip is created at the newly created designated folder. - Extract Qualitia Offline.zip.
Once the file is extracted successfully, execution engine is ready to use.Anchor
Creating Test Packages
After packaging the execution engine, you can create new test packages to execute in multiple environments using "Save As XML" feature in Qualitia.
The The Save As XML button on the Execute screen compiles the selected marked tests in suite and creates package.
...
To create new test
...
packages:
- Log on to Qualitia Test Automation Studio.
- Click Execute.
The Suite screen is displayed. - In the left pane, click the suite to view the test cases available under suite.
- Mark the test cases which you want to add in the tests package to be created.
Qualitia Qualitia packages only marked test cases. If you want to package all tests available in suite, mark all test cases. - Click the Save As XML button.
The Browse for Folder screen is displayed. - Select path to save the XML file.
- Click OK.
...
- Suite.xml,
- Map.xml, and
- Test Case xmls (each for one test case.)
...
Offline Package - Deployment and Execution
Once the Qualitia Execution Engine and Test Packages are created successfully, you can move this folder to any location. Before executing test cases using offline package, see the important components listed in the table below.
Property Name | Description |
|---|
qualitiaoffline-x.x.jar | It is Qualitia Execution Engine which executes tests cases. |
lib and common folders | Both these folders are required for Qualitia Execution Engine. It is recommended not to alter the contents of these folders. |
qualitia.properties file | The qualitia.properties file in the config folder contains all the configuration settings exist in Qualitia at the time of package creation. |
...
...
Understanding qualitia.properties
This section helps you understanding the elements stored in Qualitia.properties file. This file contains all the configurations required for offline package execution.
The default configuration values are taken from Qualitia Configuration existing at the time of creating offline package. You need to change some values that contain file paths and so forth before executing your test cases.
The following table illustrates the list of properties to be set before executing test cases using offline package.
Property Name | Description |
|---|---|
xmlPath | Enter the path where Suite.xml and Test Case xmls files are stored. |
LogPath | Enter the path where you want to store reports once the test cases are executed. |
SBrowserType | Enter the browser type to be used when executing test cases. For example; firefox, iexplore, googlechrome, and so forth. |
ShowReportAfterExec | Set true if you want Qualitia to show report once test cases are executed. Set false if you do not want Qualitia to show report after executing test cases. |
...
Offline Package - Execution
Once the offline package is created you can execute it opening the command prompt and navigating to the folder where you saved the Offline Package. After navigating to the designated folder, call the Qualitia-offline jar using java.
Refer Figure 2.2.21: execute the command; java -jar qualitiaoffline-xxx.jar.
This command executes tests available at the path mentioned in the qualitia.properties file.Note:
In case you have multiple versions of java, Qualitia uses the version set against the "JAVA_HOME" system variable under System Properties settings of your computer. Anchor
Configuration properties can be changed at three different levels to better manoeuvre maneuver configurations in multiple environments.
Command line arguments override User-defined properties which override qualitia.properties.
qualitia.properties - this file is auto generated based on the Qualitia Configuration at the time of creating offline package
User defined properties - user-defined properties file overrides the values in qualitia.properties to be used as first argument. For example: “java -jar qualitia-offline-xxxx.jar config/userdefined.properties”
Command line arguments - command line arguments in “java -jar qualitia-offline.xxxx.jar sBrowserType=firefox” overrides properties in User Defined properties and qualitia.properties.
*xxxx denotes the version of qualitia-offline jar. Kindly check the offline location for the exact jar file name.
Configuration properties can be changed at three different levels.
- Level 1: qualitia.properties - Qualitia generates this file based on Qualitia Configuration settings available at the time of creating offline package.
- Level 2: User Defined Properties File - You can create your own property file and provide the path as the first argument to the qualitiaqualitiaoffline-offline-xxxx.jar. It provides flexibility to create multiple property files based on the required configuration combinations.
You can create separate property files for each OS, browser, their combinations as per the project requirements. For example: win7.properties, mac.properties, linux.properties, linux-ff.properties, linux-headless.properties, so on. - Level 3: Command Line Arguments - Command line arguments allow further fine tuning of the configurations providing arguments to the qualitiaqualitiaoffline-offline-xxxx.jar. It overrides user defined properties if anything is provided as the first argument or the values set in the qualitia.properties file as well. You can also provide properties that are part of the quality.properties file as the command line arguments in the following format; name=value. For example: Property Name sBrowserType containing Property Value firefox can be provided as follows;
...
qualitiaoffline-
...
xxxx.jar
...
sBrowserType=firefox
Similarly you can provide multiple property=value pairs separating them with space as follows;
...
qualitiaoffline-xxxx.jar sBrowserType=firefox xmlPath=D:\QualitiaOffline\Scripts SyncTimeInSeconds=40