Document toolboxDocument toolbox

Header

(8.3.1) Work with Offline Package

An Offline Package contains the software components to execute an offline suite without using a Qualitia Automation Studio (QAS) Client. 

An offline suite is a copy of a test suite that you can save on a local machine. You can execute an offline suite on local, remote, shared drive, and cloud environments. An offline suite execution does not consume any Qualitia license.

Creating an Offline Package

You can create an Offline Package, which is a one-time activity, and use it to execute any number of offline suites.

To create an offline package:

  1. Open the QAS Client.

  2. Open any Qualitia project.
  3. From the Expand menu, click Qualitia BOT.

  4. Select a folder to save the Offline Package.

  5. Click Ok.
    A file called Qualitia Offline.zip is created in the selected location.

  6. Extract this Zip file. 

Creating an Offline Suite

The offline suite contains the associated test cases and test data, and a mapped execution profile that are used to execute it.

To create an offline suite:

  1. Open the QAS client.

  2. Select the project from which you want to create an offline suite.
  3. From the Expand menu, click Execute.
  4. In the left pane, select a test suite, and mark the test cases that you want to include in the offline suite, and click Save.

  5. Click the Save execution files button ().
  6. Select the required execution profile from the drop-down list.
    Note: For a desktop project, the System Execution Profile settings are used instead of the Execution Profile.

  7. Click the Save button(). 

You can export the execution profiles from a Qualitia Web/Mobile project. For more information, refer to Exporting an Execution Profile.

Configuring the Settings for an Offline Suite

The Offline Package contains a Qualitia Offline Configuration Manager. You can use it to modify the Qualitia Client Settings, Environment Variables, and Execution Profile settings for an offline suite.

Also, you can map an offline suite with an execution profile, which is used when the offline suite is executed. 

To configure the settings for an offline suite:

  1. Open the extracted QualitiaOffline file.

  2. From the Configuration Manager folder, and double-click the Qualitia Offline Configuration Manager. 

  3. Do one of the following;
    1. Click Browse next to Select the Suite Directory, and then locate and select the offline suite.

    2. Enter the location path of the offline suite folder, and press Tab.

  4. Under the Select the profile to edit, select an execution profile for the test suite.
    The Qualitia Offline Configuration Manager shows the offline suite name and the selected execution profile.
    Note: The offline suite executions that are created to automate testing on a desktop application uses the default execution profile only.
  5. From the Mapped Profile list, select an execution profile that you want to use.
    Note: The default mapped execution profile is the one that was saved while creating the offline suite.
  6. To edit the settings for the offline suite

    1. To change the Qualitia Client settings, click the Qualitia Client tab. For more information, refer to General Settings.

    2. To change the values of environment variables, click the Environment Variable tab
      Note:

      • You cannot add or edit environment keys.

      • You cannot add a value in the encrypted format and edit any value entered in the encrypted format.
        For more information, refer to Environment Variable.

    3. Perform this step only if Rest Generic Headers are used in the test cases.
      Do the following in the order listed:
      1. Click the Rest Generic Header tab.
      2. Change the header values.
      3. Click Ok to Save.
    4. To change the settings for the selected execution profile, click the Execution Profile tab.
      For more information, refer to

Executing an Offline Suite using CLI Commands

The offline package executes the offline suite that you want using its mapped execution profile. You can override any pre-configured settings of the mapped execution profile.

