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

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-set-id <uuid>	Testsatz-UUID (das Feld Id von testsets list, nicht TestSetKey).
--filter <text>	Suchen Sie Ausführungen anhand des Namens.
--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>	Erforderlich. Besitz des Projekts.
--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>	Filtern Sie 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 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": "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

Markieren	Beschreibung
--execution-id <uuid>	Erforderlich. Zu überprüfende Ausführung.
--project-key <key>	Erforderlich. Besitz des Projekts.
--only-failed	Nur fehlgeschlagene Protokolle anzeigen.
--filter <text>	Suchen Sie Protokolle 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 testcaselogs 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>	Erforderlich. Besitz des Projekts.
--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 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": {
    "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

Markieren	Beschreibung
--execution-id <uuid>	Erforderlich. Ausführung, die wiederholt werden soll.
--project-key <key>	Besitz des Projekts. 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 den Wiederholungsversuch: 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 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>	Erforderlich. Test Manager-Projektschlüssel (z. B. DEMO).

Beispiel

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

Datenform

{
  "Code": "ExecutionGetStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Description": "Smoke + regression suite",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Source": "Manual",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "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 .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 – testcaselogs list-assertions wandelt ein fehlgeschlagenes Protokoll in ein Detail pro Assertion um.

Siehe auch

• Test Manager-Übersicht
• Exitcodes
• Skriptingmuster