uip-tm-Ausführungen

uip tm executions überprüft und manipuliert Testausführungen – die von uip tm testsets run erzeugten Objekte. Verwenden Sie diese Verben, um Ausführungen für einen Testsatz aufzulisten, die Testfallprotokolle einer abgeschlossenen Ausführung aufzulisten und nur die fehlgeschlagenen Fälle zu wiederholen.

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> [filters…]
uip tm executions testcaselogs list --execution-id <uuid> --project-key <key> [filters…]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--execution-type <type>]

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. Filter werden serverseitig angewendet; Die CLI gibt pro Aufruf eine Seite in der Größe --top / --skip zurück.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-set-id <uuid> (erforderlich) – Testsatz-UUID (das Id -Feld von testsets list, nicht TestSetKey).
• --filter <text> – Suche Ausführungen nach Namen.
• --status <status> – Filtern nach Ausführungsstatus. Akzeptierte Werte stammen aus der SDK-Aufzählung TestExecutionStatus .
• --execution-type <type> – Filtern nach Ausführungstyp. Akzeptierte Werte stammen aus der SDK-Aufzählung ExecutionType (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 .
• --top <number> – Seitengröße. Die Standardeinstellung ist 50.
• --skip <number> – Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Hinweis:

Die genauen Aufzählungswerte, die von --status, --execution-type und --execution-finished-interval akzeptiert werden, werden zur Laufzeit aus dem Test Manager SDK generiert. Führen Sie uip tm executions list --help aus, um den aktuellen Satz für Ihre installierte Toolversion anzuzeigen.

Beispiel

uip tm executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --top 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 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 – Tastenkombination für „Nur fehlgeschlagene Protokolle anzeigen“.
• --filter <text> – Suchprotokolle nach Namen.
• --results <results...> – Durch Leerzeichen getrennte Ergebnisse. Akzeptierte Werte stammen aus der SDK-Aufzählung Result .
• --statuses <statuses...> – durch Leerzeichen getrennte Ausführungsstatus. Akzeptierte Werte stammen aus der SDK-Aufzählung TestCaseLogExecutionStatus .
• --duration-period <period> – Filtern nach Dauer-Bucket. Akzeptierte Werte stammen aus der SDK-Aufzählung DurationPeriod .
• --top <number> – Seitengröße. Die Standardeinstellung ist 50.
• --skip <number> – 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 in der Ausgabe ist eine Testfallprotokoll-UUID. Fügen Sie es uip tm testcaselogs list-assertions hinzu, um zu sehen, warum ein Testfallprotokoll Failed markiert wurde.

Wiederholung von uip-tm-Ausführungen

Wiederholen Sie stattdessen nur die fehlgeschlagenen Testfälle einer abgeschlossenen Ausführung. Der Befehl:

1. Ruft die Statistiken der Ausführung ab und verweigert die Fortsetzung, es sei denn, die Ausführung befindet sich im Endzustand (andernfalls wird 1 mit einer Anleitungsmeldung beendet).
2. Wenn es null fehlgeschlagene Fälle gibt, gibt es einen Message -Umschlag aus und beendet 0 – dies ist absichtlich kein Fehler.
3. Andernfalls erfasst jede fehlgeschlagene Testfallprotokoll-ID (seitenweise) und startet einen Wiederholungsversuch, der nur auf diese Protokolle abzielt.

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
  }
}

Wenn es keine Fehler beim Wiederholen gibt:

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

Exitcodes

Alle uip tm executions … -Verben folgen den Standardaustrittscodes – 0 bei Erfolg (auch wenn retry nichts zum Wiederholen findet), 1 bei generischem Fehler, 2 bei Authentifizierungsfehler, 3 bei Validierungsfehler.

Der Test Manager-Ausführungslebenszyklus fügt ein Verhalten hinzu, das es wert ist, explizit aufgerufen zu werden, und es basiert auf wait und nicht auf den Ausführungsverben selbst:

Unterscheidung von „Zeitüberschreitung“ von „Mit Fehlern abgeschlossen“

Es gibt kein einzelnes tm -Verb, das ungleich Null endet , da Tests fehlgeschlagen sind. 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 , sobald die Ausführung in die Warteschlange gestellt wird.
2. Blockieren – uip tm wait --execution-id <id> --timeout <seconds> Abfragen, bis die Ausführung einen Endzustand erreicht.
   • Beendet 0 , wenn die Ausführung abgeschlossen ist (unabhängig von Bestanden/Fehlschlag – „Abgeschlossen“ ist hier das Erfolgssignal).
   • Beendet 2 bei --timeout -Ablauf. Dies ist domänenspezifisch: Der gemeinsame Vertrag reserviert 2 für AuthenticationError, aber wait verwendet es für TimeoutError wieder, sodass Skripte bei „dauern zu lange“ verzweigen können, ohne Text zu parsen. Siehe den Hinweis dazu unter uip tm wait Exitcodes.
   • Beendet 1 bei API-Fehler, Unterbrechung oder Abbruch.
3. Verdict – uip tm report get --execution-id <id> liest Passed / Failed / Skipped / PassRate. Ihr Skript entscheidet, wie ein Überlauf aussieht, und lässt den Build explizit fehlschlagen (z. B exit 1 wenn Failed > 0). report get beendet 0 selbst, wenn die Zusammenfassung erfolgreich erstellt wird, unabhängig vom Ergebnis der Ausführung, die er zusammenfasst.

# Start the run
id=$(uip tm testsets run --test-set-key DEMO:10 --output-filter .Data.ExecutionId)

# Block with a timeout; branch on the outcome
if ! uip tm wait --execution-id "$id" --timeout 1800; then
  code=$?
  if [ "$code" -eq 2 ]; then
    echo "timed out" >&2
    exit 2
  fi
  echo "wait failed ($code)" >&2
  exit "$code"
fi

# Decide pass/fail from the summary
failed=$(uip tm report get --execution-id "$id" --project-key DEMO --output-filter .Data.Failed)
if [ "$failed" -gt 0 ]; then
  echo "$failed test case(s) failed" >&2
  exit 1
fi
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 – testcaselogs list-assertions wandelt ein fehlgeschlagenes Protokoll in ein Detail pro Assertion um.

Siehe auch

• Test Manager-Übersicht
• Austrittscodes – gemeinsam genutzter Vertrag.
• Skriptingmuster – die dreistufige Pipeline zum Starten, Warten und Verifizieren im Detail.