uip-tm-Ausführungen

Syntax und Optionen für „uip tm Executions“, das Testausführungen auflistet, filtert und wiederholt und die Testfallprotokolle einer abgeschlossenen Ausführung überprüft.

uip tm executions überprüft und manipuliert Testausführungen – die von uip tm testsets run erzeugten Objekte. Diese Verben listen Ausführungen für einen Testsatz auf, listen die Testfallprotokolle einer abgeschlossenen Ausführung auf, führen eine vorhandene Ausführung nach ID erneut aus und versuchen es nur die fehlgeschlagenen Fälle erneut.

Der Befehl, der eine Ausführung startet, ist uip tm testsets run, der ein ExecutionId zurückgibt. Jedes Verb auf dieser Seite nimmt diese ID (oder leitet sie aus dem Kontext ab).

Zusammenfassung

uip tm executions list (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--filter <text>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm executions testcaselogs list --execution-id <uuid> (--project-key <key> | --project-id <id>) [--only-failed] [--filter <text>] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <n>] [--offset <n>]
uip tm executions run (--project-key <key> | --project-id <id>) --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> (--project-key <key> | --project-id <id>)

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes.

Hinweis:

--log-level is not uniformly available on this page. retry, testcaselogs list, and list accept it. list-filtered, get-stats, and run don't.

UIP-TM-Ausführungsliste

Listen Sie die Ausführungen auf, die einem Testsatz zugeordnet sind. --test-set-id ist optional – lassen Sie es weg, um Ausführungen für alle Testsätze im Projekt aufzulisten.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Owning project key. Pass this or --project-id.
--project-id <id>	Owning project ID. Use instead of --project-key. When you pass both, --project-id is used.
--test-set-id <uuid>	Testsatz-UUID (das Feld Id von testsets list, nicht TestSetKey).
--filter <text>	Suchen Sie Ausführungen anhand des Namens.
--status <status>	Filtern Sie nach einem einzelnen Ausführungsstatus. Akzeptierte Werte stammen aus der SDK TestExecutionStatus -Aufzählung – Ausführung --help für den aktuellen Satz.
--execution-type <type>	Filter by a single execution type (automated, manual, mixed, none, autonomous).
--execution-finished-interval <interval>	Filtern Sie danach, wie kürzlich die Ausführung abgeschlossen wurde. Akzeptierte Werte stammen aus der SDK-Aufzählung TestExecutionFinishedInterval.
--limit <n>	Seitengröße. Die Standardeinstellung ist 50.
--offset <n>	Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Beispiel

uip tm executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --limit 2

Datenform

{
  "Code": "ExecutionsList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Passed"
    },
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed"
    }
  ]
}

uip-tm-Ausführungen aufgelistet

Listen Sie Ausführungen mit erweiterten serverseitigen Filtern auf. Hinweis: --status und --execution-type sind einzelne Flags mit einem einzigen Wert. Die Filterung des Datumsbereichs erfolgt über --execution-finished-interval, nicht über Datumsflags.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Owning project key. Pass this or --project-id.
--project-id <id>	Owning project ID. Use instead of --project-key. When you pass both, --project-id is used.
--test-set-id <uuid>	Beschränken Sie die Ergebnisse auf eine einzelne Testsatz-UUID.
--status <status>	Filtern Sie nach einem einzelnen Ausführungsstatus. Akzeptierte Werte stammen aus der SDK TestExecutionStatus -Aufzählung – Ausführung --help für den aktuellen Satz.
--execution-type <type>	Filter by a single execution type (automated, manual, mixed, none, autonomous).
--execution-finished-interval <interval>	Filtern Sie danach, wie kürzlich die Ausführung abgeschlossen wurde. Akzeptierte Werte stammen aus der SDK-Aufzählung TestExecutionFinishedInterval.
--updated-by <userId>	Filtern Sie nach der Benutzer-ID, die die Ausführung zuletzt aktualisiert hat.
--search <text>	Freitextsuche über Ausführungsnamen und Metadaten.
--labels <labels...>	Durch Leerzeichen getrennte Beschriftungsnamen, nach denen gefiltert werden soll.
--test-execution-ids <ids...>	Durch Leerzeichen getrennte Ausführungs-UUIDs, die eingeschlossen werden sollen.
--sort-by <expr>	Sortierausdruck (Feldname, optional mit :asc oder :desc angehängt).
--limit <n>	Seitengröße. Die Standardeinstellung ist 50.
--offset <n>	Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Beispiel

uip tm executions list-filtered \
  --project-key DEMO \
  --status Failed \
  --execution-type automated \
  --limit 10

Datenform

