uip-tm-Ausführungen

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> [--test-set-id <uuid>] [--filter <text>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered --project-key <key> [--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> [--only-failed] [--filter <text>] [--limit <n>] [--offset <n>]
uip tm executions run --project-key <key> --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> --project-key <key>

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Jedes Verb akzeptiert -t, --tenant <name> und --log-level <level> (Standard: Information).

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

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-set-id <uuid> – Testsatz-UUID (das Id -Feld von testsets list, nicht TestSetKey).
• --filter <text> – Suche Ausführungen nach Namen.
• --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

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --status <status> – Filtern nach einem einzelnen Ausführungsstatus. Akzeptierte Werte stammen aus der SDK-Aufzählung TestExecutionStatus . Führen Sie --help aus, um den aktuellen Satz anzuzeigen.
• --execution-type <type> – Filtern nach einem einzelnen Ausführungstyp (automated, manual, mixed, none).
• --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 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.
• --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": "ExecutionsFilteredList",
  "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

• --execution-id <uuid> (erforderlich) – Ausführung zur Überprüfung.
• --project-key <key> (erforderlich) – besitzendes Projekt.
• --only-failed – zeigt nur fehlgeschlagene Protokolle an.
• --filter <text> – Suchprotokolle nach Namen.
• --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

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --execution-id <uuid> (erforderlich) – ID der vorhandenen Ausführung, die erneut ausgeführt werden soll.
• --execution-type <type> (erforderlich) – welche Testfälle ausgeführt werden sollen (automated, manual, mixed, none).
• --test-case-log-ids <ids...> – durch Leerzeichen getrennte Testfallprotokoll-UUIDs. 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": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

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

• --execution-id <uuid> (erforderlich) – Ausführung zur Wiederholung.
• --project-key <key> – das besitzende Projekt. Entweder dies oder --test-set-key ist erforderlich.
• --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 die Wiederholung: automated (Standard), manual, mixed oder none.

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 ihrer ID mit aggregierter Anzahl von „Bestanden“/„Fehlgeschlagen“/„Keine“ ab. Verwenden Sie dies, um das endgültige Ergebnis einer abgeschlossenen Ausführung zu lesen, ohne den vollständigen Bericht abzurufen.

Argumente

Keine.

Optionen

• --execution-id <uuid> (erforderlich) – UUID der Testausführung.
• --project-key <key> (erforderlich) – besitzendes Projekt.

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",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z"
  }
}

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 \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter .Data.ExecutionId)

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800000; 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 .Data.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