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>] [--playwright-projects <names...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testsets playwright-context --test-set-key <key>

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.
--folder-key <uuid>	Filtern Sie nach dem Orchestrator-Ordnerschlüssel (von uip or folders list).
--filter <text>	Serverseitige Suche über den Namen.
--include-last-execution	Fügen Sie jedem Testsatz den Status und den Zeitstempel der letzten Ausführung hinzu (siehe LastExecutionStatus/LastExecutionAt unten). Kostet eine zusätzliche Suche pro Testsatz.

Beispiel

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

Datenform

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

Id ist die interne UUID – die von executions list --test-set-id benötigt wird. Mit --include-last-execution erhält jeder Eintrag auch LastExecutionStatus und LastExecutionAt (beide leeren Strings, wenn der Testsatz nie ausgeführt wurde).

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"}].
--playwright-projects <names...>	Richten Sie die Ausführung auf ein oder mehrere Playwright-Projekte ein, die von uip tm pack gepackt werden (durch Leerzeichen getrennt, z. B. regression smoke). Die Auswahl bleibt für den Testsatz erhalten, sodass spätere Ausführungen desselben Testsatzes nicht wiederholt werden müssen.
--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.

Hinweis:

--playwright-projects ist eine ausgeblendete Option (von --help weggelassen) – sie ist vorhanden und funktioniert, aber die Flag-Oberfläche kann sich ändern, bevor die zugrunde liegende Ausführungsfunktion von Test Manager Playwright allgemein angekündigt wird. Es gilt nur für einen Testsatz, dessen Testfälle alle aus einem einzigen Playwright-Paket stammen; In jedem anderen Testsatz wird die Ausführung mit den playwright.config -Standardeinstellungen des Pakets fortgesetzt und das Flag wird effektiv ignoriert.

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

# Scope a run to specific Playwright projects (hidden option, see note above)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression smoke

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.

uip tm testsets Playwright-Kontext

Die Playwright-Auflösung eines Testsatzes testen: Ob jeder Testfall aus einem einzigen Playwright-Paket stammt und welche Playwright-Projektnamen verfügbar und aktuell ausgewählt sind. Ausgeblendet von --help (dasselbe Fälligkeitsdatum wie das --playwright-projects von run), aber real und funktionell – verwenden Sie es, um die gültigen --playwright-projects -Namen zu erkennen, bevor Sie run aufrufen, genau wie die eigene Option von run Text verweist hierher zurück.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--test-set-key <key>	Erforderlich. Testsatzobjektschlüssel (z. B DEMO:42).
--log-level <level>	Der Standardwert ist Information.

Beispiel

uip tm testsets playwright-context --test-set-key DEMO:42

Datenform

{
  "Code": "TestSetPlaywrightContext",
  "Data": {
    "TestSetKey": "DEMO:42",
    "IsPlaywright": true,
    "PackageIdentifier": "my-playwright-suite",
    "Version": "1.2.0",
    "AvailablePlaywrightProjects": "chromium, firefox, webkit",
    "SelectedPlaywrightProjects": "chromium"
  }
}

Wenn es sich bei dem Testsatz nicht um ein Playwright-Set mit einem Einzelpaket (RPA, gemischtes, manuelles oder kein Einzelpaket) handelt, ist IsPlaywright false und die Antwort enthält stattdessen ein Details -Feld: "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-projects." – die vier Playground-spezifische Felder oben werden in diesem Fall weggelassen. AvailablePlaywrightProjects/SelectedPlaywrightProjects sind durch Kommas verbundene Zeichenfolgen, keine Arrays.

Zugehörig

• pack – packt ein Playwright-Projekt und erzeugt die oben verwendeten --playwright-projects -Scope-Namen.
• 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