Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

The Qualitia Bot (erstwhile Qualitia Offline Package (QOP) is a portable and easily deployable deploy-able bundle containing Qualitia Tests and Qualitia test Execution Engine with ability to independently execute test cases and generate report results without Qualitia Test Automation Studio.

Qualitia Offline Package Bot = Qualitia Execution Engine + Tests Package

The offline package 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 Offline contains the Qualitia Execution Engine bot contains test execution engine to execute and report tests generate reports exactly as Qualitia Automation Studio does.

...

Qualitia Bot - Creation

The Qualitia Offline Package bot lets you independently execute test cases without Qualitia Test Automation Studio. Creating an offline package a bot is a two-step process.

Packaging Execution Engine
Anchor
1
1

The first step of creating an offline package a bot is to bundle Execution Engineexecution engine.

To package Execution Engine:

  1. Log on to Qualitia Automation Studio.
  2. On the File menu, click Offline Package.
    The Browse for Folder screen is displayedappears.
  3. Select path to save the offline packageQualitia bot.
    (warning) It is recommended to create new folder with the name Qualitia-offline to save Qualitia offline packagethe bot.
  4. Click OK.
    The QualitiaOffline.zip is created at the designated folder.
  5. Extract Qualitia Offline.zip.

Once the file is extracted successfully, execution engine is ready to use.

Creating Test

...

Packages 

Anchor
2
2

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.

...

  1. Log on to Qualitia Automation Studio.
  2. Click Execute.
    The Suite screen is displayedappears.
  3. In the left pane, click the suite to view the test cases available under suite.
  4. Mark the test cases which you want to add in the tests package to be created.
    (warning) Qualitia packages only marked test cases. If you want to package all tests available in suite, mark all test cases.
  5. Click the Save As XML button.
    The Browse for Folder screen is displayedappears.
  6. Select path to save the XML file.
  7. Click OK.

...

  • Suite.xml,
  • Map.xml, and
  • 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 execution engine which executes tests cases.

lib and common folders

Both these folders are required for Qualitia Execution Engineexecution 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 Qualitiaqualitia.properties file. This file contains all the configurations required for offline package the execution of Qualitia bot.

The default configuration values are taken from Qualitia Configuration existing 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.

...

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.By default, value is set as true for Qualitia Suite execution and false for Offline Package execution.


Multiexcerpt macro
nameOfflinePackageExecution

Offline Package Qualitia Bot - Execution

After you configure all the files, you can trigger the test cases case execution by opening the command prompt and navigating to the folder where you saved the offline packageQualitia bot. After navigating to the designated folder: execute the following command;

java -jar qualitiaoffline-xxx.jar
.

This command executes tests available at the path 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.

Configuration properties can be changed at three different levels to better maneuver configurations in multiple environments.

  • 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

...