uip tm testcases

uip tm testcases manages test cases within a Test Manager project: create, list, update, delete, link or unlink an Orchestrator automation, inspect historical results, and add or remove test cases from a test set. This page also documents uip tm testcaselogs list-assertions, which reads the assertion artifacts attached to a single test case log produced by a run.

A test case is the unit of authorship. It becomes runnable once it is linked to a package entry point with testcases link-automation, and it runs as part of a test set (see testsets).

Zusammenfassung

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--version <version>]
uip tm testcases list --project-key <key> [--filter <text>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [filters…]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>]
uip tm testcases delete --project-key <key> --test-case-key <key>
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --project-key <key> --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-key <key>
uip tm testcases add --test-set-key <key> --test-case-keys <keys>
uip tm testcases remove --test-set-key <key> --test-case-keys <keys>

uip tm testcaselogs list-assertions --project-key <key> --test-case-log-id <uuid>

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

uip tm testcases create

Erstellen eines neuen Testfalls innerhalb eines Projekts.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --name <name> (erforderlich) – Testfallname.
• --description <text> – Freiform-Beschreibung. Standardmäßig leer.
• --version <version> – Zeichenfolge der Testfallversion. Die Standardeinstellung ist 1.0.0.

Beispiel:

uip tm testcases create \
  --project-key DEMO \
  --name "Login smoke" \
  --description "Logs in and out"

Datenform:

{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out",
    "Version": "1.0.0"
  }
}

TestCaseKey (der öffentliche PROJECT:N -Bezeichner) ist das, was Sie an andere Verben übergeben. Das interne Id wird nur für list-result-history benötigt.

uip tm testcases list

Listet alle Testfälle in einem Projekt auf. Die CLI durchläuft die Ergebnisse automatisch; Für dieses Verb werden keine Paginierungsoptionen verfügbar gemacht.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – Projekt zur Liste.
• --filter <text> – Filtern nach Name oder Schlüssel (serverseitige Suche).

Beispiel:

uip tm testcases list --project-key DEMO --filter login

Datenform:

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

uip tm testcases list-result-history

Listen Sie die historischen Testfallprotokolle für einen einzelnen Testfall auf. Nimmt den internen --test-case-id (UUID), nicht den PROJECT:N -Schlüssel – suchen Sie nach dem UUID über testcases list oder in einer früheren TestCaseCreate -Ausgabe.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-id <uuid> (erforderlich) – interne Testfall-UUID.
• --filter <text> – Sucht Testfallprotokolle nach Namen.
• --only-failed – Tastenkombination für „Nur fehlgeschlagene Protokolle anzeigen“ (Standard: false).
• --results <results...> – Durch Leerzeichen getrennte Ergebnisse. Akzeptierte Werte stammen aus der SDK-Aufzählung Result .
• --statuses <statuses...> – durch Leerzeichen getrennte Ausführungsstatus. Akzeptierte Werte stammen aus der SDK-Aufzählung TestCaseLogExecutionStatus .
• --duration-period <period> – Filtern nach Dauer-Bucket. Akzeptierte Werte stammen aus der SDK-Aufzählung DurationPeriod .
• --top <number> – Seitengröße. Die Standardeinstellung ist 50.
• --skip <number> – Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Hinweis:

Die genauen akzeptierten Werte für --results, --statuses und --duration-period werden zur Runtime aus den Test Manager SDK-Aufzählungen generiert, die mit der installierten Toolversion ausgeliefert werden. Führen Sie uip tm testcases list-result-history --help aus, um den aktuellen Satz anzuzeigen.

Beispiel:

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed

Datenform:

{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

uip tm testcases update

Benennen Sie einen Testfall um oder ändern Sie seine Beschreibung. Von den Optionen --name und --description ist mindestens eine erforderlich; andernfalls schlägt der Befehl mit einem Validierungsfehler fehl.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-key <key> (erforderlich) – Testfallschlüssel (z. B DEMO:1).
• --name <name> – Neuer Name.
• --description <text> – Neue Beschreibung.

Beispiel:

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"

Datenform:

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Description": "Logs in and out",
    "Result": "Updated"
  }
}

uip tm testcases delete

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

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-key <key> (erforderlich) – Testfallschlüssel (z. B DEMO:1).

Beispiel:

uip tm testcases delete --project-key DEMO --test-case-key DEMO:1

Datenform:

