UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

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:

  1. Ruft die Statistiken der Ausführung ab (passed, failed, none, duration, Zeitpunkt).
  2. Blätter durch die fehlgeschlagenen Testfallprotokolle.
  3. Ruft für jedes fehlgeschlagene Protokoll ohne info -Zeichenfolge deren Assertionen ab und verkettet die Nachrichten der fehlgeschlagenen.
  4. 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 Ausgabe uip tm testsets run ab.

  • --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-key oder --test-set-key. Wenn Sie mehrere übergeben, wird zuerst --project-id verwendet, dann --project-key und 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 die Data -Nutzlast angewendet wird. Der gefilterte Wert ersetzt Data im ReportGet -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" }
    ]
  }
}
FeldBedeutung
TotalTestsPassed + Failed + None.
NoneTest case logs with no result, such as tests that did not run.
PassRatePercentage 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, EndTimeISO 8601-Zeitstempel aus den Ausführungsstatistiken; leer, wenn nicht festgelegt.
DurationFormatiert HH:MM:SS.
FailedTests[].ErrorDas 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-id oder --project-key. Wenn Sie beide übergeben, wird --project-id verwendet.

  • --execution-id <uuid> – Ausführung, deren Bericht exportiert werden soll.

  • --format <format> – Berichtsdateiformat, nur mit --execution-id : excel, pdf oder junit. Standardmäßig auf excel. 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 ist UTC. 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; 0 bedeutet keine Zeitüberschreitung. Die Standardeinstellung ist 600. Erfordert --wait.

  • --poll-interval <seconds> – Sekunden zwischen Statusprüfungen. Die Standardeinstellung ist 5. 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.

  • 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 export gestartet 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​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben