Running Web UI tests from the command-line
You can run a Web UI test without using the desktop client by using the command-line interface. You must use the -varfile parameter that specifies the complete path to the XML file in the command. The XML file contains the name-value pairs of the variables. The variables file specifies the web browser on a computer, device, emulator, or device on a cloud on which to run the test.
Running the command
Before you can run the command to run Web UI tests from the command line, you must create a variable file that contains the details of the computer, device, emulator, or device on a cloud on which you want to specify the web browser to run the test. You must have also recorded the Web UI test.
You can issue the following command to run a Web UI test from the command-line:
cmdline -workspace <workspace_full_path> -project <proj_rel_path> -eclipsehome <eclipse_full_path> -plugins <plugin_full_path> -suite <suite_rel_path> -importzip <file_name.zip> -varfile <variable_file_full_path> -configfile <file_full_path> -results <result_file> -overwrite <{"true" | "false"}> -quiet -vmargs <JVM_args> -publish <serverURL#project.name=projectName -publish_for {ALL,PASS,FAIL,ERROR, INCONCLUSIVE}> -exportlog <log_full_path> -exportstats <local_dir_path> -exportstatshtml <local_dir_path> -compare <"result_path1, result_path2"> -exportstatreportlist <stats_list> -execsummary <local_dir_path> -execsummaryreport <reportID> -usercomments <"any user comment"> -publishreports <"FT, FUNCTIONAL, STATS, TESTLOG"> -stdout -swapdatsets <existing_dataset_file_path:new_dataset_file-path>
- Use the variable file that contains the details of the computer, device, emulator, or device on a cloud on which you want to select the web browser.
- Specify the details of the variable file in the command.
Creating a variable file
Variable file for a computer on which you have installed Rational® Functional Tester
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<browser>" name="RTW_WebUI_Browser_Selection"/>
</inits>
<?xml version="1.0" encoding="UTF-8"?><inits>
<variable_init value="Chrome(Emulator:Pixel_2_API_28)" name="RTW_WebUI_Browser_Selection"/>
</inits>
Variable file for remote agent
Create an XML file as a variable file that specifies the browser to use on a device or an emulator connected to the remote computer. The format of the variable file is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<browser(device or emulator name)>" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="<UI Test Agent host URL>" name="appium.server.host"/>
<variable_init value="<port number>" name="appium.server.port"/>
</inits>
The following table lists the variables and the actions required for the value field:
Name of the variable | Value |
---|---|
RTW_WebUI_Browser_Selection | Specify the browser to be used on the device or emulator that is connected to the UI Test Agent on the remote computer. |
appium.server.host | Specify the host name or IP address of the remote computer
that contains the UI Test Agent. Note: The default value for this
variable is 127.0.0.1. If no value is specified, the default
value is used during the playback. |
appium.server.port | Specify the port number of the UI Test Agent that is installed on the remote computer. |
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="Chrome(Emulator:Pixel_API_28)" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="10.115.50.61" name="appium.server.host"/>
<variable_init value="7082" name="appium.server.port"/>
</inits>
Variable file for BitBar Cloud
Create an XML file as a variable file that specifies the browser to be used on the device on the BitBar cloud. The format of the variable file is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<Browser(BitBar device name)>" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="<BitBar API key>" name="bitbar.apikey"/>
<variable_init value="<BitBar host URL>" name="bitbar.host"/>
<variable_init value="<project name>" name="bitbar.project"/>
<variable_init value="<test name>" name="bitbar.testrun"/>
</inits>
Name of the Variable | Value |
---|---|
RTW_WebUI_Browser_Selection | Specify the browser to be used on the mobile device that is connected to the BitBar cloud. |
bitbar.apikey | Specify the user token generated for your BitBar account to authenticate your connection with the BitBar Cloud. |
bitbar.host | Specify the host name of the BitBar cloud instance. |
bitbar.project | Specify the name of the project that contains the recorded test. |
bitbar.testrun | Specify a name for the test run that must be displayed in the BitBar dashboard for the test run. |
Name of the Variable | Value |
---|---|
RTW_WebUI_Browser_Selection | Chrome(Bitbar:Google Pixel 2) |
bitbar.apikey | LkBldnjcnzrIcwWZpCZZxy |
bitbar.host | appium.bitbar.com |
bitbar.project | PlaybackWebUI |
bitbar.testrun | CLIExecution |
The example variable file for the values in the table is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="Chrome(Bitbar:Google Pixel 2)" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="LkBldnjcnzrIcwWZpCZZxy" name="bitbar.apikey"/>
<variable_init value="appium.bitbar.com" name="bitbar.host"/>
<variable_init value="PlaybackWebUI" name="bitbar.project"/>
<variable_init value="CLIExecution" name="bitbar.testrun"/>
</inits>
Variable file for Perfecto Mobile cloud
Create an XML file as a variable file that specifies the browser to be used on the device on the Perfecto Mobile cloud. The format of the variable file is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="<browser(device name)>" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="<security token>" name="perfecto.securitytoken"/>
<variable_init value="<perfecto host URL>" name="perfecto.host"/>
</inits>
Name of the Variable | Value |
---|---|
RTW_WebUI_Browser_Selection | Specify the browser to be used on the mobile device that is connected to the Perfecto mobile cloud. |
perfecto.securitytoken | Specify the user token generated for your Perfecto account to authenticate your connection with the Perfecto Mobile cloud. |
perfecto.host | Specify the URL of the Perfecto mobile device cloud. |
Name of the Variable | Value |
---|---|
RTW_WebUI_Browser_Selection | Chrome(Perfecto:R48904TNSAZ) |
perfecto.securitytoken | LkBldnjcnzrIcwWZpCZZxy |
perfecto.host | partners.perfectomobile.com |
The example variable file for the values in the table is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<inits>
<variable_init value="Chrome(Perfecto:R48904TNSAZ)" name="RTW_WebUI_Browser_Selection"/>
<variable_init value="LkBldnjcnzrIcwWZpCZZxy" name="perfecto.securitytoken"/>
<variable_init value="partners.perfectomobile.com" name="perfecto.host"/>
</inits>