uip-tm-Testfälle ab

uip tm testcases verwaltet Testfälle innerhalb eines Test Manager-Projekts: Erstellen, Auflisten, Aktualisieren, Löschen, Verknüpfen oder Aufheben der Verknüpfung einer Orchestrator-Automatisierung, Überprüfen historischer Ergebnisse und Hinzufügen oder Entfernen von Testfällen aus einem Testsatz. Auf dieser Seite wird auch uip tm testcaselogs list-assertions dokumentiert, das die Assertionsartefakte liest, die an ein einzelnes Testfallprotokoll angehängt sind, das von einer Ausführung erzeugt wurde.

Ein Testfall ist die Einheit der Autorisierung. Es wird ausführbar, sobald es mit einem Paketeinstiegspunkt mit testcases link-automation verknüpft ist, und es wird als Teil eines Testsatzes ausgeführt (siehe Testsätze).

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-Testfälle erstellen

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.

Liste der UIP-TM-Testfälle

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"
    }
  ]
}

Liste der UIP-TM-Testfälle

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"
    }
  ]
}

Aktualisierung der UIP-TM-Testfälle

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-Testfälle löschen

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-Testfälle Link-Automatisierung

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-Testfälle – Automatisierung aufheben

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"
  }
}

Listenautomatisierungen für UIP-TM-Testfälle

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-Testfälle – Listentestsätze

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-Testfälle hinzufügen

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-Testfälle entfernen

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 – gruppieren Testfälle in einer ausführbaren Suite.
• Ausführungen – Ansichten auf Ausführungsebene von Testfallprotokollen (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.