使用命令行并行运行测试

在命令行中，使用以下语法运行每个 Web 测试:

ParallelRunner 请参阅 "-t" <测试路径> 请参阅 "-b" <浏览器> 请参阅 "-r" <结果路径>

例如:

ParallelRunner -t "C:\GUIWebTest_Demo" -b "Chrome;IE;Firefox" -r "C:\parallelexecution"

如果指定多个浏览器，则测试将运行多次，即在每个浏览器上运行一次。

在命令行中，使用以下语法运行每个移动测试:

ParallelRunner 请参阅 "-t" <测试路径> 请参阅 "-d" <设备详细信息> 请参阅 "-r" <结果路径>

例如:

如果指定多个设备，则测试将运行多次，即在每个设备上运行一次。

等待可用的设备

您可以指示 ParallelRunner 等待合适的设备变得可用，而不是在没有可用设备时立即将测试运行设为失败。为此，请将 -we 选项添加到 ParallelRunner 命令中。

在命令行中，使用以下语法运行每个 API 测试:

ParallelRunner 请参阅 "-t" <测试路径> 请参阅 "-r" <结果路径>

例如:

ParallelRunner -t "C:\APITest" -r "C:\API_TestResults"

-t

--test

字符串。必填项。定义包含要运行的测试的文件夹路径。

如果路径中包含空格，则必须用双引号 ("") 将路径引起来。例如: -t ".\GUITest Demo"

不支持在同一路径中存在多个测试。

-b

--browsers

字符串。可选。支持 Web 测试。

使用分号 (;) 定义多个浏览器。ParallelRunner 会多次运行测试，以在所有指定浏览器上进行测试。

受支持的值包括:

Chrome、Chrome_Headless、ChromiumEdge、Edge、Firefox、Firefox64、IE、IE64、Safari

注意:

• 此值将覆盖在“录制和运行设置”中定义的所有设置，以及在测试中配置的所有浏览器参数化。WebUtil.LaunchBrowser 方法不受影响。

• 我们建议对浏览器名称使用一致的大小写，以免相同浏览器类型的 Chromium 运行结果报告中出现单独的列。有关更多详细信息，请参阅请参阅 "示例 ParallelRunner 响应和运行结果"。

• 支持通过在远程 Mac 计算机上进行测试来使用 Safari。有关更多详细信息，请参阅请参阅 "连接到远程 Mac 计算机"。

• ChromiumEdge 值仅支持向后兼容。请改用 Edge。两者都指 Microsoft Edge。

-d

--devices

字符串。可选。支持移动测试。

使用分号 (;) 定义多个设备。ParallelRunner 会多次运行测试，以在所有指定设备上进行测试。

使用此字符串中的以下属性，定义使用特定设备 ID 的设备，或按功能查找设备:

• deviceID。为 OpenText Functional Testing Lab 中的特定设备定义设备 ID。此属性不能与其他设备功能属性结合使用。

• manufacturer。定义设备制造商。

• model。定义设备型号。

• osType。定义设备操作系统。

  以下之一: Android、iOS 和 Windows Phone。

  如果未定义此值，将使用测试的“录制和运行设置”中定义的 osType 作为默认值。

• osVersion。定义设备操作系统版本。以下之一:

  • Any。将版本号保留为未定义状态。

  • 特定版本。例如: 10.0

  • 布尔运算符和版本值。例如: >10.0、<10.0、>=10.0 或 <=10.0

注: 请勿在此字符串中的逗号、冒号或分号周围额外添加空格。我们建议始终用双引号 ("") 将字符串引起来，以支持任何特殊字符。

例如:

–d "manufacturer:apple,osType:iOS,osVersion:>=11.0"

-dt

--dataTables

字符串。可选。支持 Web 和移动测试。

定义要用于此测试的数据表的路径。将使用您提供的表，而非随测试一起保存的数据表。

使用分号 (;) 定义多个数据表。ParallelRunner 会多次运行测试，以使用所有指定的数据表进行测试。

如果路径中包含空格，则必须用双引号 ("") 将路径引起来。

例如: -dt ".\Data Tables\Datatable1.xlsx;.\Data Tables\Datatable2.xlsx"。