{
  "Code": "ExecutionsListFiltered",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed",
      "ExecutionType": "automated"
    }
  ]
}

UIP-TM-Ausführungen testcaselogs-Liste

Listen Sie die Testfallprotokolle auf, die von einer einzelnen Ausführung erzeugt werden. Jedes Protokoll ist eine Ausführung eines Testfalls und enthält Ergebnis, Status und Zeitplan.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--execution-id <uuid>	Erforderlich. Zu überprüfende Ausführung.
--project-key <key>	Owning project key. Pass this or --project-id.
--project-id <id>	Owning project ID. Use instead of --project-key. When you pass both, --project-id is used.
--only-failed	Nur fehlgeschlagene Protokolle anzeigen.
--filter <text>	Suchen Sie Protokolle nach Namen.
--results <results...>	Durch Leerzeichen getrennte Liste von Ergebnissen, nach denen gefiltert werden soll (aus der SDK-Aufzählung Result, z. B. Passed, Failed).
--statuses <statuses...>	Durch Leerzeichen getrennte Liste der Ausführungsstatus, nach denen gefiltert werden soll (aus der SDK TestCaseLogExecutionStatus -Aufzählung).
--duration-period <period>	Filtern Sie nach, wie lange das Protokoll ausgeführt wurde (über die Aufzählung DurationPeriod des SDK, z. B. last7Days).
--limit <n>	Seitengröße. Die Standardeinstellung ist 50.
--offset <n>	Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Beispiel

uip tm executions testcaselogs list \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --only-failed

Datenform

{
  "Code": "ExecutionTestCaseLogs",
  "Data": [
    {
      "Id": "c3d4e5f6-0000-0000-0000-000000000001",
      "TestCaseName": "Login flow",
      "Status": "Finished",
      "Result": "Failed"
    }
  ]
}

Jeder Id ist eine Testfallprotokoll-UUID. Fügen Sie es uip tm testcaselog list-assertions hinzu, um zu sehen, warum ein Testfallprotokoll Failed markiert wurde.

ausgeführte UIP-TM-Ausführungen

Führen Sie eine vorhandene Ausführung anhand ihrer ID erneut aus. Dies ist nicht mit dem Starten einer neuen Ausführung identisch – sie wird innerhalb desselben Ausführungsdatensatzes wiederholt und zielt auf alle Testfälle oder eine bestimmte Teilmenge ab.

Hinweis:

Um eine brandneue Ausführung zu starten, verwenden Sie stattdessen uip tm testsets run .

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Owning project key. Pass this or --project-id.
--project-id <id>	Owning project ID. Use instead of --project-key. When you pass both, --project-id is used.
--execution-id <uuid>	Erforderlich. ID der vorhandenen Ausführung, die erneut ausgeführt werden soll.
--execution-type <type>	Required. Which test cases to run (automated, manual, mixed, none, autonomous).
--test-case-log-ids <ids...>	Durch Leerzeichen getrennte UUIDs von Testfallprotokollen. Wenn bereitgestellt, werden nur diese spezifischen Protokolle erneut ausgeführt.
--async	Kehren Sie sofort nach dem Einreihung in die Warteschlange zurück, ohne auf eine Bestätigung zu warten.

Beispiele

# re-run the entire execution
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated

# re-run specific failed logs only
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --test-case-log-ids c3d4e5f6-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000002

Datenform

{
  "Code": "ExecutionRun",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Succeeded"
  }
}

Status: "Succeeded" spiegelt hier wider, dass die Ausführungsanforderung akzeptiert wurde, nicht, dass die Testfälle bestanden haben – es wird auf die gleiche Weise zurückgegeben, ob --async festgelegt ist oder nicht. Überprüfen Sie das tatsächliche Bestehen-/Fehlschlagergebnis mit get-stats oder wait.

Wiederholung von uip-tm-Ausführungen

Wiederholen Sie nur die fehlgeschlagenen Testfälle einer abgeschlossenen Ausführung. Der Befehl ruft die Statistiken der Ausführung ab und verweigert die Fortsetzung, es sei denn, die Ausführung befindet sich im Endzustand. Wenn es null fehlgeschlagene Fälle gibt, wird 0 mit einer Meldung beendet. Der Wiederholungsversuch verwendet dieselbe Ausführungs-ID wieder. es wird keine neue erstellt.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--execution-id <uuid>	Erforderlich. Ausführung, die wiederholt werden soll.
--project-key <key>	Owning project key.
--project-id <id>	Owning project ID. Use instead of --project-key.
--test-set-key <key>	Testsatzschlüssel (z. B. DEMO:42); Der Projektschlüssel ist aus dem Präfix abgeleitet.
--execution-type <type>	Ausführungstyp für den Wiederholungsversuch: automated (Standard), manual, mixed oder none.

