- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Using UiPath CLI
- Guides pratiques
- CI/CD recipes
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Global options
- uip codedagent
- uip docsai
- add-test-data-entity
- add-test-data-queue
- add-test-data-variation
- analyze
- build
- créer-projet
- diff
- find-activities
- get-analyzer-rules
- get-default-activity-xaml
- get-errors
- get-manual-test-cases
- get-manual-test-steps
- get-versions
- get-workflow-example
- indicate-application
- indicate-element
- inspect-package
- install-data-fabric-entities
- install-or-update-packages
- list-data-fabric-entities
- list-workflow-examples
- pack
- restore
- run-file
- search-templates
- start-studio
- stop-execution
- uia
- uip traces
- Migration
- Reference & support
UiPath CLI user guide
uip tm report produces a structured summary of a completed test execution: counts, pass rate, duration, and every failed test case with the assertion message that explains the failure. Use it when you want a human-scannable dashboard line, or a machine-readable verdict for a CI script.
Synopsis
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>]
All verbs honor the global options and the standard exit codes. Every verb accepts -t, --tenant <name> and --log-level <level> (default Information).
uip tm report get
Get a summary for a completed test execution. The command:
- Fetches the execution's stats (
passed,failed,none,duration, timing). - Pages through the failed test case logs.
- For each failed log without an
infostring, fetches its assertions and concatenates the messages of the failed ones. - Returns one JSON envelope with the summary plus a
FailedTestslist keyed by test case name.
The command exits 0 whenever it successfully produces the summary, whether the run passed or failed. Turning "failed tests present" into a non-zero CI exit is the caller's job (branch on .Data.Failed). See Exit-code behavior on execution for the recommended three-step pipeline.
Arguments: none.
Options:
--execution-id <uuid>(required) — execution to summarize. Get this fromuip tm testset executeoutput.--project-key <key>— owning project. Either this or--test-set-keyis required.--test-set-key <key>— test set key (e.g.DEMO:42); the project key is derived from the prefix.--query <expr>— jq-style filter applied to theDatapayload. When set, prints the raw filtered value instead of the JSON envelope. Supports field access (.Field) and object construction ({key: .Field}).
Exemples :
# 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}'
Data shape (default output):
{
"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" }
]
}
}
Champs :
TotalTests—Passed + Failed + Skipped.PassRate— formatted as a percentage string ("80%").Duration— formattedHH:MM:SS.FailedTests[].Error— the test case log'sinfofield if present; otherwise a;-joined list of failed assertion messages; otherwise an empty string.StartTime/EndTime— ISO-8601 timestamps from the execution stats (present in the JSON but elided in the sample above).
Related
- testset execute — produces the
ExecutionIdconsumed here. - wait — block until the execution is in a terminal state before asking for a summary.
- result — same data as a JUnit XML file.
- execution list-testcaselogs — full enumeration of logs (not only failures).
- testcaselog list-assertions — examine a single failed log.
Voir également
- Test Manager overview
- Scripting patterns
- Output formats — how
--output-filterand--queryrelate.