uip-tm-Testfälle ab

Syntax und Optionen für „uip tm testcases“, das Testfälle verwaltet, einschließlich Erstellen, Auflisten, Aktualisieren, Löschen, Verknüpfen von Automatisierungen und Testfallprotokollverwaltung.

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. Es bietet auch testcases run – eine Möglichkeit, einen oder mehrere Testfälle direkt aus einem Orchestrator-Paket auszuführen. Auf dieser Seite werden auch uip tm testcaselog list-assertions, testcaselog start und testcaselog finish (registriert unter testcaselog, Singular) dokumentiert, die Assertionsartefakte lesen und manuelle Protokolleinträge für ein Testfallprotokoll aufzeichnen.

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

Warnung:

Führen Sie testcases link-automation niemals für einen Testfall aus, der von uip tm pack für ein Playwright-Projekt erstellt wurde. Playwork-Testfälle werden während der Packzeit-Erfassung automatisch verknüpft; Wenn Sie link-automation manuell darauf ausführen, folgt sie stattdessen der RPA-Verknüpfungspipeline und beschädigt diese Zuordnung. Wenn Sie --no-create-test-cases haben, verwenden Sie stattdessen den Flow „Automatisierung auswählen“ in der Test Manager-Benutzeroberfläche.

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> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--top <number>] [--skip <number>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete --project-key <key> --test-case-key <key> [-y]
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases link-package --project-key <key> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
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 run --project-key <key> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <uuid>] [--runtime-type <type>] [--robot-user-key <uuid>] [--machine-key <uuid>] [--host-machine-name <name>] [--service-user-name <name>] [--test-set-packages <json>]
uip tm testcases add --test-set-key <key> (--test-case-keys <keys...> | --labels <labels...> [--limit <count>])
uip tm testcases remove --test-set-key <key> --test-case-keys <keys> [-y]
uip tm testcases list-steps --project-key <key> --test-case-id <uuid>

uip tm testcases steps list --project-key <key> --test-case-id <uuid>
uip tm testcases steps get --project-key <key> --step-id <uuid>
uip tm testcases steps add --project-key <key> --test-case-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>] [--order-no <n>] [--step <json>...]
uip tm testcases steps update --project-key <key> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move --project-key <key> --step-id <uuid> --target-position <n>
uip tm testcases steps delete --project-key <key> --step-id <uuid> [-y]

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

uip tm testcaselog start --project-key <key> --execution-id <uuid> --test-case-id <uuid> [--run-id <number>]
uip tm testcaselog finish --project-key <key> --execution-id <uuid> --test-case-id <uuid> --result <result> --has-error <boolean> --executed-by <email> [--detail-link <url>] [--run-id <number>] [--is-post-condition-met <boolean>] (--step-logs <json> | --step-logs-file <path>)

Wichtig:

list-assertions, start und finish werden unter uip tm testcaselog (Singular) registriert. uip tm testcaselogs list-assertions und uip tm testcaselogs start/finish sind nicht als Befehle vorhanden.

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes.

Hinweis:

--log-level <level> (Standard: Information) ist verfügbar in create, list, list-result-history, update, delete, link-automation, link-package, unlink-automation, list-automations, list-testsets, add und remove. Er ist nicht vorhanden in run, einem steps -Unterbefehl (einschließlich des list-steps -Alias) oder testcaselog start/finish/list-assertions.

uip-tm-Testfälle erstellen

Erstellen eines neuen Testfalls innerhalb eines Projekts.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--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. Die interne Id (UUID) wird für list-result-history und list-testsets benötigt.

Liste der UIP-TM-Testfälle

Listet alle Testfälle in einem Projekt auf. Die CLI durchläuft die Ergebnisse automatisch.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Aufzulistendes Projekt.
--filter <text>	Filtern Sie 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",
      "Description": "Logs in and out"
    }
  ]
}

Liste der UIP-TM-Testfälle