To execute an offline package using CLI commands:

  1. Open the Command Prompt.

  2. Navigate to the location where you have saved the offline package.

  3. Enter the following code:
    java -jar qualitiaoffline-8.3.x.jar

    The offline package is executed using the settings defined in the Qualitia Offline Configuration Manager.
  4. To override any of the following parameters:
    1. Mapped Execution Profile: Enter the location of the execution profile you want in the following ways:
      1. The location of the execution profile must be enclosed by double inverted commas.
      2. You do not need to add any key.
      3. It must be the first argument.
        For example: java -jar qualitiaoffline-8.3.x.jar "D:/ABCsettings.JSON"

    2. Offline Suite: Enter the location of the offline suite as SuitesDir="Suite_Path".
      For example, java -jar qualitiaoffline-8.3.x.jar SuitesDir="D:/OfflineSuite/Suite1"
    3. Environment Variable: Enter the environment variables and their associated values in the following format:

      java -jar qualitiaoffline-8.3.x.jar env.var1=value1 env.var2=value2

      var1 and var2 denote the environment variables, and value1 and value2 denote the associated values.

      For example, java -jar qualitiaoffline-8.3.x.jar env.username=john.smith env.password=12345

    4. Other Parameters defined in the Selected Execution Profile: Enter the parameters preceded by their hierarchy in name=value format as command-line arguments.

      For example, to use a specific version of Google Chrome, enter the command line argument as follows:

      java -jar qualitiaoffline-8.3.x.jar googleChrome.version=81.0.1.36
      In this example, googleChrome is the topmost parameter and then version.

      You can provide multiple property=value pairs separating them with space, as shown in the following example:
      java -jar qualitiaoffline-8.3.x.jar googleChrome.version=81.0.1.36 PageTimeoutInSeconds=10

      If you are overriding the mapped execution profile enter it as the first argument, as shown in the following example:

      java -jar qualitiaoffline-8.3.x.jar "D:/ABCsettings.JSON" googleChrome.version=81.0.1.36 PageTimeoutInSeconds=10

      If a key has a dot in its name, you need to put backslash before the dot such as chrome.chromedriverVersion, which is under androidChrome, as shown in the following example:
      java -jar qualitiaoffline-8.3.x.jar androidChrome.chrome\.chromedriverVersion=83
  5. Press Enter to start the offline suite execution.

Viewing an Offline Suite Execution Report

You can view the test suite execution report in the Real Time Reporting Portal, which updates the execution results after every test case iteration is completed.

Every offline suite execution creates a test suite execution summary report as per the location defined in Execution Result Path on the General Settings tab of the Qualitia Offline Configuration Manager. It updates the results into this folder after every task iteration execution is completed.

You can import the locally created test suite execution summary report in the Real Time Reporting Portal if the:

  • Qualitia Server URL is not configured in the offline suite.

  • Connection to Qualitia Server fails during offline suite execution.

For instructions on how to upload a suite execution report, refer to Uploading a Report into Real Time Reporting Portal.

Editing the Test Data for an Offline Suite


You can edit test data for an offline suite either using Qualitia client or test data excel file present in Offline Suite Folder.

Qualitia recommends using the Qualitia Client because it displays an error message when any change in test data is incorrect.

Editing the Test Data using Qualitia Client

To edit the test data using Qualitia Client:

  1. Open the test case from Qualitia Client. For instructions on how to open a test case from Qualitia Client, refer to Editing a Test Case.

  2. Open the Test Data explorer to edit test data. For instructions on how to edit test data, Adding Test Data for a Test Case .

  3. Re-create the offline suite. For instructions on how to create an offline suite, refer to Offline Package .

Editing Test Data in Test Data File of Offline Suite

You can edit in the offline suite if you do not have access to Qualitia Client.

After the offline suite is created, for every test case that contains test data, the associated test data as excel files are created in the same folder with the same names as given to their associated test cases. You can modify the test data such as replace the existing test data and enable or disable TC iterations.

Points to Know

  • Do not add or remove any columns or change the column order.

  • Enter as $NULL$ in the associated cell where you do not want to add a value for a parameter in a TC or task iteration.

  • If you do not want a task or TC iteration, delete the respective row.

To edit the test data for an offline suite:

  1. Open offline suite folder.

  2. Take a backup of the original test data excel file that you want to edit.

  3. Open the Test Data excel file.

  4. ​In the excel sheet, the following values are displayed in the second row.

    1. TC Iteration: Shows the number for every TC Iteration. There must be at least one TC Iteration for executing the test case.

    2. Selection: Shows as True or False for the enabled or disabled iterations. You can modify the values. This is applicable for TC iterations only.

    3. DataSetTag: Optionally, enter a label for identifying the dataset in the test case execution report. You can modify the values.

  5. From the third row, edit the values in their formats. The first row displays the different tasks highlighted in the grey color. Each task covers its parameters in the second row.

  6. If you want to add a TC iteration, insert a row specifying values for TC Iteration number, Selection and DataSetTag (Optional), then enter the values for the associated parameters.

  7. If you want to add a task iteration, insert a row without specifying values for TC Iteration number, Selection, and DataSetTag (Optional), then enter the values for the associated parameters.

  8. Ensure to save the excel file.


Offline Suite Execution on a Shared Drive

Offline Suite Execution for Web and Mobile Applications on a Shared Drive