Pass --project-id, --project-key, or --test-set-key. When you pass more than one, --project-id is used first, then --project-key, then the project prefix of --test-set-key.

Beispiel

uip tm executions retry \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Datenform – wenn Fehler beim Wiederholen auftreten

{
  "Code": "ExecutionRetry",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z",
    "RetriedCount": 3
  }
}

Datenform – wenn keine Fehler beim Wiederholen auftreten

{
  "Code": "ExecutionRetry",
  "Data": {
    "Message": "Execution 'a1b2c3d4-0000-0000-0000-000000000001' has no failed test cases to retry."
  }
}

Get-Stats für UIP-TM-Ausführungen

Rufen Sie eine Testausführung nach ID mit allen ihren Ausführungsfeldern plus aggregierter Anzahl für „Bestanden“/„Fehlgeschlagen“/„Keine“ ab. Verwenden Sie dies, wenn Sie den unformatierten Ausführungsdatensatz mit Statistiken benötigen – z. B. um zu überprüfen, ob eine Ausführung vor dem Aufruf von report get abgeschlossen wurde, oder um Zeit- und Abdeckungsdaten für externe Berichte zu extrahieren.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--execution-id <uuid>	Erforderlich. UUID für die Testausführung. Rufen Sie dies von uip tm testsets run oder uip tm testcases run ab.
--project-key <key>	Test Manager project key (for example, DEMO). Pass this or --project-id.
--project-id <id>	Test Manager project ID. Use instead of --project-key. When you pass both, --project-id is used.

Beispiel

uip tm executions get-stats \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Datenform

{
  "Code": "ExecutionStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Description": "Smoke + regression suite",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Source": "Manual",
    "SourceDetails": "",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "TestSetScheduleId": "",
    "BatchExecutionKey": "",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "Duration": 3600000,
    "RunId": 12,
    "EnforceExecutionOrder": false,
    "EnableCoverage": false,
    "IsRunningAutomated": false,
    "HasTestsFromMultipleAutomationProjects": false,
    "RemoteControlAccess": "Disabled",
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z",
    "ReportingDate": "2025-04-15T11:00:00Z",
    "FolderKey": "11111111-2222-3333-4444-555555555555",
    "Created": "2025-04-15T09:55:00Z",
    "CreatedBy": "11111111-2222-3333-4444-555555555555",
    "Updated": "2025-04-15T11:00:00Z",
    "UpdatedBy": "11111111-2222-3333-4444-555555555555",
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}

Wichtige Felder:

• Passed, Failed, None – Anzahl der aggregierten Testfallprotokolle für die Ausführung.
• Duration – Gesamtausführungsdauer in Millisekunden.
• Status – der Ausführungsstatus. Bei Finished sind die Anzahlen mit Passed/Failed/None endgültig.
• IsRunningAutomated – true, während automatisierte Testfälle noch an Roboter verteilt werden.

Hinweis:

get-stats gibt den unformatierten Ausführungsdatensatz mit Anzahl zurück. Verwenden Sie für eine formatierte Zusammenfassung mit Fehlermeldungen pro Testfall stattdessen uip tm report get.

Exitcodes

Das Standardmuster für CIs ist eine Pipeline mit drei Schritten:

1. Starten – uip tm testsets run gibt ein ExecutionId zurück und beendet 0.
2. Blockieren – uip tm wait Abfragen, bis die Ausführung einen Endzustand erreicht. Beendet 0 wenn abgeschlossen, 2 bei Timeout, 1 bei Fehler.
3. Verdict – uip tm report get liest Passed / Failed Anzahl. Ihr Skript schlägt den Build explizit fehl.

id=$(uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter ExecutionId)

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800; then
  code=$?
  [ "$code" -eq 2 ] && { echo "timed out" >&2; exit 2; }
  echo "wait failed ($code)" >&2; exit "$code"
fi

failed=$(uip tm report get \
  --execution-id "$id" --project-key DEMO --output-filter Failed)
[ "$failed" -gt 0 ] && { echo "$failed test(s) failed" >&2; exit 1; }
echo "all passed"

Zugehörig

• testsets run – Starten Sie eine Ausführung.
• Wait – Blockieren, bis eine Ausführung einen Endstatus erreicht.
• Bericht, Ergebnis, Anhang – Artefakte nach der Ausführung.
• Testfälle – testcaselog list-assertions wandelt ein fehlgeschlagenes Protokoll in ein Detail pro Assertion um.

Siehe auch

• Test Manager-Übersicht
• Exitcodes
• Skriptingmuster