Listen Sie die historischen Testfallprotokolle für einen einzelnen Testfall auf. Nimmt die interne --test-case-id (UUID) – suchen Sie nach der UUID über testcases list oder aus einer früheren TestCaseCreate -Ausgabe.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-case-id <uuid>	Erforderlich. Interne Testfall-UUID.
--filter <text>	Suchen Sie Testfallprotokolle anhand des Namens.
--only-failed	Verknüpfung für „Nur fehlgeschlagene Protokolle anzeigen“ (Standard: false).
--results <results...>	Durch Leerzeichen getrennte Ergebnisse, die eingeschlossen werden sollen. 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 Sie 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, Vorbedingung oder Nachbedingung. Mindestens eines dieser Felder ist erforderlich.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-case-key <key>	Erforderlich. Testfallschlüssel (z. B. DEMO:1).
--name <name>	Neuer Name.
--description <text>	Neue Beschreibung.
--pre-condition <text>	Neue Vorbedingung – was vor dem Ausführen des Tests erfüllt sein muss.
--post-condition <text>	Neue Nachbedingung – was nach dem Ausführen des Tests „true“ sein sollte.

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",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "Result": "Updated"
  }
}

UIP-TM-Testfälle löschen

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

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-case-key <key>	Erforderlich. Testfallschlüssel (z. B. DEMO:1).
-y, --yes	Überspringen Sie die Bestätigungsaufforderung. In nicht interaktiven Umgebungen erforderlich.

Beispiel

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

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 aus --folder-key auf, sucht den passenden Paketeinstiegspunkt anhand des Namens und speichert dann die Bindung für den Testfall. Für Playwright-Testfälle, die von pack erstellt wurden, siehe die Warnung oben.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-case-key <key>	Erforderlich. Zu bindender Testfall.
--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 Testfallname innerhalb des Pakets (der Einstiegspunktname).

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

UIP-TM-Testfälle Linkpaket

Erstellen und verknüpfen Sie einen Testfall für jeden Test in einem Orchestrator-Paket in einem Aufruf – das Massen-Gegenstück zu link-automation, das einen vorhandenen Testfall mit einer Automatisierung verknüpft. Standardmäßig wird jeder Test verknüpft, den der Ordner verfügbar macht; Scope auf ein Paket mit --package-name oder auf bestimmte Tests mit --test-name. Jeder Test erstellt entweder einen neuen Testfall (Action: "Created") oder verwendet einen wieder, der bereits mit dieser Automatisierung verknüpft ist (Action: "Reused").

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--folder-key <uuid>	Erforderlich. UUID des Orchestrator-Ordners (von uip or folders list).
--package-name <name>	Verknüpfen Sie nur Tests aus diesem Paket (exakte Übereinstimmung ohne Groß-/Kleinschreibung). Lassen Sie zu, jeden Test zu verknüpfen, den der Ordner verfügbar macht.
--test-name <name...>	Verknüpfen Sie nur diese Tests (Groß-/Kleinschreibung wird nicht berücksichtigt, wiederholbar). Lassen Sie zu, alle zu verknüpfen.
--dry-run	Zeigen Sie eine Vorschau an, welche Testfälle erstellt, wiederverwendet und verknüpft werden würden, ohne etwas zu schreiben.

Beispiele

# Create and link a test case for every test in one Orchestrator package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests

# Preview what would be created and linked, without writing
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --dry-run

# Link only two named tests out of the package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest RegressionTest

Datenform

{
  "Code": "TestCaseLinkPackage",
  "Data": [
    {
      "TestName": "SmokeTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:7",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000007",
      "Action": "Created"
    },
    {
      "TestName": "RegressionTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:3",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000003",
      "Action": "Reused"
    }
  ]
}

Mit --dry-run ist Code stattdessen TestCaseLinkPackageDryRun, Action -Werte werden WouldCreate/WouldReuse und TestCaseKey/TestCaseId sind leere Zeichenfolgen, da nichts geschrieben wurde.

UIP-TM-Testfälle – Automatisierung aufheben

Die Automatisierungsbindung 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

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--test-case-key <key>	Erforderlich. Testfall, dessen Verknüpfung aufgehoben werden soll.

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 Testeinstiegspunkte auf, die in einem Orchestrator-Ordner verfügbar sind. Verwenden Sie diese Option, um die Werte --package-name / --test-name zu erkennen, die an link-automation übergeben werden sollen.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Eigenes Projekt (wird zum Scope der Suche verwendet).
--folder-key <uuid>	UUID des Orchestrator-Ordners. Lassen Sie die Suche im gesamten Mandantenfeed anstelle von einem Ordner weg.
--package-name <name>	Filtern Sie die Liste auf ein Paket (exakte Übereinstimmung ohne Groß-/Kleinschreibung, keine Suche nach Teilzeichenfolgen).

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

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--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 werden ausgeführt