You can execute an offline suite present in a shared drive for web and mobile applications in one of the following ways:

  • By mapping the shared drive to the local computer

  • Without mapping the shared drive to the local computer

Executing a Shared Offline Suite by Mapping the Shared Drive to the Local Computer

Qualitia recommends mapping of the shared drive with the local computer for an offline suite execution.

Perform the following steps:

  1. Copy the offline package along with the offline suite to the shared drive with the read and write access.

  2. Map the shared drive to the local computer.

  3. Configure the offline suite as per your requirements. For detailed instructions, refer to Configuring the Settings for an Offline Suite.

  4. Do one of the following: 

    1. Open the Command Prompt, navigate to the mapped drive location that contains the offline package and suite, and then execute the offline package using the command line.
      For detailed instructions, refer to Executing an Offline Package using CLI Commands.

    2. Open the mapped drive and double-click the offline package (8.3.x jar).

Executing a Shared Offline Suite Without Mapping the Shared Drive to the Local Computer

To execute a shared drive without mapping the shared drive to the local computer:

  1. Copy the offline package along with the offline suite to the shared drive with read and write access.

  2. Open the shared location and double-click the offline package (8.3.x jar).
    Note: You cannot execute an offline suite using the command prompt by specifying the complete UNC (Shared location).

Offline Suite Execution for Desktop Applications on a Shared Drive

You can execute an offline suite present in a shared drive for desktop applications.

Before you execute an offline suite for a desktop application, ensure that you have:

  1. Installed UFT on the same computer from where you will execute the offline suite

  2. Mapped the shared drive to the local computer

  3. Copied the offline package to the shared drive with read and write access

  4. Copied the TSR file in the local or shared drive and ensure that you have access to it

To execute offline suite for desktop applications on a shared drive:

  1. Configure the offline suite as per the requirements. For detailed instructions, refer to Configuring the System Execution Profile Settings for a Desktop Project.

  2. Do one of the following: 

    • Open the command prompt, navigate to the mapped drive location that contains the offline package and offline suite, and then execute the offline suite using the command line.
      For detailed instructions, refer to Configuring the Qualitia Client Settings .

    • Navigate to the mapped drive location that contains the offline package and the offline suite, and double-click the offline package (8.3.x jar).


Execution using Continuous Integration Tools


Qualitia supports integration with Continuous integration tools like Jenkins, TeamCity, and Bamboo. It enables developers to find and solve defects in a code base rapidly and to automate testing of their builds.

When you want to execute your test cases using CI tools, you must set the CI_Tool property in the mapped execution profile.

If your test case is for mobile applications, Appium Server is internally hosted on Qualitia client. However, still you can use a custom Appium server if you want to test on another Appium version. 

Related topics


Headless Executions


Headless executions are the test case executions in which browser is not displayed. Typically, headless executions are faster as compared with general executions. QAS supports Google Chrome and Mozilla Firefox browsers to execute test cases in headless mode.

Qualitia supports headless test case execution on following browsers and operating systems.


WindowsMacLinux
Google Chromev60+v59+v59+
Firefoxv56+v56+v55+


The following table shows how to execute test suite in headless mode by doing manual settings or through CLI for an offline package execution.

Method

Steps

Using Qualitia Client or OfflineConfigManager Utility

for Offline Packages

Do in the following order listed:

  1. Open the associated execution for a test suite.
  2. From the Browser list, select Chrome or Firefox
  3. Select the Desired Capabilities checkbox.
  4. If you have selected Chrome, select the chromeOptions checkbox, select the args checkbox, and enter --headless in the associated field.
  5. If you have selected Firefox, select the firefoxOptions checkbox, select the args checkbox, and enter --headless in the associated field.
  6. Click Ok.
Using CLI Command

Do in the following order listed:

  1. Open the Command Prompt.

  2. Navigate to the location where you have saved the offline package.

  3. If you want to execute on Chrome, enter the following code:
    java -jar qualitiaoffline-xxxx.jar googleChrome.chromeOptions.args=--headless
  4. If you want to execute on Firefox, enter the following code:
    java -jar qualitiaoffline-xxxx.jar firefox.firefoxOptions.args=--headless.

Execution using X Virtual Frame Buffer (Xvfb) on Linux is no longer supported. You can execute test cases on headless mode on Linux using any of these methods mentioned above.  



Footer