{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcases link-automation

Binden Sie einen Orchestrator-Paketeinstiegspunkt an einen Testfall. Dadurch wird der Testfall innerhalb eines Testsatzes ausführbar.

Intern löst der Befehl den Anzeigenamen des Ordners von --folder-key auf, sucht den passenden Paketeinstiegspunkt anhand des Namens und speichert dann die Bindung im Testfall. Alle vier von --folder-key, --package-name und --test-name müssen in einen konkreten Einstiegspunkt aufgelöst werden, oder der Befehl schlägt fehl.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-key <key> (erforderlich) – Testfall zum Binden.
• --folder-key <uuid> (erforderlich) – UUID des Orchestrator-Ordners (von uip or folders list).
• --package-name <name> (erforderlich) – Bezeichner des Orchestrator-Pakets (z. B InvoiceTests).
• --test-name <name> (erforderlich) – Der Name des Testfalls innerhalb des Pakets (der Name des Einstiegspunkts).

Beispiel:

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

Datenform:

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

PackageSource ist der Anzeigename des Ordners, der von --folder-key aufgelöst wurde.

uip tm testcases unlink-automation

Die Paketeinstiegspunktbindung aus einem Testfall entfernen. Nach dem Aufheben der Verknüpfung ist der Testfall nicht mehr ausführbar, bis er erneut verknüpft wird.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-key <key> (erforderlich) – Testfall, zum Aufheben der Verknüpfung.

Beispiel:

uip tm testcases unlink-automation --project-key DEMO --test-case-key DEMO:1

Datenform:

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

uip tm testcases list-automations

Listen Sie die in einem Orchestrator-Ordner verfügbaren Testeinstiegspunkte auf – verwenden Sie dies, um die Werte --package-name / --test-name zu erkennen, die an link-automation übergeben werden sollen.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt (wird zum Scope der Suche verwendet).
• --folder-key <uuid> (erforderlich) – UUID des Orchestrator-Ordners.
• --package-name <name> – Filtert die Liste auf ein Paket (exakte Übereinstimmung ohne Groß-/Kleinschreibung).

Beispiel:

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Datenform:

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm testcases list-testsets

Listen Sie jeden Testsatz auf, der einen bestimmten Testfall enthält.

Argumente: keine.

Optionen:

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --test-case-key <key> (erforderlich) – Testfallschlüssel (z. B DEMO:1).

Beispiel:

uip tm testcases list-testsets --project-key DEMO --test-case-key DEMO:1

Datenform:

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

uip tm testcases add

Fügen Sie einen oder mehrere Testfälle zu einem Testsatz hinzu. Die CLI löst jeden Schlüssel in seine interne UUID auf und ruft den Zuweisungsendpunkt in einer Anforderung auf. Wenn ein Schlüssel unbekannt ist, schlägt der gesamte Aufruf fehl, bevor eine Änderung vorgenommen wird.

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – der zu ändernde Testsatz.
• --test-case-keys <keys> (erforderlich) – Durch Kommas getrennte Testfallschlüssel (z. B DEMO:1,DEMO:2). Leerzeichen um Kommas werden ignoriert.

Beispiel:

uip tm testcases add \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Datenform:

{
  "Code": "TestCaseAdd",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

uip tm testcases remove

Entfernen Sie einen oder mehrere Testfälle aus einem Testsatz. Die gleiche Semantik wie testcases add , ruft jedoch den Endpunkt für die Zuweisung auf.

Argumente: keine.

Optionen:

• --test-set-key <key> (erforderlich) – der zu ändernde Testsatz.
• --test-case-keys <keys> (erforderlich) – Durch Kommas getrennte Testfallschlüssel, die entfernt werden sollen.

Beispiel:

uip tm testcases remove \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Datenform:

{
  "Code": "TestCaseRemove",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

uip tm testcaselogs list-assertions

Listen Sie die Assertionen auf, die für ein einzelnes Testfallprotokoll aufgezeichnet wurden. Bei jeder Ausführung eines Testfalls wird genau ein Testfallprotokoll erzeugt; seine Assertionen sind die einzelnen von der Automatisierung aufgezeichneten Prüfungen (Expect, VerifyExpression usw.). Verwenden Sie dies, wenn Sie herausfinden möchten , warum ein Testfallprotokoll Failed markiert ist.

Dieses Verb wird unter testcaselogs registriert, nicht unter testcases, wird aber hier dokumentiert, da es Assertionsartefakte für das Protokoll eines Testfalls liest.

Argumente: keine.

Optionen:

• --test-case-log-id <uuid> (erforderlich) – Testfallprotokoll-UUID. Rufen Sie es von uip tm executions testcaselogs list oder uip tm testcases list-result-history ab.
• --project-key <key> (erforderlich) – besitzendes Projekt.

Beispiel:

uip tm testcaselogs list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Datenform:

{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

Zugehörig

• project – Scope, der jeden Testfall besitzt.
• testsets — group test cases into a runnable suite.
• executions — execution-level views of test case logs (execution testcaselogs list).
• Bericht – Zusammenfassung einer Ausführung mit fehlgeschlagenen Fällen und Assertionstext.

Siehe auch

• Test Manager-Übersicht
• uip or folders list – Quelle von --folder-key.
• uip or packages – So werden Orchestrator-Pakete und Einstiegspunkte registriert.