Führen Sie einen oder mehrere Testfälle direkt aus einem Orchestrator-Paket aus, ohne zuerst einen Testsatz zu erstellen. testcases run startet eine Ausführung und gibt den Ausführungsdatensatz zurück. Weitere Informationen zu dieser Funktion finden Sie unter Ausführen von Testfällen ohne Testsatz in der Test Manager-Dokumentation.

Hinweis:

testcases run ist standardmäßig synchron – es wird blockiert, bis der Ausführungsdatensatz bestätigt wird. Um sofort nach dem Einreihung in die Warteschlange zurückzukehren, übergeben Sie --async. Zum Blockieren bis zum Ende der Ausführung leiten Sie die zurückgegebene Id an uip tm wait weiter.

Wann Sie testcases run vs. testsets runverwenden sollten

• Verwenden Sie testcases run , um Testfälle bei Bedarf direkt aus einem Paket auszuführen.
• Verwenden Sie testsets run , um eine benannte, kuratierte Gruppe von Testfällen auszuführen, die im Test Manager im Laufe der Zeit verwaltet werden.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Test Manager-Projektschlüssel (z. B. DEMO). Optional, wenn aus dem Kontext abgeleitet werden kann.
--test-case-id <uuid...>	Erforderlich. Mindestens eine auszuführende Testfall-UUIDs, durch Leerzeichen getrennt. Rufen Sie UUIDs von testcases list ab.
--execution-type <type>	Erforderlich. Ausführungstyp: automated, manual, mixed oder none.
--name <name>	Anzeigename für die Ausführung.
--async	Kehren Sie sofort nach dem Einreihung in die Warteschlange zurück, ohne darauf zu warten, dass der Server bestätigt, dass die Ausführung gestartet wurde. Unterlassen Sie, zu warten, bis der Ausführungsdatensatz vollständig erstellt wurde, bevor Sie zurückgegeben werden.
--folder-key <uuid>	Orchestrator-Ordner, in dem ausgeführt werden soll. Erforderlich, wenn die Testfälle mit Automatisierungen in einem bestimmten Ordner verknüpft sind.
--runtime-type <type>	Überschreiben des Roboter-Runtime-Typs. Zulässige Werte: nonProduction, attended, unattended, rpaDeveloper, studioX, headless, rpaDeveloperPro, testAutomation, automationCloud, serverless, automationKit, serverlessTestAutomation, automationCloudTestAutomation, attendedStudioWeb, hosting, assistantWeb, processOrchestration, agentService, appTest, performanceTest, businessRule, caseManagement.
--robot-user-key <uuid>	Roboterbenutzerschlüssel für das Ausführungsziel.
--machine-key <uuid>	Maschinenschlüssel für das Ausführungsziel.
--host-machine-name <name>	Hostmaschinenname für das Ausführungsziel.
--service-user-name <name>	Dienstbenutzername für das Ausführungsziel.
--test-set-packages <json>	JSON-Array von Paketüberschreibungen: [{"packageName":"Pkg","version":"1.0.0"}].

Beispiele

# Simplest — run a single test case (blocks until execution record is created)
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Login smoke run"

# Run multiple test cases asynchronously, then wait for completion
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
  --execution-type automated \
  --name "Smoke run" \
  --async \
  --output-filter Id)

uip tm wait --execution-id "$id" --project-key DEMO --timeout 900
uip tm report get --execution-id "$id" --project-key DEMO

# Full override — specify folder, runtime, machine, and package version
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run" \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --runtime-type unattended \
  --machine-key 33333333-4444-5555-6666-777777777777 \
  --test-set-packages '[{"packageName":"InvoiceTests","version":"1.0.2"}]'

Datenform

{
  "Code": "TestCaseRun",
  "Data": {
    "Id": "b2c3d4e5-0000-0000-0000-000000000001",
    "Name": "Login smoke run",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "Status": "Running",
    "ExecutionType": "automated",
    "Source": "Manual",
    "RunId": 1,
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "EnableCoverage": false,
    "EnforceExecutionOrder": false,
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}

Wichtige Felder:

• Id – übergeben an uip tm wait, report get, result download, attachment download.
• Status: "Running" – Die Ausführung wurde möglicherweise noch nicht ausgelöst.
• Source: "Manual" – Alle testcases run -Ausführungen werden als manuell ausgelöst gekennzeichnet.

End-to-End-Workflow: Paket zu Ergebnissen

# 1. Discover your project key
uip tm project list --output json

# 2. Find the test case UUIDs you want to run
uip tm testcases list --project-key DEMO --filter "login" --output json

# 3. Find the folder that holds your package
uip or folders list --output json

# 4. Link the test case to the automation entry point
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

# 5. Run the test cases directly
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --name "PR #42 smoke" \
  --output-filter Id)

