Versions Compared

Key

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

...

...

...

...

...

...

...

...

...

...

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

...

To create an offline package:

  1. Open the QAS Client.

  2. Select the project for which you want to generate an offline package.

  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

...

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 (Image Modified).

  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(Image Modified). 

Info

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

...

To configure the settings for an offline suite:

  1. Open the extracted QualitiaOffline file.

  2. From the Configuration Manager folder, and double-

...

  1. click the Qualitia Offline Configuration Manager. 

  2. Do one of the following;

    1. Click Browse next to Select the Suite Directory, and then locate and

...

    1. select the offline suite.

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

  1. 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.

  2. 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.

  3. 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 

...

    1. /wiki/spaces/QAS8/pages/1381631256.

    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


Info
  • To execute a test suite on a mobile platform ensure that you have configured the system requirements and settings in the associated execution profile. For more information, refer to Requirements and Configuration Settings for Mobile Environments.

  • To execute the offline suite on remote or cloud platforms, then you must follow the appropriate environment guidelines. For more information, refer to 

...


Executing an Offline Suite using CLI Commands

...

To execute an offline package using CLI commands:

  1. Open the

...

  1. 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.

...

    1. jar SuitesDir="D:/OfflineSuite/Suite1"

    2. Environment Variable:

...

    1.  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,

...

    1.  java -jar qualitiaoffline-8.3.x.jar env.username=john.smith env.password=12345

    2. 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.

...

    1. 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.

...

    1. 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.

...

    1. jar androidChrome.chrome\.chromedriverVersion=83

  1. 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 /wiki/spaces/QAS8/pages/1401487380, 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 Portalto /wiki/spaces/QAS8/pages/1401487380.

Editing the Test Data for an Offline Suite

...

  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

...

Offline Suite Execution on a Shared Drive

Table of Contents

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

...

  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).

...

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.


Windows

Mac

Linux

Google Chrome

v60+

v59+

v59+

Firefox

v56+

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:

Open the Command
  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
  1. following code:
    java -jar qualitiaoffline-xxxx.jar googleChrome.chromeOptions.args=--headless

  2. If you want to execute on Firefox, enter the

following code
  1. following code:
    java -jar qualitiaoffline-xxxx.jar firefox.firefoxOptions.args=--headless.


Note

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.  

...