uip tm testsets

uip tm testsets verwaltet Testsätze: die ausführbare Einheit in Test Manager. Ein Testsatz ist eine geordnete Gruppe von Testfällen, die Sie mit einem Befehl ausführen und als eine einzige Ausführung nachverfolgen können. 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> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]

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

Testsatzverben, die --test-set-key verwenden, leiten das besitzende Projekt vom Präfix des Schlüssels ab (z. B DEMO:10 → Projekt DEMO), sodass --project-key nur für create und list erforderlich ist.

uip tm testsets create

Create an empty test set in a project. Use testcases add afterwards to populate it.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --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 testsets list

Listen Sie Testsätze in einem Projekt auf. Die CLI durchläuft die Ergebnisse automatisch.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – Projekt zur Liste.
• --folder-key <uuid> – auf Testsätze beschränken, die an diesen Orchestrator-Ordner gebunden sind. Clientseitig nach dem Abrufen angewendet.
• --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",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

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

uip tm testsets update

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

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – Testsatzschlüssel (z. B DEMO:10).
• --name <name> – Neuer Name.
• --description <text> – Neue Beschreibung.

Beispiel:

uip tm testsets update \
  --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 testsets delete

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

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – Testsatzschlüssel.

Beispiel:

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

Datenform:

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

uip tm testsets list-testcases

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

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – zu inspizierender Testsatz.

Beispiel:

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

Datenform:

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

uip tm testsets run

Run a test set and return its ExecutionId immediately. The test set itself must already be configured with a package and folder — either by authoring inside Test Manager's web UI, or by hand via the REST API. Run does not block; pair it with uip tm wait in scripts.

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – Der auszuführende Testsatz. Der Projektschlüssel leitet sich aus dem Präfix ab.
• --execution-type <type> – welche Testfälle ausgeführt werden sollen. Eines von:
  • automated (Standard) – nur automatisierte Testfälle.
  • manual – nur manuelle Testfälle.
  • mixed – Sowohl automatisiert als auch manuell.
  • none – Kein Typfilter.
• --input-path <file> – Der Pfad zu einer JSON-Datei mit Parameterüberschreibungen. Die Datei muss ein Array in der Form [{"name":"Param","type":"String","value":"v"}] enthalten. Überschreibungen werden mit den aktuellen Parameterdefinitionen des Testsatzes durch name (und, falls vorhanden, type) abgeglichen, ohne dass die Groß-/Kleinschreibung berücksichtigt wird. Wenn der Server keine Parameterdefinitionen meldet, werden die Eingaben unverändert gesendet.

Beispiele:

# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json

Datenform:

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

Hinweis:

The returned Status reflects the state at launch (typically Running); it does not mean the run has succeeded. To get the run outcome, block on uip tm wait and then read uip tm report get. Exit-code behavior for the combined launch-and-wait flow is documented on uip tm executions. See the Related section below for the wait and report references.

Zugehörig

• testcases — create and link the test cases that populate a test set.
• executions — list and retry executions once a test set has been run.
• warten – blockieren, bis ein zurückgegebenes ExecutionId einen Endzustand erreicht.
• Bericht, Ergebnis, Anhang – Artefakte nach der Ausführung.

Siehe auch

• Test Manager-Übersicht
• Skriptingmuster – CI-optimierte Muster zum Starten und Überprüfen von Ausführungen.