# 6. Block until done (timeout in seconds — 15 minutes here)
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 900

# 7. Read the result
uip tm report get --execution-id "$id" --project-key DEMO

# 8. Download JUnit XML for CI
uip tm result download \
  --execution-id "$id" \
  --project-key DEMO \
  --result-path ./junit.xml

# 9. Download screenshots and logs
uip tm attachment download \
  --execution-id "$id" \
  --project-key DEMO \
  --only-failed \
  --result-path ./attachments

UIP-TM-Testfälle hinzufügen

Fügen Sie Testfälle zu einem vorhandenen Testsatz hinzu, entweder durch explizite Schlüssel oder per Beschriftung. Übergeben Sie genau eines von --test-case-keys oder --labels.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--test-set-key <key>	Erforderlich. Testsatzobjektschlüssel (z. B. DEMO:42).
--test-case-keys <keys...>	Testfallschlüssel, die durch Leerzeichen getrennt hinzugefügt werden sollen (z. B. DEMO:1 DEMO:2). Durch Kommas getrennte Werte werden ebenfalls akzeptiert. Sich gegenseitig mit --labels ausschließen.
--labels <labels...>	Durch Leerzeichen getrennte Beschriftungsnamen. Fügt jeden Testfall im Projekt hinzu, der mindestens eine der Beschriftungen trägt – einschließlich der Beschriftungen PW_Tag_*, PW_Project_*, PW_Suite_* und PW_File_* , die von pack bei der Erfassung angewendet werden. Sich gegenseitig mit --test-case-keys ausschließen.
--limit <count>	Maximale Anzahl der hinzugefügten Testfälle mit Beschriftungsübereinstimmung. Nur mit --labels gültig. Standardeinstellung sind alle Übereinstimmungen.

Beispiele

# add by explicit keys
uip tm testcases add \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1 DEMO:2

# add every test case carrying one of the given labels
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels PW_Tag_smoke PW_Project_chromium

Datenform

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

Beim Hinzufügen durch --labels enthält die Antwort auch MatchedLabels:

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:3, DEMO:4, DEMO:7",
    "MatchedLabels": "PW_Tag_smoke, PW_Project_chromium",
    "Result": "Added"
  }
}

uip-tm-Testfälle entfernen

Entfernen Sie einen oder mehrere Testfälle aus einem Testsatz.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--test-set-key <key>	Erforderlich. Testsatzobjektschlüssel (z. B. DEMO:42).
--test-case-keys <keys>	Erforderlich. Durch Kommas getrennte Testfallschlüssel, die entfernt werden sollen (z. B. DEMO:1,DEMO:2).
-y, --yes	Überspringen Sie die Bestätigungsaufforderung. In nicht interaktiven Umgebungen erforderlich.

Beispiel

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

Datenform

