uip-tm-Testsets

Syntax und Optionen für „uip tm testsets“, das die ausführbaren Testsatzeinheiten verwaltet, die nachverfolgte Ausführungen in Test Manager erzeugen.

uip tm testsets verwaltet Testsätze: die ausführbare Einheit in Test Manager. Ein Testsatz ist eine geordnete Gruppe von Testfällen, die als einzelner Befehl gestartet und als einzelne Ausführung nachverfolgt werden. Jeder testsets run -Aufruf gibt ein ExecutionId zurück, das die anderen uip tm -Verben (wait, executions, report, result, attachment) als Eingabe verwenden.

Zusammenfassung

uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--filter <text>]
uip tm testsets update --project-key <key> --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --project-key <key> --test-set-key <key> [-y]
uip tm testsets list-testcases --project-key <key> --test-set-key <key> [--limit <n>] [--offset <n>]
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]

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

uip-tm-testsets erstellen

Erstellen Sie einen leeren Testsatz in einem Projekt.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--name <name>	Erforderlich. Testsatzname.
--description <text>	Freiform-Beschreibung. Standardmäßig leer.

Beispiel

uip tm testsets create \
  --project-key DEMO \
  --name "Smoke Suite" \
  --description "Core smoke tests"

Datenform

{
  "Code": "TestSetCreate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite",
    "Description": "Core smoke tests"
  }
}

UIP-TM-Testsatzliste

Listen Sie Testsätze in einem Projekt auf.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Aufzulistendes Projekt.
--filter <text>	Serverseitige Suche über den Namen.

Beispiel

uip tm testsets list --project-key DEMO --filter smoke

Datenform

{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id ist die interne UUID – die von executions list --test-set-id benötigt wird.

Aktualisierung der UIP-TM-Testsätze

Benennen Sie einen Testsatz um oder ändern Sie seine Beschreibung. Von den Optionen --name und --description muss mindestens eine angegeben werden.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-set-key <key>	Erforderlich. Testsatzschlüssel (z. B. DEMO:10).
--name <name>	Neuer Name.
--description <text>	Neue Beschreibung.

Beispiel

uip tm testsets update \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --name "Smoke Suite (2026)"

Datenform

{
  "Code": "TestSetUpdate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite (2026)",
    "Description": "Core smoke tests",
    "Result": "Updated"
  }
}

UIP-TM-Testsätze löschen

Löschen Sie einen Testsatz anhand seines Schlüssels.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-set-key <key>	Erforderlich. Testsatzschlüssel (z. B. DEMO:10).
-y, --yes	Überspringen Sie die Bestätigungsaufforderung. In nicht interaktiven Umgebungen erforderlich.

Beispiel

uip tm testsets delete --project-key DEMO --test-set-key DEMO:10 --yes

Datenform

{
  "Code": "TestSetDelete",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010",
    "Result": "Deleted"
  }
}

UIP-TM-Testsätze – Listentestfälle

Listen Sie die Testfälle auf, die einem Testsatz zugewiesen sind.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-set-key <key>	Erforderlich. Zu überprüfender Testsatz.
--limit <n>	Maximale Anzahl von Ergebnissen pro Seite. Die Standardeinstellung ist 50.
--offset <n>	Anzahl der zu überspringenden Ergebnisse. Die Standardeinstellung ist 0.

Beispiel

uip tm testsets list-testcases --project-key DEMO --test-set-key DEMO:10

Datenform

{
  "Code": "TestSetTestCasesList",
  "Data": [
    {
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Description": "Logs in and out"
    }
  ]
}

uip-tm-testsets werden ausgeführt

Führen Sie einen Testsatz aus und geben Sie seine ExecutionId zurück. Standardmäßig wird der Befehl zurückgegeben, sobald die Ausführung in die Warteschlange gestellt wird. Übergeben Sie --wait an den Block, bis die Ausführung einen Endstatus erreicht – dies kombiniert die Schritte zum Starten und Warten in einem Befehl.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--test-set-key <key>	Erforderlich. Testsatzobjektschlüssel (z. B. DEMO:42). Der Projektschlüssel leitet sich aus dem Präfix ab.
--execution-type <type>	Typ der auszuführenden Testfälle: automated (Standard), manual, mixed (sowohl automatisiert als auch manuell) oder none (kein Typfilter).
--input-path <file>	Pfad zu einer JSON-Datei, die Parameterüberschreibungen für die Ausführung enthält. Format: [{"name":"Param","type":"String","value":"v"}].
--wait	Blockieren Sie, bis die Ausführung einen Endstatus erreicht (finished, cancelled). Wenn sie weggelassen wird, wird der Befehl sofort nach der Einreihung in die Warteschlange zurückgegeben.
--timeout <seconds>	Maximale Sekunden, die gewartet werden soll, bis die Ausführung abgeschlossen ist (0 ohne Timeout). Erfordert --wait.
--poll-interval <seconds>	Sekunden zwischen Statusprüfungen während der Wartezeit. Erfordert --wait.

Beispiele

# Fire-and-forget — returns ExecutionId immediately
uip tm testsets run --test-set-key DEMO:10

# Block until done — no need for a separate uip tm wait call
uip tm testsets run \
  --test-set-key DEMO:10 \
  --wait

# Block with a timeout and custom poll interval
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --wait \
  --timeout 900 \
  --poll-interval 15

# Pass parameter overrides from a file
uip tm testsets run \
  --test-set-key DEMO:10 \
  --input-path ./params.json \
  --wait

Datenform

{
  "Code": "TestSetRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestSetKey": "DEMO:10",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

Hinweis:

Wenn --wait verwendet wird, spiegelt Status den Endstatus (Finished, Cancelled) und nicht Running wider. Der zurückgegebene ExecutionId ist in beiden Fällen gleich und kann an uip tm report get, uip tm result download und uip tm attachment download übergeben werden.

Zugehörig

• Testfälle – Erstellen und Verknüpfen der Testfälle, die einen Testsatz ausfüllen.
• Ausführungen – Listen Sie Ausführungen auf und wiederholen Sie sie, sobald ein Testsatz ausgeführt wurde.
• warten – blockieren, bis ein zurückgegebenes ExecutionId einen Endzustand erreicht.
• Bericht, Ergebnis, Anhang – Artefakte nach der Ausführung.

Siehe auch

• Test Manager-Übersicht
• Skriptingmuster