uipath-cli
latest
false
重要 :
请注意,此内容已使用机器翻译进行了本地化。
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath CLI 用户指南
uip tm report生成已完成测试执行的结构化摘要:计数、通过率、持续时间和每个失败的测试用例,以及解释失败的断言消息。当您需要人工可扫描的仪表板行或为 CI 脚本提供计算机可读判定时,请使用它。
大纲
uip tm report get --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--query <expr>]
uip tm report get --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--query <expr>]
获取 UIP TM 报告
获取已完成的测试执行的摘要。该命令:
- 获取执行的统计信息(
passed、failed、none、duration,时间)。 - 浏览失败的测试用例日志。
- 对于没有
info字符串的每个失败日志,获取其断言并连接失败日志的消息。 - 返回一个 JSON 信封,其中包含摘要以及以测试用例名称作为键控的
FailedTests列表。
每当成功生成摘要时,无论运行通过还是失败,命令都会退出0 。将“存在失败的测试”转换为非零 CI 退出是调用者的工作( .Data.Failed上的分支)。有关建议的三步管道,请参阅executions上的退出代码行为。
参数
无。
选项
--execution-id <uuid>(必填) — 执行汇总。从uip tm testsets run输出中获取。--project-key <key>— 拥有项目。此参数或--test-set-key为必填项。--test-set-key <key>— 测试集密钥(例如DEMO:42);项目键从前缀派生。--query <expr>— 已应用于Data有效负载的 jq 样式筛选器。设置后,将打印原始筛选值,而不是 JSON 信封。支持字段访问 (.Field) 和对象构造 ({key: .Field})。
示例
# simplest
uip tm report get --execution-id a1b2c3d4-0000-0000-0000-000000000001 --project-key DEMO
# scripting-friendly — pick a subset
uip tm report get \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--project-key DEMO \
--query '{total: .TotalTests, passed: .Passed, failed: .Failed}'
# simplest
uip tm report get --execution-id a1b2c3d4-0000-0000-0000-000000000001 --project-key DEMO
# scripting-friendly — pick a subset
uip tm report get \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--project-key DEMO \
--query '{total: .TotalTests, passed: .Passed, failed: .Failed}'
数据形状(默认输出):
{
"Code": "ReportGet",
"Data": {
"ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
"TestSetName": "Smoke Suite",
"TotalTests": 10,
"Passed": 8,
"Failed": 2,
"Skipped": 0,
"PassRate": "80%",
"Duration": "00:02:15",
"FailedTests": [
{ "TestCaseName": "Login flow", "Error": "Selector not found" },
{ "TestCaseName": "Logout flow", "Error": "Timeout" }
]
}
}
{
"Code": "ReportGet",
"Data": {
"ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
"TestSetName": "Smoke Suite",
"TotalTests": 10,
"Passed": 8,
"Failed": 2,
"Skipped": 0,
"PassRate": "80%",
"Duration": "00:02:15",
"FailedTests": [
{ "TestCaseName": "Login flow", "Error": "Selector not found" },
{ "TestCaseName": "Logout flow", "Error": "Timeout" }
]
}
}
字段:
TotalTests—Passed + Failed + Skipped。PassRate— 格式化为百分比字符串 ("80%")。Duration— 格式为HH:MM:SS。FailedTests[].Error— 测试用例日志的info字段(如果存在);否则为由;组成的失败断言消息的加入列表;否则为空字符串。StartTime/EndTime— 执行统计信息中的 ISO-8601 时间戳(存在于 JSON 中,但在上述示例中已省略)。
相关内容
- 运行测试集— 生成此处使用的
ExecutionId。 - wait — 在请求摘要之前,阻止直到执行处于终止状态。
- 结果— 与 JUnit XML 文件中的数据相同。
- 执行测试用例日志列表— 日志的完整枚举(不仅仅是失败)。
- testcaselogs list-assertions — 检查单个失败日志。
另请参阅
- Test Manager 概述
- 脚本编写模式
- 输出格式—
--output-filter和--query关联方式。