--output

字符串。可选。确定测试运行期间和之后在控制台中显示的结果输出。

受支持的值包括:

• Normal。(默认) 运行输出会在控制台中自动更新。

  例如，运行状态会从“待定”更改为“正在运行”，然后更改为“通过”或“失败”。

• Static。在测试运行开始时显示报告路径，然后在测试完成时会显示运行状态。

• Disable。输出根本不会显示在控制台中。

-r

--reportPath

字符串。可选。定义要用于保存测试运行结果的路径。默认情况下，运行结果保存在 %Temp%\TempResults 中。

如果字符串中包含空格，则必须用双引号 ("") 将字符串引起来。例如: - r "%Temp%\Temp Results"

--report-auto-launch

可选。包含在命令中，以在测试运行开始时自动打开运行结果。使用 请参阅 "-rr--report-auto-refresh" 选项确定测试运行的刷新频率。

有关更多详细信息，请参阅请参阅 "示例 ParallelRunner 响应和运行结果"。

--reportName

字符串。可选。定义报告名称，当您打开并行运行的摘要报告时，该名称将显示在浏览器选项卡中。默认情况下，该名称为 Parallel Report。

自定义此名称，以帮助在同时打开多个报告时区分不同的运行。为此，还会为每个报告名称添加时间戳。

如果字符串中包含空格，则必须用双引号 ("") 将字符串引起来。例如: - rn "My Report Title"

--report-auto-refresh

可选。确定已打开的运行结果文件自动刷新的频率，以秒为单位。

例如: -rr 5

如果未提供整数，则使用默认值: 5 秒

-tp

字符串。可选。支持 Web 和移动测试。

定义用于测试参数的值。提供参数名称-值对的逗号分隔列表。

对于未指定的测试参数，将使用在测试自身中定义的默认值。

例如: -tp "param1:value1,param2:value2"

使用分号 (;) 定义多个测试参数集。ParallelRunner 会多次运行测试，以使用所有指定的测试参数集进行测试。

例如: -tp "param1:value1, param2:value2; param1:value3, param2:value4"

