The Qualitia Bot (erstwhile Qualitia Offline Package) is a portable and easily deploy-able bundle containing Qualitia Tests and Qualitia test Execution Engine with ability to independently execute test cases and generate report results without Qualitia Automation Studio.
Qualitia Bot = Qualitia Execution Engine + Tests Package
The bot is created from the Qualitia Automation Studio and then executed in multiple environments.
These environments DO NOT need Qualitia Automation Studio to be installed as Qualitia bot contains test execution engine to execute and generate reports exactly as Qualitia Automation Studio does.
Qualitia Bot - Creation
The Qualitia bot lets you independently execute test cases without Qualitia Automation Studio. Creating a bot is a two-step process.
Packaging Execution Engine
The first step of creating a bot is to bundle execution engine.
To package Execution Engine:
- Log on to Qualitia Automation Studio.
- On the File menu, click Offline Package.
The Browse for Folder screen appears. - Select path to save the Qualitia bot.
It is recommended to create new folder with the name Qualitia-offline to save the bot. - Click OK.
The QualitiaOffline.zip is created at the designated folder. - Extract Qualitia Offline.zip.
Once the file is extracted successfully, execution engine is ready to use.
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 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 Automation Studio.
- Click Execute.
The Suite screen appears. - 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 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 appears. - Select path to save the XML file.
- Click OK.
Once the package is saved successfully, you can locate following items at the given path:
- Suite.xml,
- Map.xml
- Test Case xmls (each for one test case.)
Qualitia Bot - 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 related 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 the execution of Qualitia bot.
The default configuration values are taken from the configuration settings set 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. |
Qualitia Bot - Execution
After you configure all the files, you can trigger the test case execution by opening the command prompt and navigating to the folder where you saved the Qualitia bot. After navigating to the designated folder: execute the following command;
java -jar qualitiaoffline-xxx.jar
This command executes tests available at the xmlPath mentioned in the qualitia.properties file.
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.
- 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 qualitiaoffline-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 qualitiaoffline-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
