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 erstellen

Erstellen Sie einen leeren Testsatz in einem Projekt. Verwenden Sie anschließend testcases add um ihn auszufüllen.

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

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.

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

• --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-Testsätze löschen

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-Testsätze – Listentestfälle

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 werden ausgeführt

Führen Sie einen Testsatz aus und geben Sie seine ExecutionId sofort zurück. Der Testsatz selbst muss bereits mit einem Paket und Ordner konfiguriert sein – entweder durch Erstellen innerhalb der Web-Benutzeroberfläche von Test Manager oder manuell über die REST-API. Ausführung blockiert nicht; koppeln Sie es mit uip tm wait in Skripts.

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:

Das zurückgegebene Status spiegelt den Status beim Start wider (normalerweise Running); bedeutet dies nicht , dass die Ausführung erfolgreich war. Um das Ausführungsergebnis abzurufen, blockieren Sie uip tm wait und lesen Sie dann uip tm report get. Das Exit-Code-Verhalten für den kombinierten Launch-and-Wait-Flow ist in uip tm executions dokumentiert. Die Referenzen für wait und report finden Sie im Abschnitt „Zugehörige Elemente“.

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 – CI-optimierte Muster zum Starten und Überprüfen von Ausführungen.