如果参数值包含逗号 (,)、分号 (;) 或冒号 (:)，请使用后跟双引号的反斜杠 (\") 将值引起来。

例如，如果 TimeParam 的值为 10:00;00，则使用:

-tp "TimeParam:\"10:00;00\""

注: 不能在使用命令行选项的参数值内包含双引号 (")。对于 ParallelRunner 命令，请改为使用 JSON 配置文件。

--wait-for-environment

可选。支持移动测试。

包含在命令中，以指示每个移动测试运行等待合适的设备变得可用，而不是在没有可用设备时立即设为失败。

字符串。定义要用于保存测试运行结果的路径。

默认情况下，运行结果保存在 %Temp%\TempResults 中。

字符串。定义报告名称，当您打开并行运行的摘要报告时，该名称将显示在浏览器选项卡中。默认情况下，报告名称与 .json 文件名相同。

自定义此名称，以帮助在同时打开多个报告时区分不同的运行。为此，还会为每个报告名称添加时间戳。

字符串。定义包含要运行的测试的文件夹路径。

字符串。定义要附加到运行结果文件名末尾的后缀。例如，您可能想要添加指示测试运行环境的后缀。

示例："reportSuffix":"Samsung6_Chrome"

默认值: "[N]"。此值指示当前结果实例的索引号 (如果同一并行运行中的同一测试存在多个结果)。

注: 

• 运行结果文件名由“<测试名称>_<reportSuffix>”组成且必须唯一。因此，请勿为同一测试的多个运行提供相同后缀。
• 确定后缀时请记住，如果生成的文件名超过 22 个字符，则文件名将在 ParallelRunner 于命令窗口中提供的输出中被截断。

字符串。定义在运行 Web 测试时要使用的浏览器。

受支持的值包括:

Chrome、Chrome Headless、ChromiumEdge、Edge、IE、IE64、Firefox、Firefox64、Safari

注意:

• 此值将覆盖在“录制和运行设置”中定义的所有设置，以及在测试中配置的所有浏览器参数化。WebUtil.LaunchBrowser 方法不受影响。
• 我们建议对浏览器名称使用一致的大小写，以免相同浏览器类型的运行结果报告中出现单独的列。有关更多详细信息，请参阅请参阅 "示例 ParallelRunner 响应和运行结果"。
• 支持通过在远程 Mac 计算机上进行测试来使用 Safari。有关更多详细信息，请参阅请参阅 "连接到远程 Mac 计算机"。

• ChromiumEdge 值仅支持向后兼容。请改用 Edge。两者都指 Microsoft Edge。

字符串。为 OpenText Functional Testing Lab 中的特定设备定义设备 ID。

注: 如果同时提供了 deviceID 和设备功能属性，则将忽略设备功能属性。

字符串。定义设备制造商。

字符串。定义设备型号。

字符串。定义设备操作系统版本。

以下之一:

• Any。将版本号保留为未定义状态。

• 特定版本。例如 10.0

• 布尔运算符和版本值。例如: >10.0、<10.0、>=10.0 或 <=10。

定义设备操作系统。

以下之一:

• Android
• iOS
• Windows Phone

dataTable

字符串。支持 GUI Web、移动和 Java 测试。

定义要用于此测试运行的数据表的路径。将使用您提供的表，而非随测试一起保存的数据表。

将 dataTable 定义置于描述相关测试运行的部分中。

字符串。支持 GUI Web、移动和 Java 测试。

定义要用于此测试运行中的测试参数的值。提供参数名称-值对的逗号分隔列表。

例如: 

"testParameter":{
      "para1":"val1",
      "para2":"val2"
    }

将 testParameter 定义置于描述相关测试运行的部分中。

如果参数值包含反斜杠 (\) 或双引号 (")，则在相应字符前面添加反斜杠。例如: "para1":"val\"1" 会将值 val"1 分配给参数 para1。

对于未指定的测试参数，将使用在测试自身中定义的默认值。

将此选项设置为 true，以指示每个移动测试运行等待合适的设备变得可用，而不是在没有可用设备时立即设为失败。

OpenText Functional Testing Lab 服务器的 IP 地址和端口号。

默认端口: 8080

连接到 OpenText Functional Testing Lab 时要使用的身份验证模式。

可用值:

• 1: 访问密钥身份验证。使用您从 OpenText Functional Testing Lab 收到的访问密钥进行身份验证。

• 0: 基本身份验证。使用用户名和密码进行身份验证。

ClientId / SecretKey / TenantId

从 OpenText Functional Testing Lab 收到的访问密钥。

包含用于控制此测试的运行的所有 wait 条件的主要元素。

可能包含 wait 选项或嵌套 conditions 元素。

包含由一个或多个简单条件或其他组合条件组成的数组的元素。

conditions 元素可以包含在组合条件中。

指示是否必须满足运算符后面的 conditions 元素中的所有条件。

可能值: 

• AND。必须满足运算符后面的所有条件，测试运行才会开始。
• OR。只要满足运算符后面的条件之一，测试运行就会开始。

指示 ParallelRunner 在等待指定的秒数之后开始此测试运行。

指示 ParallelRunner 在指定的运行结束后执行此测试运行。通过使用运行的 testRunName 来指定要等待的运行。

可以将 waitForTestRun 选项与其他选项结合使用:

• 使用 waitSeconds 在指定的运行结束后等待数秒。
• 使用 waitForRunStatuses 等至指定的测试达到特定状态。

例如: 以下条件指示 ParallelRunner 在测试运行 3 达到指定状态之一后 10 秒执行测试运行 1。

"testRunName": "1",
    "condition":{
        "waitForTestRun": "3",
        "waitSeconds": 10,
        "waitForRunStatuses": ["passed", "failed", "warning", "canceled"]
}

注: 组合多个 wait 选项时，隐含的运算为 AND。

指示 ParallelRunner 在指定运行达到特定状态后执行此测试运行。

• 通过使用运行的 testRunName 来指定要等待的运行。

• 提供要等待的一个或多个测试状态的字符串。在指定测试达到指定状态之一后，即表示满足条件。

  例如: "waitForRunStatuses": ["passed", "failed", "warning", "canceled"]