{
  "Code": "TestSetRemoveTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

Schritte für UIP-TM-Testfälle auflisten

Listen Sie die manuellen Testschritte eines Testfalls auf. Dies ist ein Alias für testcases steps list.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel (z. B. DEMO).
--test-case-id <uuid>	Erforderlich. Interne Testfall-UUID.

Beispiel

uip tm testcases list-steps \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

Schritte für UIP-TM-Testfälle

testcases steps ist eine Untergruppe, die die einzelnen manuellen Schritte eines Testfalls verwaltet: Auflisten, Abrufen, Hinzufügen, Aktualisieren, Verschieben und Löschen.

UIP-TM-Testfallschritte

Listen Sie die Schritte eines Testfalls in der richtigen Reihenfolge auf.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--test-case-id <uuid>	Erforderlich. Interne Testfall-UUID.

Beispiel

uip tm testcases steps list \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

Rufen Sie die Schritte für die UIP-TM-Testfälle ab

Rufen Sie einen einzelnen Schritt anhand seiner UUID ab.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--step-id <uuid>	Erforderlich. Testschritt-UUID (von steps list).

Beispiel

uip tm testcases steps get \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001

Datenform

{
  "Code": "TestStepGet",
  "Data": {
    "Id": "d4e5f6a7-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed"
  }
}

UIP-TM-Testfälle Schritte hinzufügen

Fügen Sie einem Testfall einen oder mehrere Schritte hinzu. Verwenden Sie Inline-Flags für einen einzelnen Schritt oder --step <json> (wiederholbar) für mehrere gleichzeitig.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--test-case-id <uuid>	Erforderlich. Testfall, dem Schritte hinzugefügt werden sollen.
--description <text>	Schrittbeschreibung (Einzelschrittmodus).
--expected-result <text>	Erwartetes Ergebnis (Einzelschrittmodus).
--action-type <type>	Schrittaktionstyp (Einzelschrittmodus).
--clipboard-data <text>	Testdaten, die für den Schritt kopiert werden sollen (Einzelschrittmodus).
--order-no <n>	0-basierte Einfügeposition; auf Anfügen am Ende weglassen (Einzelschrittmodus).
--step <json>	Ein Schritt als JSON-Objekt ({"description":"...","expectedResult":"..."}). Wiederholen Sie den Vorgang, um mehrere Schritte hinzuzufügen.

Beispiele

# single step
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --description "Open login page" \
  --expected-result "Login form is displayed"

# multiple steps
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --step '{"description":"Open login page","expectedResult":"Login form is shown"}' \
  --step '{"description":"Enter credentials","clipboardData":"[e-mail]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'

Datenform

{
  "Code": "TestStepAdd",
  "Data": {
    "AddedCount": 1,
    "Steps": [
      {
        "Id": "d4e5f6a7-0000-0000-0000-000000000001",
        "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
        "OrderNo": 0,
        "ActionType": "",
        "Description": "Open login page",
        "ExpectedResult": "Login form is displayed",
        "ClipboardData": ""
      }
    ]
  }
}

Das Hinzufügen von Schritten ist nicht atomar: Wenn ein Schritt in einem --step -Batch mit mehreren Schritten fehlschlägt, bleiben die Schritte vor ihm erstellt. Die Fehlermeldung meldet, wie viele erfolgreich waren, sodass Sie mit steps list prüfen und nur den Rest wiederholen können.

Aktualisierung der UIP-TM-Testfallschritte

Aktualisieren Sie die Beschreibung eines Schritts, das erwartete Ergebnis, den Aktionstyp oder die Zwischenablagedaten. Mindestens eines dieser Felder muss ausgefüllt werden.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--step-id <uuid>	Erforderlich. Testschritt-UUID.
--description <text>	Neue Beschreibung.
--expected-result <text>	Neues erwartetes Ergebnis.
--action-type <type>	Neuer Aktionstyp.
--clipboard-data <text>	Neue Daten in der Zwischenablage.

Beispiel

uip tm testcases steps update \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --expected-result "Dashboard is shown"

Datenform

{
  "Code": "TestStepUpdate",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uip-tm-Testfälle Schritte verschieben

Verschieben Sie einen Schritt an eine neue Position in der Testfallreihenfolge.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--step-id <uuid>	Erforderlich. Testschritt-UUID.
--target-position <n>	Erforderlich. Neue 0-basierte Position (0 = first). Entspricht dem Feld OrderNo aus steps list.

Beispiel

uip tm testcases steps move \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --target-position 2

Datenform

{
  "Code": "TestStepMove",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "TargetPosition": 2,
    "Result": "Moved"
  }
}

UIP-TM-Testfallschritte löschen

Einen Schritt aus einem Testfall löschen. Dies ist endgültig.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Test Manager-Projektschlüssel.
--step-id <uuid>	Erforderlich. Testschritt-UUID.
-y, --yes	Erforderlich. Bestätigen Sie diesen nicht rückgängig zu machenden Vorgang.

Beispiel

uip tm testcases steps delete \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --yes

Datenform

{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcaselog 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 aufgezeichnete Prüfungen. Dieses Verb zeigt , warum ein Testfallprotokoll markiert ist Failed.

Dieses Verb ist unter testcaselog (Singular) neben testcaselog start und testcaselog finish unten registriert – nicht unter testcases oder testcaselogs (Plarch). uip tm testcaselogs list-assertions ist nicht vorhanden.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--test-case-log-id <uuid>	Erforderlich. UUID des Testfallprotokolls. Rufen Sie es von uip tm executions testcaselogs list oder uip tm testcases list-result-history ab.
--project-key <key>	Erforderlich. Besitz des Projekts.

Beispiel

uip tm testcaselog 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 }
  ]
}

uip tm testcaselog starten

