- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- scopes
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
UIP-TM-Bericht
Generieren Sie eine strukturierte Testzusammenfassung für eine abgeschlossene Testausführung oder exportieren Sie eine Ausführungsberichtsdatei im Excel-, PDF- oder JUnit-Format mit „uip tm report“.
uip tm report fasst Testausführungsberichte zusammen und exportiert sie. report get erstellt eine strukturierte Zusammenfassung einer abgeschlossenen Ausführung: Anzahl, Erfolgsrate, Dauer und jeden fehlgeschlagenen Testfall mit der Assertionsmeldung, die den Fehler erklärt. Die Ausgabe dient als eine von Menschen scannbare Dashboard-Zeile oder ein maschinenlesbares Vervorhersagen für CI-Pipelines. report export fordert den Test Manager auf, eine Berichtsdatei (Excel, PDF oder JUnit) für eine Ausführung oder PDF-Dateien ausgewählter Testfallergebnisse zu erstellen.
Zusammenfassung
uip tm report get --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>) [--query <expr>]
uip tm report export (--project-key <key> | --project-id <id>) (--execution-id <uuid> [--format <format>] | --test-case-log-ids <uuid...>) [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm report get --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>) [--query <expr>]
uip tm report export (--project-key <key> | --project-id <id>) (--execution-id <uuid> [--format <format>] | --test-case-log-ids <uuid...>) [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes.
UIP-TM-Bericht abrufen
Eine Zusammenfassung für eine abgeschlossene Testausführung abrufen. Der Befehl:
- Ruft die Statistiken der Ausführung ab (
passed,failed,none,duration, Zeitpunkt). - Blätter durch die fehlgeschlagenen Testfallprotokolle.
- Ruft für jedes fehlgeschlagene Protokoll ohne
info-Zeichenfolge deren Assertionen ab und verkettet die Nachrichten der fehlgeschlagenen. - Gibt einen JSON-Umschlag mit der Zusammenfassung sowie eine
FailedTests-Liste mit dem Testfallnamen zurück.
Der Befehl beendet 0 immer dann, wenn die Zusammenfassung erzeugt wird, unabhängig davon, ob die Ausführung erfolgreich war oder fehlgeschlagen ist. Es ist die Aufgabe des Aufrufers, „fehlgeschlagene Tests vorhanden“ in einen CI-Exit ungleich Null umzuwandeln (Verzweigung auf .Data.Failed). Die empfohlene dreistufige Pipeline finden Sie unter Exit-Code-Verhalten auf executions .
Argumente
Keine.
Optionen
-
--execution-id <uuid>(erforderlich) – zusammenzufassende Ausführung. Rufen Sie dies aus der Ausgabeuip tm testsets runab. -
--project-key <key>– Besitz des Projektschlüssels. -
--project-id <id>– besitzende Projekt-ID. Verwenden Sie sie anstelle von--project-key.Übergeben Sie
--project-id,--project-keyoder--test-set-key. Wenn Sie mehrere übergeben, wird zuerst--project-idverwendet, dann--project-keyund dann das Projektpräfix von--test-set-key. -
--test-set-key <key>– Testsatzschlüssel (z. B.DEMO:42); Der Projektschlüssel ist aus dem Präfix abgeleitet. -
--query <expr>– Jq-Filter, der auf dieData-Nutzlast angewendet wird. Der gefilterte Wert ersetztDataimReportGet-Umschlag. Unterstützt den Feldzugriff (.Field,.Field.Nested) und die Objekterstellung ({key: .Field}).
Beispiele
# 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}'
Datenform (Standardausgabe)
{
"Code": "ReportGet",
"Data": {
"ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
"TestSetName": "Smoke Suite",
"TotalTests": 10,
"Passed": 8,
"Failed": 2,
"None": 0,
"PassRate": 80,
"StartTime": "2025-04-15T10:00:00.000Z",
"EndTime": "2025-04-15T10:02:15.000Z",
"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,
"None": 0,
"PassRate": 80,
"StartTime": "2025-04-15T10:00:00.000Z",
"EndTime": "2025-04-15T10:02:15.000Z",
"Duration": "00:02:15",
"FailedTests": [
{ "TestCaseName": "Login flow", "Error": "Selector not found" },
{ "TestCaseName": "Logout flow", "Error": "Timeout" }
]
}
}
| Feld | Bedeutung |
|---|---|
TotalTests | Passed + Failed + None. |
None | Test case logs with no result, such as tests that did not run. |
PassRate | Percentage of the tests that ran, as a number rounded to one decimal: Passed / (Passed + Failed) × 100. Tests counted in None are left out. 0 when no test passed or failed. |
StartTime, EndTime | ISO 8601-Zeitstempel aus den Ausführungsstatistiken; leer, wenn nicht festgelegt. |
Duration | Formatiert HH:MM:SS. |
FailedTests[].Error | Das Feld info des Testfallprotokolls, falls vorhanden; andernfalls eine ; -verbundene Liste fehlgeschlagener Assertionsnachrichten; andernfalls ein leerer String. |
Export von UIP-TM-Berichten
Exportieren Sie eine Berichtsdatei. Übergeben Sie --execution-id für den Bericht einer Ausführung im Excel-, PDF- oder JUnit-Format oder --test-case-log-ids für ein PDF ausgewählter Testfallergebnisse. Ein Testfallergebnis erzeugt ein .pdf; zwei oder mehr erstellen ein .zip mit einer PDF-Datei pro Ergebnis. Es ist genau eine der Optionen --execution-id oder --test-case-log-ids erforderlich.
Der Test Manager erstellt die Datei als Hintergrundauftrag. Ohne --wait gibt der Befehl den Auftrag zurück und seine Instructions benennen die beiden Befehle, die ihn abschließen: export-jobs get (mit --object-type testExecution für einen Ausführungsbericht oder --object-type testCaseLog für Testfallergebnisse) bis Status liest Completed und dann attachment download --attachment-id für die Datei. Mit --wait ruft der Befehl den Auftrag selbst ab und schreibt die Datei in --output-file.
Für eine PDF-Datei mit Testfallergebnissen sind eine Test Cloud-Lizenz für das Konto und die Berechtigung zum Lesen der Ausführung für das Projekt erforderlich. Der JUnit-Export kann für einen Mandanten deaktiviert werden; result download erstellt stattdessen JUnit-XML auf der CLI.
Argumente
Keine.
Optionen
-
--project-key <key>– Besitz des Projektschlüssels. -
--project-id <id>– besitzende Projekt-ID. Verwenden Sie sie anstelle von--project-key.Übergeben Sie
--project-idoder--project-key. Wenn Sie beide übergeben, wird--project-idverwendet. -
--execution-id <uuid>– Ausführung, deren Bericht exportiert werden soll. -
--format <format>– Berichtsdateiformat, nur mit--execution-id:excel,pdfoderjunit. Standardmäßig aufexcel. Abgelehnt mit--test-case-log-ids, die immer PDF exportieren. -
--test-case-log-ids <uuid...>– Durch Leerzeichen getrennte Testfallprotokoll-UUIDs, deren Ergebnisse als PDF-Dateien exportiert werden sollen. -
--time-zone <iana-name>– IANA-Zeitzone für die in die Datei geschriebenen Zeitstempel, z. B.Europe/Bucharest. Die Standardeinstellung istUTC. Ein unbekannter Name wird abgelehnt, bevor der Export startet. -
--wait– Warten Sie, bis der Export abgeschlossen ist, und schreiben Sie die Datei in--output-file. -
--output-file <path>– Wo die Berichtsdatei geschrieben werden soll. Erforderlich mit--wait. Das übergeordnete Verzeichnis muss bereits vorhanden sein. -
--overwrite– ersetzt--output-file, wenn es bereits vorhanden ist. Ohne diese wird eine vorhandene Datei abgelehnt, bevor der Export beginnt. -
--timeout <seconds>– maximale Sekunden zu warten;0bedeutet keine Zeitüberschreitung. Die Standardeinstellung ist600. Erfordert--wait. -
--poll-interval <seconds>– Sekunden zwischen Statusprüfungen. Die Standardeinstellung ist5. Erfordert--wait.
--output-file, --overwrite, --timeout und --poll-interval haben ohne --wait keine Auswirkungen; Der Befehl protokolliert eine Warnung und gibt den Auftrag zurück. Bei --wait verlässt ein --timeout , das vergeht, 2 und schreibt nichts; Der Export wird im Hintergrund fortgesetzt.
Beispiele
# start a PDF report of one execution and get the job back
uip tm report export \
--project-key DEMO \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--format pdf
# export one execution's results as JUnit XML, wait, and write the file
uip tm report export \
--project-key DEMO \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--format junit \
--wait \
--output-file ./results.xml
# PDFs of two test case results, written as one .zip
uip tm report export \
--project-key DEMO \
--test-case-log-ids c3d4e5f6-0000-0000-0000-000000000011 c3d4e5f6-0000-0000-0000-000000000012 \
--wait \
--output-file ./results.zip
# start a PDF report of one execution and get the job back
uip tm report export \
--project-key DEMO \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--format pdf
# export one execution's results as JUnit XML, wait, and write the file
uip tm report export \
--project-key DEMO \
--execution-id a1b2c3d4-0000-0000-0000-000000000001 \
--format junit \
--wait \
--output-file ./results.xml
# PDFs of two test case results, written as one .zip
uip tm report export \
--project-key DEMO \
--test-case-log-ids c3d4e5f6-0000-0000-0000-000000000011 c3d4e5f6-0000-0000-0000-000000000012 \
--wait \
--output-file ./results.zip
Datenform (ohne --wait)
{
"Code": "ReportExport",
"Data": {
"Id": "b2c3d4e5-0000-0000-0000-000000000001",
"Status": "Initiated",
"TaskType": "TestExecutionPdfExport",
"AttachmentId": null,
"Created": "2026-10-15T10:00:00.000Z",
"CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
"Updated": "2026-10-15T10:00:00.000Z",
"UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
"Payload": null
}
}
{
"Code": "ReportExport",
"Data": {
"Id": "b2c3d4e5-0000-0000-0000-000000000001",
"Status": "Initiated",
"TaskType": "TestExecutionPdfExport",
"AttachmentId": null,
"Created": "2026-10-15T10:00:00.000Z",
"CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
"Updated": "2026-10-15T10:00:00.000Z",
"UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
"Payload": null
}
}
Id ist die Exportauftrags-ID. AttachmentId bleibt null bis der Auftrag abgeschlossen ist; dann ist es die ID der erzeugten Datei.
Datenform (mit --wait)
{
"Code": "ReportExport",
"Data": {
"Id": "b2c3d4e5-0000-0000-0000-000000000001",
"Status": "Completed",
"AttachmentId": "d4e5f6a7-0000-0000-0000-000000000002",
"OutputFile": "./results.xml",
"FileType": "xml",
"Bytes": 2311
}
}
{
"Code": "ReportExport",
"Data": {
"Id": "b2c3d4e5-0000-0000-0000-000000000001",
"Status": "Completed",
"AttachmentId": "d4e5f6a7-0000-0000-0000-000000000002",
"OutputFile": "./results.xml",
"FileType": "xml",
"Bytes": 2311
}
}
FileType ist das, was geschrieben wurde: xlsx, pdf, xml oder zip. Wenn sie nicht mit der Erweiterung von --output-file übereinstimmt, protokolliert der Befehl eine Warnung.
Zugehörig
- testsets run – erzeugt das hier verbrauchte
ExecutionId. - Wait – Blockieren Sie, bis sich die Ausführung in einem Endzustand befindet, bevor Sie eine Zusammenfassung anfordern.
- Ergebnis – die gleichen Daten wie eine JUnit-XML-Datei, die auf der CLI basiert.
- export-jobs – überprüfen, ob der Exportauftrag
report exportgestartet wird. - Ausführungsexport – eine Kalkulationstabelle mit vielen Ausführungen und nicht der Bericht einer Ausführung.
- führt die Testfallprotokollliste aus – vollständige Aufzählung der Protokolle (nicht nur Fehler) und die Quelle von
--test-case-log-ids. - testcaselog list-assertions – Untersuchen Sie ein einzelnes fehlgeschlagenes Protokoll.
Siehe auch
- Test Manager-Übersicht
- Skriptingmuster
- Ausgabeformate – wie sich
--output-filterund--querybeziehen.