This remote agent links Qualitia with ALM and allows you to import Qualitia tests cases into ALM, arrange them into test sets, run them, and store the results. Using this agent, engineering and test teams that use ALM can implement the seamless integration of Qualitia test cases into tests managed by ALM.
To install Qualitia-ALM Remote Agent:
- Navigate to the folder where you have kept Qualitia Installables.
- Copy the the QCRemoteAgent to the machine where you want to install it.
- Double-click Setup.exe.
- Installation wizard appears and completes the installation process.
You have to add General, Dependency, Execution, and Platform related settings for the remote agent. - On your Desktop, double-click Qualitia Remote Agent.
- Fill up the details in General, Dependency, Execution, and Platform sections as described below.
General
From this section, you can provide Project, Database, and License Server related settings.
| Project Name | Enter the name of the Qualitia project which you want to integrate to ALM. |
|---|---|
| Database Server | |
| Type | Select the database server from the drop-down list: SQL Server and MySQL. |
| Authentication Type | Select the authentication type: Windows Authentication or SQL Server Authentication This field is applicable for SQL server only. |
| Server: Port | Enter the Server and the Port IDs. Default port is 3306 for MySQL and 1433 for SQL. |
| User Name | Enter database server user name. |
| Password | Enter database server password. |
| SVN Server | |
| SVN Client | Select the version of SVN Client you are using. |
| User Name | Enter the SVN Server user name. |
| Password | Enter the SVN Server password. |
| License Server Host/IP Address | |
| Host/IP Address | Enter the IP address or the host name of the server where you have installed License Service. By default, License service is deployed with the installation of Qualitia Server. |
Dependency
From this section, you add paths to all the dependencies such as project path, report path and so forth.
Dependency | |
|---|---|
| Project Path | Select the folder where your project is saved on the local machine. |
Report Path | Select the folder where you want to save all your execution reports. |
Log Path | Select the folder where you want to save logs. |
| XML Path | Enter the path where you want to save the execution XMLs. |
| Custom Action Repository Path | Select the folder where your Custom Action Repository exists. Multiple paths should be separated with semi-colon (;) and the last path should be ended by semi colon (;). |
AutoIT Install Path | Select the folder where have installed AutoIT. For more information about this, click here. |
Java 8 Install Path | Select the absolute path where you have installed Java 8 (java.exe). |
Execution
From this section, you can provide execution related settings.
Execution | |
|---|---|
| Screen Capture Mode | Select the screen capture mode: Desktop or Browser. Default is Browser. |
CI Tool | Select the desired CI Tool. |
Build Number | Enter the build number of the application under test. |
| Release Number | Enter the release number of the application under test. |
| Tool Name | Select the tool name you want to use while executing test cases. Default is Webdriver. |
Report Logs | Select appropriate options for which you want to save logs when executing test cases. |
Capture Screenshots On | Select options for which you want to capture screenshots while executing test cases. You can select multiple options. |
Configuring Platform Settings
The Platform section under Configuration Settings window allows configuring settings related to test case execution platform.
| Desktop Web | |
|---|---|
| Browser Type | Select the browser which you want to use for test case execution from the drop-down list. |
Browser Driver Path | Select the browser driver path based on the browser selected above |
Browser Profile Path | Select the browser profile path if you want to execute test with specific browser profile. |
| Mobile | |
Server: Port | Enter Appium server and port details. Default is 127.0.0.1: 4723. |
Platform | Select platform for test case execution: Android or iOS. |
UDID | For Android: Enter the device ID. For iOS: Enter device identifier on which you want to execute test cases. For more information about this, please refer to the How to Identify UDID in Frequently Asked Questions (FAQs). |
Mobile Browser | Select the mobile browser on which you want to execute test cases. |
Execute on Mobile Web | Select this option if you want to execute test on the mobile device. |
| Native Object Sync Time | Enter the number of seconds for which Appium will wait for a native object to appear. Default is 2. |
For iOS Devices:
- Qualitia users can keep this field empty and specify the Device Name + Platform Version in iosdc.properties file.
(Located at: %LocalAppData%\QualitiaWDClient\app-<version\WebDriver\config) - Device name is mandatory.
- If Platform version is not specified, Appium considers the latest platform version (for example, 10.3) and creates new simulator each time to perform test case execution.
For Android:
- If UDID is not specified, test cases will be executed on the last connected device.
- Entering incorrect UDID results in failing the test case execution.