Starten Sie eine Testfallausführung innerhalb einer vorhandenen Testausführung. Wird von Automatisierungen und Integrationen verwendet, um manuelle oder gemischte Testfallausführungen aufzuzeichnen – die meisten Benutzer rufen dies nicht direkt auf.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--execution-id <uuid>	Erforderlich. Die Testausführung, in der der Testfall ausgeführt wird.
--test-case-id <uuid>	Erforderlich. Interne UUID des Testfalls, der protokolliert wird.
--run-id <number>	Ausführungs-ID, für die aufgezeichnet werden soll. Lassen Sie die automatische Suche im aktuellen RunId der Ausführung weg.

Beispiel

uip tm testcaselog start \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001

Datenform

{
  "Code": "TestCaseLogStart",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "None",
    "BusinessResult": "None",
    "OriginalResult": "None",
    "Status": "Running",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": null,
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "Updated": "2025-04-15T10:30:00Z"
  }
}

Id ist die UUID des Testfallprotokolls – übergeben Sie sie an uip tm teststeplog list oder testcaselog list-assertions, sobald die Ausführung abgeschlossen ist. Die vollständige Antwort enthält viele weitere Felder (AutomationId, JobKey, PreCondition, PostCondition und andere), die zur Startzeit zumeist leer sind; Hier werden nur die Felder angezeigt, die für die Nachverfolgung des Fortschritts relevant sind.

uip tm testcaselog fertig stellen

Beenden Sie eine Testfallausführung, die mit testcaselog start gestartet wurde, und zeichnen Sie das Gesamtergebnis und (optional) jedes Schrittergebnis in einem Aufruf auf.

Wichtig:

In diesem Befehl ist kein Flag --test-case-log-id oder --info vorhanden. finish identifiziert die Ausführung über --execution-id + --test-case-id erneut (dasselbe Paar wird an start übergeben), nicht durch die zurückgegebene Protokoll-UUID start.

Argumente

Keine.

Optionen

Markieren	Beschreibung
--project-key <key>	Erforderlich. Besitz des Projekts.
--execution-id <uuid>	Erforderlich. Die Testausführung wurde an testcaselog start übergeben.
--test-case-id <uuid>	Erforderlich. Der Testfall wurde an testcaselog start übergeben.
--result <result>	Erforderlich. Gesamtergebnis (aus der SDK-Aufzählung Result, z. B. Passed, Failed).
--has-error <boolean>	Erforderlich. Markieren Sie die Ausführung als Fehler (true/false).
--executed-by <email>	Erforderlich. E-Mail-Adresse des Benutzers, der den Test ausgeführt hat.
--detail-link <url>	URL mit zusätzlichen Ausführungsdetails.
--run-id <number>	Ausführungs-ID, für die aufgezeichnet werden soll. Lassen Sie die automatische Suche im aktuellen RunId der Ausführung weg.
--is-post-condition-met <boolean>	Markieren Sie, ob die Nachbedingung erfüllt war.
--step-logs <json>	JSON-Array von Schrittprotokollobjekten, die für diese Testfallausführung aufgezeichnet werden sollen. Sich gegenseitig mit --step-logs-file ausschließen.
--step-logs-file <path>	Pfad zu einer JSON-Datei mit der gleichen Form wie --step-logs. Sich gegenseitig mit --step-logs ausschließen.

Beispiele

# finish with step results inline
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Passed \
  --has-error false \
  --executed-by [e-mail] \
  --is-post-condition-met true \
  --step-logs '[{"id":"3fa85f64-0000-0000-0000-000000000001","testStepId":"d4e5f6a7-0000-0000-0000-000000000001","result":"Passed","orderNo":1,"hasError":false,"hasAttachment":false}]'

# finish with step results loaded from a file
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Failed \
  --has-error true \
  --executed-by [e-mail] \
  --step-logs-file ./step-logs.json

Datenform

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Passed",
    "BusinessResult": "Passed",
    "OriginalResult": "Passed",
    "Status": "Finished",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": "2025-04-15T10:31:00Z",
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "IsPostConditionMet": true,
    "Updated": "2025-04-15T10:31:00Z"
  }
}

Zugehörig

• pack – packt ein Playwright-Projekt und verknüpft seine Testfälle zum Zeitpunkt der Erfassung automatisch; verwenden Sie link-automation nicht für die von ihm erstellten Testfälle.
• project – Scope, der jeden Testfall besitzt.
• testsets – gruppieren Testfälle in einer ausführbaren Suite.
• Ausführungen – Ansichten von Testfallprotokollen auf Ausführungsebene.
• Bericht – Zusammenfassung einer Ausführung mit fehlgeschlagenen Fällen und Assertionstext.

Siehe auch

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