UiPath Documentation
uipath-cli
latest
false
UiPath-CLI-Benutzerhandbuch
Wichtig :
Dieser Inhalt wurde maschinell übersetzt. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

uip-tm-Testfälle ab

Syntax und Optionen für „uip tm testcases“, das Testfälle erstellt, massenweise erstellt, klont, auflistet, aktualisiert, löscht und exportiert, deren Schritte und Parameter verwaltet, Automatisierungen verknüpft und Testfälle Testsätzen zuweist.

uip tm testcases verwaltet Testfälle innerhalb eines Test Manager-Projekts: Erstellen Sie sie einzeln, massenweise aus einer Datei oder als Kopie eines anderen; Abrufen, Auflisten, Aktualisieren, Löschen und Exportieren; eine Orchestrator-Automatisierung verknüpfen oder die Verknüpfung aufheben; Überprüfen Sie die historischen Ergebnisse und die Testsätze und Anforderungen, denen ein Testfall zugewiesen ist; und Testfälle zu einem Testsatz hinzufügen oder aus einem Testsatz entfernen, statisch nach Schlüssel oder dynamisch nach Beschriftung. Es bietet auch testcases run, das einen oder mehrere Testfälle direkt aus einem Orchestrator-Paket ausführt, sowie die Untergruppen testcases steps und testcases parameters , die die manuellen Schritte und Parameter eines Testfalls verwalten. Die Verben, die Testfallprotokolle aufzeichnen und überprüfen, z. B. testcaselog start, testcaselog finish und testcaselog list-assertions, werden auf der Seite Testfallprotokoll dokumentiert.

Ein Testfall ist die Einheit der Autorisierung. Es wird ausführbar, sobald es mit einem Paketeinstiegspunkt mit testcases link-automation oder testcases link-package 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. Playwright-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 gepackt haben, sind noch keine Testfälle vorhanden: Erstellen Sie sie, und verknüpfen Sie dann jeden einzelnen mit testcases link-automation und übergeben Sie den angezeigten specPath > testTitle -Namen als --test-name.

Zusammenfassung​

uip tm testcases create <project> --name <name> [--description <text>] [--version <version>]
uip tm testcases bulk-create <project> --file <path> [--labels <labels...>] [--requirement-key <key>] [--skip-existing]
uip tm testcases clone <project> --test-case-key <key> --new-name <name> [--include <items...>]
uip tm testcases get <project> (--test-case-key <key> | --automation-id <uuid>)
uip tm testcases list <project> [--filter <text>] [--labels <labels...>] [--automated (--folder-path <path> | --folder-key <uuid>)]
uip tm testcases list-result-history <project> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <number>] [--offset <number>]
uip tm testcases update <project> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete <project> --test-case-key <key> --yes
uip tm testcases export <project> [--test-case-ids <uuid...>] [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testcases group-by <project> --field <name> [--sort-order <order>]
uip tm testcases link-automation <project> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name> [--entry-point-id <uuid>]
uip tm testcases link-package <project> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation <project> --test-case-key <key>
uip tm testcases list-automations <project> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-packages <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-studio-projects <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-testsets <project> (--test-case-key <key> | --labels <labels...>) [--limit <number>] [--offset <number>]
uip tm testcases list-requirements <project> --test-case-key <key> [--limit <number>] [--offset <number>]
uip tm testcases run <project> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <key>] [--runtime-type <type>] [--robot-user-key <key>] [--machine-key <key>] [--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> | --dynamic])
uip tm testcases remove --test-set-key <key> (--test-case-keys <keys> | --dynamic [--labels <labels...>]) --yes

uip tm testcases steps list <project> --test-case-id <uuid>
uip tm testcases steps get <project> --step-id <uuid>
uip tm testcases steps add <project> --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> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move <project> --step-id <uuid> --target-position <n>
uip tm testcases steps delete <project> --step-id <uuid> --yes

uip tm testcases parameters list <project> (--test-case-id <uuid> | --test-case-key <key>) [--search <prefix>] [--sort-by <expression>] [--limit <number>] [--offset <number>]
uip tm testcases parameters get <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>)
uip tm testcases parameters add <project> (--test-case-id <uuid> | --test-case-key <key>) --name <name> --default-value <value> [--hint <text>] [--type <type>]
uip tm testcases parameters update <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>) [--new-name <name>] [--default-value <value>] [--hint <text>] [--type <type>]
uip tm testcases parameters delete <project> (--test-case-id <uuid> | --test-case-key <key>) --parameter-ids <uuid...> --yes
uip tm testcases create <project> --name <name> [--description <text>] [--version <version>]
uip tm testcases bulk-create <project> --file <path> [--labels <labels...>] [--requirement-key <key>] [--skip-existing]
uip tm testcases clone <project> --test-case-key <key> --new-name <name> [--include <items...>]
uip tm testcases get <project> (--test-case-key <key> | --automation-id <uuid>)
uip tm testcases list <project> [--filter <text>] [--labels <labels...>] [--automated (--folder-path <path> | --folder-key <uuid>)]
uip tm testcases list-result-history <project> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <number>] [--offset <number>]
uip tm testcases update <project> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete <project> --test-case-key <key> --yes
uip tm testcases export <project> [--test-case-ids <uuid...>] [--time-zone <iana-name>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testcases group-by <project> --field <name> [--sort-order <order>]
uip tm testcases link-automation <project> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name> [--entry-point-id <uuid>]
uip tm testcases link-package <project> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation <project> --test-case-key <key>
uip tm testcases list-automations <project> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-packages <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-studio-projects <project> [--filter <prefix>] [--limit <number>] [--offset <number>]
uip tm testcases list-testsets <project> (--test-case-key <key> | --labels <labels...>) [--limit <number>] [--offset <number>]
uip tm testcases list-requirements <project> --test-case-key <key> [--limit <number>] [--offset <number>]
uip tm testcases run <project> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <key>] [--runtime-type <type>] [--robot-user-key <key>] [--machine-key <key>] [--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> | --dynamic])
uip tm testcases remove --test-set-key <key> (--test-case-keys <keys> | --dynamic [--labels <labels...>]) --yes

uip tm testcases steps list <project> --test-case-id <uuid>
uip tm testcases steps get <project> --step-id <uuid>
uip tm testcases steps add <project> --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> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move <project> --step-id <uuid> --target-position <n>
uip tm testcases steps delete <project> --step-id <uuid> --yes

uip tm testcases parameters list <project> (--test-case-id <uuid> | --test-case-key <key>) [--search <prefix>] [--sort-by <expression>] [--limit <number>] [--offset <number>]
uip tm testcases parameters get <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>)
uip tm testcases parameters add <project> (--test-case-id <uuid> | --test-case-key <key>) --name <name> --default-value <value> [--hint <text>] [--type <type>]
uip tm testcases parameters update <project> (--test-case-id <uuid> | --test-case-key <key>) (--parameter-id <uuid> | --parameter-name <name>) [--new-name <name>] [--default-value <value>] [--hint <text>] [--type <type>]
uip tm testcases parameters delete <project> (--test-case-id <uuid> | --test-case-key <key>) --parameter-ids <uuid...> --yes

In der Synopse steht <project> für --project-key <key> oder --project-id <id>. Übergeben Sie eine davon. Wenn beides angegeben ist, gewinnt --project-id und --project-key wird ignoriert. add und remove wählen keine Projektoption: Sie leiten das Projekt vom Präfix --test-set-key (DEMO:42 → Projekt DEMO) ab.

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

Hinweis:

--log-level <level> (Standard Information) ist für jedes Verb auf dieser Seite verfügbar, mit Ausnahme run, den steps -Unterbefehlen und den parameters -Unterbefehlen.

uip-tm-Testfälle erstellen​

Erstellen eines neuen Testfalls innerhalb eines Projekts.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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"
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"
  }
}
{
  "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 die meisten anderen Verben übergeben. Das interne Id (UUID) übernimmt die Verben list-result-history, run, export und steps .

UIP-TM-Testfälle massenweise erstellen​

Erstellen Sie viele Testfälle aus einer JSON-Datei. Die CLI validiert die gesamte Datei, bevor sie etwas sendet, und sendet dann die Testfälle 100 pro Anforderung. Jede Anforderung ist eine Transaktion: Es werden alle ihre Testfälle oder keine erstellt.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--file <path>Erforderlich. JSON-Datei: Ein Array von Testfällen oder ein Objekt mit einem testCases -Array. Siehe das Dateiformat unten an.
--labels <labels...>Beschriftungen, die für jeden erstellten Testfall hinzugefügt werden sollen, durch Leerzeichen getrennt.
--requirement-key <key>Weisen Sie jeden erstellten Testfall dieser Anforderung zu (z. B. DEMO:5).
--skip-existingÜberspringen Sie pro Name so viele Elemente, wie das Projekt bereits Testfälle mit genau diesem Namen hat. Kosten eine Suche pro Name für bis zu 10 verschiedene Namen; Darüber hinaus ein Lesen jedes Testfalls im Projekt.

Dateiformat​

Jedes Element in der Datei ist ein Objekt mit diesen Feldern. Unbekannte Felder werden abgelehnt.

FeldBeschreibung
nameErforderlich. Testfallname.
descriptionBeschreibungstext.
preConditionVorbedingungstext.
postConditionText nach Bedingung.
labelsArray von nicht leeren Beschriftungsnamen, bis zu 100.
stepsArray manueller Schritte. Jeder Schritt hat ein erforderliches description und optionale expectedResult und clipboardData (bis zu 8.000 Zeichen).
propertiesObjekt, das einen benutzerdefinierten Feldnamen zu einem Zeichenfolgenwert zuordnet. Jeder Name muss ein vorhandenes benutzerdefiniertes Testfallfeld im Projekt sein und der Wert eines Beschriftungsfelds muss einer seiner zulässigen Werte sein; andernfalls schlägt der Befehl fehl, bevor etwas erstellt wird.
[
  {
    "name": "Login smoke",
    "description": "Logs in and out",
    "preCondition": "User account exists",
    "labels": ["Smoke"],
    "steps": [
      { "description": "Open login page", "expectedResult": "Login form is displayed" }
    ],
    "properties": { "Priority": "High" }
  },
  { "name": "Logout" }
]
[
  {
    "name": "Login smoke",
    "description": "Logs in and out",
    "preCondition": "User account exists",
    "labels": ["Smoke"],
    "steps": [
      { "description": "Open login page", "expectedResult": "Login form is displayed" }
    ],
    "properties": { "Priority": "High" }
  },
  { "name": "Logout" }
]

Beispiel​

uip tm testcases bulk-create \
  --project-key DEMO \
  --file ./cases.json \
  --labels Imported \
  --skip-existing
uip tm testcases bulk-create \
  --project-key DEMO \
  --file ./cases.json \
  --labels Imported \
  --skip-existing

Datenform​

{
  "Code": "TestCaseBulkCreate",
  "Data": {
    "Requested": 3,
    "Created": 2,
    "KeysResolved": true,
    "Skipped": ["Login smoke"],
    "TestCases": [
      {
        "TestCaseKey": "DEMO:43",
        "Name": "Logout",
        "Id": "a1b2c3d4-0000-0000-0000-000000000043"
      },
      {
        "TestCaseKey": "DEMO:44",
        "Name": "Password reset",
        "Id": "a1b2c3d4-0000-0000-0000-000000000044"
      }
    ]
  }
}
{
  "Code": "TestCaseBulkCreate",
  "Data": {
    "Requested": 3,
    "Created": 2,
    "KeysResolved": true,
    "Skipped": ["Login smoke"],
    "TestCases": [
      {
        "TestCaseKey": "DEMO:43",
        "Name": "Logout",
        "Id": "a1b2c3d4-0000-0000-0000-000000000043"
      },
      {
        "TestCaseKey": "DEMO:44",
        "Name": "Password reset",
        "Id": "a1b2c3d4-0000-0000-0000-000000000044"
      }
    ]
  }
}

KeysResolved: false bedeutet, dass jedes Element erstellt wurde, aber die Schlüssel nicht zurückgelesen werden konnten, also TestCases ist leer, während Created dies nicht ist; Das Feld Instructions des Umschlags gibt an, wie sie zu finden sind. Wenn eine Anforderung teilweise fehlschlägt, bleiben die Testfälle aus früheren Anforderungen erhalten und die Fehlermeldung gibt an, wie viele erstellt wurden. Wenn die Ausführung --skip-existing verwendet hat, führen Sie denselben Befehl erneut aus. Folgen Sie andernfalls der Datei Instructions des Fehlers, mit der das Element benennen wird, von dem aus fortgesetzt werden soll; Eine einfache erneute Ausführung der gesamten Datei erstellt Duplikate.

klonen von uip-tm-Testfällen​

Stellen Sie eine Kopie eines Testfalls unter einem neuen Namen in die Warteschlange. Die Kopie enthält die Beschreibung, Version, Vor- und Nachbedingungen, benutzerdefinierte Feldwerte und manuelle Schritte. Beschriftungen, Anhänge, Anforderungszuweisungen, Parameter und Governance-Daten werden nur kopiert, wenn Sie sie in --include benennen.

Der Test Manager erstellt die Kopie im Hintergrund und meldet weder den Fortschritt noch den neuen Schlüssel, sodass der Befehl Data.Result: "Accepted" zurückgibt, sobald die Anforderung akzeptiert wird. Suchen Sie die Kopie mit uip tm testcases list --project-key <key> --filter "<new name>". Jede akzeptierte Anforderung erstellt eine eigene Kopie, also nicht erneut klonen, um zu überprüfen.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Erforderlich. Zu kopierender Testfall (z. B. DEMO:1).
--new-name <name>Erforderlich. Name für die Kopie.
--include <items...>Kopieren Sie auch die folgenden durch Leerzeichen getrennten: labels, documents (Anhänge), requirements (Anforderungszuweisungen), parameters, governance (wenn der Mandant es aktiviert hat). Standardmäßig keine.

Beispiel​

uip tm testcases clone \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --new-name "Login smoke (copy)" \
  --include labels requirements
uip tm testcases clone \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --new-name "Login smoke (copy)" \
  --include labels requirements

Datenform​

{
  "Code": "TestCaseClone",
  "Data": {
    "SourceTestCaseKey": "DEMO:1",
    "Name": "Login smoke (copy)",
    "Result": "Accepted"
  }
}
{
  "Code": "TestCaseClone",
  "Data": {
    "SourceTestCaseKey": "DEMO:1",
    "Name": "Login smoke (copy)",
    "Result": "Accepted"
  }
}

UIP-TM-Testfälle abrufen​

Rufen Sie einen einzelnen Testfall anhand des Schlüssels oder der damit verknüpften Automatisierung ab. Übergeben Sie genau eines von --test-case-key oder --automation-id.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1).
--automation-id <uuid>ID der verknüpften Automatisierung: ein PackageEntryPointId von list-automations oder eine Studio-Automatisierungs-ID. Gibt einen verknüpften Testfall zurück. Wenn sich mehrere Testfälle die Automatisierung teilen, ist nicht behoben, welcher Testfall zurückgegeben wird. Wenn kein Testfall im Projekt damit verknüpft ist, schlägt der Befehl mit ErrorCode: "not_found" fehl.

Beispiele​

uip tm testcases get --project-key DEMO --test-case-key DEMO:1
uip tm testcases get --project-key DEMO --test-case-key DEMO:1
uip tm testcases get \
  --project-key DEMO \
  --automation-id 7a1b2c3d-0000-0000-0000-000000000abc
uip tm testcases get \
  --project-key DEMO \
  --automation-id 7a1b2c3d-0000-0000-0000-000000000abc

Datenform​

{
  "Code": "TestCaseGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke",
    "Version": "1.0.0",
    "Description": "Logs in and out",
    "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
    "IsAutomated": true,
    "PackageName": "InvoiceTests",
    "PackageEntryPoint": "SmokeTest",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "AutomationId": "",
    "AutomationProjectName": "",
    "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc",
    "PackageVersion": "1.0.2",
    "HasLinkedAutomation": true,
    "Created": "2026-09-28T10:12:44.000Z",
    "Updated": "2026-09-28T10:12:44.000Z"
  }
}
{
  "Code": "TestCaseGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke",
    "Version": "1.0.0",
    "Description": "Logs in and out",
    "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
    "IsAutomated": true,
    "PackageName": "InvoiceTests",
    "PackageEntryPoint": "SmokeTest",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "AutomationId": "",
    "AutomationProjectName": "",
    "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc",
    "PackageVersion": "1.0.2",
    "HasLinkedAutomation": true,
    "Created": "2026-09-28T10:12:44.000Z",
    "Updated": "2026-09-28T10:12:44.000Z"
  }
}

Liste der UIP-TM-Testfälle​

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

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--filter <text>Filtern Sie nach Name oder Schlüssel (serverseitige Suche). In Kombination mit --labels können Sie die Beschriftungsübereinstimmungen anhand des Namens oder Schlüssels einzugrenzen.
--labels <labels...>Nur Testfälle, die mindestens eine dieser Beschriftungen haben, getrennt durch Leerzeichen, bis zu 100. Nicht mit --automated kombinierbar.
--automatedNur automatisierte Testfälle, deren Paket sich in einem Orchestrator-Ordner befindet. Erfordert genau eine von --folder-path oder --folder-key. Testfälle, die mit einem Playwright-Paket verknüpft sind, werden weggelassen. Nicht mit --labels kombinierbar.
--folder-path <path>Orchestrator-Ordnerpfad, z. B. Shared oder Finance/AP. Nur mit --automated; sich gegenseitig mit --folder-key ausschließen.
--folder-key <uuid>Orchestrator-Ordnerschlüssel (von uip or folders list). Nur mit --automated; sich gegenseitig mit --folder-path ausschließen.

Beispiele​

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

# Name the project by ID; the key lookup is skipped
uip tm testcases list --project-id 9dfdc3ca-fc75-0100-2aae-0b46e318b723
uip tm testcases list --project-key DEMO --filter login

# Name the project by ID; the key lookup is skipped
uip tm testcases list --project-id 9dfdc3ca-fc75-0100-2aae-0b46e318b723
# test cases carrying either label
uip tm testcases list --project-key DEMO --labels Smoke Regression

# automated test cases whose package lives in the Shared folder
uip tm testcases list --project-key DEMO --automated --folder-path Shared
# test cases carrying either label
uip tm testcases list --project-key DEMO --labels Smoke Regression

# automated test cases whose package lives in the Shared folder
uip tm testcases list --project-key DEMO --automated --folder-path Shared

Datenform​

{
  "Code": "TestCasesList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Version": "1.0.0",
      "Description": "Logs in and out",
      "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
      "IsAutomated": false,
      "PackageName": "",
      "PackageEntryPoint": ""
    }
  ]
}
{
  "Code": "TestCasesList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Version": "1.0.0",
      "Description": "Logs in and out",
      "FeedId": "f1e2d3c4-0000-0000-0000-000000000001",
      "IsAutomated": false,
      "PackageName": "",
      "PackageEntryPoint": ""
    }
  ]
}

PackageName und PackageEntryPoint zeigen das Paket und den Einstiegspunkt, der mit dem Testfall verknüpft ist, so wie die Test Manager-Benutzeroberfläche sie anzeigt. Beide sind leere Zeichenfolgen, wenn kein Paket verknüpft ist.

Bei --automated hat jede Zeile IsAutomated: true und die Zeilen werden nach Namen sortiert.

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​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Erforderlich. Interne Testfall-UUID.
--filter <text>Suchen Sie Testfallprotokolle anhand des Namens.
--only-failedNur Fallprotokolle von fehlgeschlagenen Testfällen anzeigen. Standard: false.
--results <results...>Durch Leerzeichen getrennte Ergebnisse, die Folgendes einschließen: None, Passed, Failed, Restricted.
--statuses <statuses...>Durch Leerzeichen getrennte Ausführungsstatus, darunter: pending, running, cancelling, cancelled, finished, failed.
--duration-period <period>Filtern nach Dauerzeitraum: last7Days, last15Days, last30Days, last90Days, last180Days, last365Days.
--limit <number>Anzahl der Ergebnisse pro Seite. Standard: 50.
--offset <number>Anzahl der zu überspringenden Ergebnisse. Standard: 0.

--top und --skip funktionieren weiterhin als veraltete Alias von --limit und --offset und geben eine Veraltungswarnung aus.

Beispiel​

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed
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"
    }
  ]
}
{
  "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​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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)"
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"
  }
}
{
  "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​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Erforderlich. Testfallschlüssel (z. B. DEMO:1).
-y, --yesErforderlich. Bestätigt die unwiderrufliche Löschung. Die CLI fordert nie auf; Ohne --yes schlägt der Befehl mit Result: "Failure" und Exitcode 1 fehl.

Beispiel​

uip tm testcases delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --yes
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"
  }
}
{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

UIP-TM-Testfälle exportieren​

Exportieren Sie Testfälle in eine .xlsx -Datei. Der Test Manager erstellt die Datei als Hintergrundauftrag. Ohne --wait gibt der Befehl den Auftrag zurück; Überprüfen Sie sie mit uip tm export-jobs get und sobald Status Completed ist, laden Sie die Datei mit uip tm attachment download herunter. Das Feld Instructions des Umschlags enthält beide Befehle für den Auftrag. Mit --wait wartet der Befehl auf den Auftrag und schreibt die Datei in --output-file.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-ids <uuid...>Zu exportierende Testfall-UUIDs, durch Leerzeichen getrennt. Unterlassen Sie den Export jedes Testfalls im Projekt.
--time-zone <iana-name>IANA-Zeitzone für die in die Datei geschriebenen Zeitstempel, z. B. Europe/Bucharest. Die Standardeinstellung ist UTC. Ein unbekannter Zonenname wird abgelehnt, bevor der Export beginnt.
--waitWarten Sie, bis der Export abgeschlossen ist, und schreiben Sie die Datei in --output-file.
--output-file <path>Wo die Datei .xlsx geschrieben werden soll. Erforderlich mit --wait.
--overwriteErsetzen Sie --output-file wenn er bereits vorhanden ist. Ohne diese wird eine vorhandene Datei abgelehnt, bevor der Export beginnt.
--timeout <seconds>Maximale Sekunden zu warten (0 = kein Timeout). Erfordert --wait. Die Standardeinstellung ist 600.
--poll-interval <seconds>Sekunden zwischen Statusprüfungen. Erfordert --wait. Die Standardeinstellung ist 5.

Ohne --wait haben --output-file, --overwrite, --timeout und --poll-interval keine Auswirkungen und der Befehl protokolliert eine Warnung.

Beispiele​

# start the export and get the job back
uip tm testcases export --project-key DEMO
# start the export and get the job back
uip tm testcases export --project-key DEMO
# export two test cases, wait for the file, and write it to disk
uip tm testcases export \
  --project-key DEMO \
  --test-case-ids a1b2c3d4-0000-0000-0000-000000000011 a1b2c3d4-0000-0000-0000-000000000012 \
  --wait \
  --output-file ./testcases.xlsx
# export two test cases, wait for the file, and write it to disk
uip tm testcases export \
  --project-key DEMO \
  --test-case-ids a1b2c3d4-0000-0000-0000-000000000011 a1b2c3d4-0000-0000-0000-000000000012 \
  --wait \
  --output-file ./testcases.xlsx

Datenform​

Ohne --wait:

{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Initiated",
    "TaskType": "TestCasesExcelExport",
    "AttachmentId": null,
    "Created": "2026-10-14T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2026-10-14T10:00:00.000Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Payload": { "Ids": [], "TimeZoneId": "UTC" }
  }
}
{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Initiated",
    "TaskType": "TestCasesExcelExport",
    "AttachmentId": null,
    "Created": "2026-10-14T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2026-10-14T10:00:00.000Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Payload": { "Ids": [], "TimeZoneId": "UTC" }
  }
}

Mit --wait:

{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Completed",
    "AttachmentId": "b2c3d4e5-0000-0000-0000-000000000002",
    "OutputFile": "./testcases.xlsx",
    "FileType": "xlsx",
    "Bytes": 9472
  }
}
{
  "Code": "TestCasesExport",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Completed",
    "AttachmentId": "b2c3d4e5-0000-0000-0000-000000000002",
    "OutputFile": "./testcases.xlsx",
    "FileType": "xlsx",
    "Bytes": 9472
  }
}

Id ist die Exportauftrags-ID. AttachmentId ist null bis der Auftrag abgeschlossen ist.

uip-tm-Testfälle gruppiert nach​

Zählen Sie die Testfälle des Projekts pro Wert eines benutzerdefinierten Beschriftungsfelds, z. B. Priority. Erfordert eine Test Cloud-Lizenz. Testfälle ohne Wert für das Feld werden unter Value: null gezählt.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--field <name>Erforderlich. Name des benutzerdefinierten Beschriftungsfelds, nach dem gruppiert werden soll, ohne Groß-/Kleinschreibung abgeglichen. Wenn kein Testfallbeschriftungsfeld diesen Namen hat, schlägt der Befehl mit ErrorCode: "not_found" fehl; Listen Sie die Felder auf, nach denen Sie uip tm customfield list --project-key <key> --object-types TestCase --data-types Label gruppieren können.
--sort-order <order>Sortieren Sie die Werte: asc oder desc. Die Standardeinstellung ist asc.

Beispiel​

uip tm testcases group-by --project-key DEMO --field Priority
uip tm testcases group-by --project-key DEMO --field Priority

Datenform​

{
  "Code": "TestCaseGroupBy",
  "Data": [
    { "Value": "High", "Count": 8 },
    { "Value": "Low", "Count": 3 },
    { "Value": null, "Count": 2 }
  ]
}
{
  "Code": "TestCaseGroupBy",
  "Data": [
    { "Value": "High", "Count": 8 },
    { "Value": "Low", "Count": 3 },
    { "Value": null, "Count": 2 }
  ]
}

Binden Sie einen Orchestrator-Paketeinstiegspunkt an einen Testfall. Dadurch wird der Testfall innerhalb eines Testsatzes ausführbar. Der Befehl löst den Anzeigenamen des Ordners von --folder-key auf, sucht den passenden Paketeinstiegspunkt anhand des Namens (oder anhand der ID mit --entry-point-id) und speichert dann die Bindung im Testfall. Für Playwright-Testfälle, die von pack erstellt wurden, lesen Sie die obige Warnung.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Erforderlich. Zu bindender Testfall.
--folder-key <uuid>Erforderlich. Orchestrator-Ordner-UUID (von uip or folders list). Ein Wert, der keine UUID ist, schlägt mit ErrorCode: "invalid_argument" fehl.
--package-name <name>Erforderlich. Bezeichner des Orchestrator-Pakets (z. B. InvoiceTests).
--test-name <name>Erforderlich. Der Testname innerhalb des Pakets. Für UiPath-Pakete der Testname (z. B. SmokeTest). Bei Playwright-Paketen der angezeigte specPath > testTitle -Name (z. B. "tests/login.spec.ts > Signs in"). Wird ignoriert, wenn --entry-point-id angegeben wird, ist aber dennoch erforderlich.
--entry-point-id <uuid>Paketeinstiegspunkt-ID, das PackageEntryPointId von list-automations. Bindet direkt nach ID und ignoriert --test-name. Verwenden Sie diese Option, wenn der Name zu lang für die Eingabe ist und list-automations ihn abgeschnitten mit … anzeigt.

Ein --test-name -Wert, der … enthält, ist ein abgeschnittener Name und kann nicht gefunden werden; Ohne --entry-point-id schlägt der Befehl fehl und fragt nach der ID.

Beispiele​

# Link a UiPath test
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

# Link a Playwright test by its displayed 'specPath > testTitle' name
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:2 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/login.spec.ts > Signs in"

# Link by entry-point ID when the name shows truncated in list-automations
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:3 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/checkout.spec.ts > …" \
  --entry-point-id 7a1b2c3d-0000-0000-0000-000000000abc
# Link a UiPath test
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

# Link a Playwright test by its displayed 'specPath > testTitle' name
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:2 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/login.spec.ts > Signs in"

# Link by entry-point ID when the name shows truncated in list-automations
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:3 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name PwTests \
  --test-name "tests/checkout.spec.ts > …" \
  --entry-point-id 7a1b2c3d-0000-0000-0000-000000000abc

Datenform​

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

TestName ist der vollständige Name des Einstiegspunkts, der gebunden wurde, auch wenn Sie durch --entry-point-id binden.

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 vorhandenen Testfall mit demselben Namen, der ohne Fall abgeglichen wird, und verknüpft ihn (Action: "Reused").

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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, die durch Leerzeichen getrennt sind (keine Beachtung von Groß-/Kleinschreibung). Lassen Sie zu, alle zu verknüpfen.
--dry-runZeigen 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
# 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
# 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
# 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"
    }
  ]
}
{
  "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 in WouldCreate Zeilen leer und benennen den vorhandenen Testfall in WouldReuse Zeilen.

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​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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
uip tm testcases unlink-automation \
  --project-key DEMO \
  --test-case-key DEMO:1

Datenform​

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}
{
  "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 dies, um die Werte --package-name und --test-name zu erkennen, die an link-automation oder die PackageEntryPointId übergeben werden sollen, die als --entry-point-id übergeben werden sollen. link-package wirkt auf den gleichen Satz von Einstiegspunkten.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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).

Beispiel​

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001
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",
      "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc"
    }
  ]
}
{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2",
      "PackageEntryPointId": "7a1b2c3d-0000-0000-0000-000000000abc"
    }
  ]
}

Listenpakete für UIP-TM-Testfälle​

Listen Sie die eindeutigen Orchestrator-Paketnamen auf, mit denen die automatisierten Testfälle des Projekts verknüpft sind. Namen werden sortiert und --limit / --offset blättern durch die sortierte Liste.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--filter <prefix>Nur Namen, die mit diesem Text beginnen (eine Präfixübereinstimmung, keine Teilzeichenfolge).
--limit <number>Anzahl der zurückzugebenden Namen. Die Standardeinstellung ist 50.
--offset <number>Anzahl der zu überspringenden Namen. Die Standardeinstellung ist 0.

Beispiel​

uip tm testcases list-packages --project-key DEMO --filter Invoice
uip tm testcases list-packages --project-key DEMO --filter Invoice

Datenform​

{
  "Code": "TestCasePackagesList",
  "Data": [
    { "PackageName": "InvoiceTests" }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCasePackagesList",
  "Data": [
    { "PackageName": "InvoiceTests" }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

Wenn HasMore true ist, gibt das Feld Instructions des Umschlags den --offset für die nächste Seite an.

UIP-TM-Testfälle list-studio-projects​

Listen Sie die eindeutigen Studio-Projektnamen auf, aus denen die automatisierten Testfälle des Projekts stammen. Namen werden sortiert und --limit / --offset blättern durch die sortierte Liste.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--filter <prefix>Nur Namen, die mit diesem Text beginnen (eine Präfixübereinstimmung, keine Teilzeichenfolge).
--limit <number>Anzahl der zurückzugebenden Namen. Die Standardeinstellung ist 50.
--offset <number>Anzahl der zu überspringenden Namen. Die Standardeinstellung ist 0.

Beispiel​

uip tm testcases list-studio-projects --project-key DEMO
uip tm testcases list-studio-projects --project-key DEMO

Datenform​

{
  "Code": "TestCaseStudioProjectsList",
  "Data": [
    { "StudioProjectName": "Acme.CheckoutTests" },
    { "StudioProjectName": "Acme.LoginTests" }
  ],
  "Pagination": {
    "Returned": 2,
    "Limit": 50,
    "Offset": 0,
    "Total": 2,
    "HasMore": false
  }
}
{
  "Code": "TestCaseStudioProjectsList",
  "Data": [
    { "StudioProjectName": "Acme.CheckoutTests" },
    { "StudioProjectName": "Acme.LoginTests" }
  ],
  "Pagination": {
    "Returned": 2,
    "Limit": 50,
    "Offset": 0,
    "Total": 2,
    "HasMore": false
  }
}

UIP-TM-Testfälle – Listentestsätze​

Listen Sie die Testsätze auf, die explizit einen bestimmten Testfall zuweisen oder die explizit einen Testfall zuweisen, der eine der angegebenen Bezeichnungen enthält. Übergeben Sie genau eines von --test-case-key oder --labels. Testsätze, die einen Testfall nur über dynamische Zuweisung enthalten, werden nicht aufgeführt.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1).
--labels <labels...>Beschriftungsnamen, durch Leerzeichen getrennt, bis zu 100. Gibt jeden Testsatz zurück, der mindestens einen von ihnen explizit einen Testfall zuweist.
--limit <number>Anzahl der zurückzugebenden Ergebnisse. Die Standardeinstellung ist 50.
--offset <number>Anzahl der zu überspringenden Ergebnisse. Die Standardeinstellung ist 0.

Beispiele​

uip tm testcases list-testsets \
  --project-key DEMO \
  --test-case-key DEMO:1
uip tm testcases list-testsets \
  --project-key DEMO \
  --test-case-key DEMO:1
uip tm testcases list-testsets \
  --project-key DEMO \
  --labels "Smoke Test" Regression
uip tm testcases list-testsets \
  --project-key DEMO \
  --labels "Smoke Test" Regression

Datenform​

{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

Anforderungen an UIP-TM-Testfälle​

Listen Sie die Anforderungen auf, die einem Testfall zugewiesen sind. Zeilen haben die gleiche Form wie requirements list.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-key <key>Erforderlich. Testfallschlüssel (z. B. DEMO:1).
--limit <number>Anzahl der zurückzugebenden Ergebnisse. Die Standardeinstellung ist 50.
--offset <number>Anzahl der zu überspringenden Ergebnisse. Die Standardeinstellung ist 0.

Beispiel​

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

Datenform​

{
  "Code": "TestCaseRequirementsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000005",
      "ObjKey": "DEMO:5",
      "Name": "User can sign in",
      "Description": "Sign-in works with a valid account",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2026-09-28T10:12:44.000Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2026-09-28T10:12:44.000Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}
{
  "Code": "TestCaseRequirementsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000005",
      "ObjKey": "DEMO:5",
      "Name": "User can sign in",
      "Description": "Sign-in works with a valid account",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2026-09-28T10:12:44.000Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2026-09-28T10:12:44.000Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ],
  "Pagination": {
    "Returned": 1,
    "Limit": 50,
    "Offset": 0,
    "Total": 1,
    "HasMore": false
  }
}

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 run​verwenden 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​

MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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: manual, automated, none, mixed oder autonomous.
--name <name>Erforderlich. Testsatzname für die neue Ausführung.
--asyncKehren 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 <key>Orchestrator-Ordnerschlüssel, in dem die Ausführung ausgeführt werden soll.
--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 <key>Roboterbenutzerschlüssel für das Ausführungsziel.
--machine-key <key>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"
# 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
# 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"}]'
# 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": "TestManager",
    "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 }
  }
}
{
  "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": "TestManager",
    "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.

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
# 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.

Die Zuweisung ist standardmäßig statisch: --test-case-keys oder --labels ohne --dynamic verknüpft die übereinstimmenden Testfälle einmal mit dem Testsatz und später beschriftete Testfälle werden nicht hinzugefügt. Mit --labels --dynamic werden die Beschriftungen stattdessen auf dem Testsatz gespeichert, sodass jeder Testfall, der jetzt oder später eine von ihnen enthält, Teil des Testsatzes ist und jeder Ausführung ihn enthält. Aktuelle dynamische Beschriftungen eines Testsatzes mit uip tm testsets get-dynamic-assignment anzeigen.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--test-set-key <key>Erforderlich. Testsatzobjektschlüssel (z. B. DEMO:42). Das Projekt ist aus dem Präfix abgeleitet.
--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 (Anführungszeichen, die Leerzeichen enthalten). Der Abgleich von Beschriftungen ist exakt und es wird Groß-/Kleinschreibung beachtet. 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. Ohne --dynamic kopiert die aktuellen Übereinstimmungen einmal in den Testsatz. Sich gegenseitig mit --test-case-keys ausschließen.
--dynamicMit --labels können Sie Testfälle dynamisch zuweisen: Speichern Sie die Beschriftungen im Testsatz zusammen mit den bereits festgelegten Beschriftungen (maximal 30 insgesamt). Nicht zulässig für Testsätze, die aus einer externen Quelle verknüpft sind. Die Zusammenführung liest und ersetzt dann die Beschriftungsliste, also führen Sie sie nicht gleichzeitig mit demselben Testsatz aus.
--limit <count>Maximale Anzahl der hinzugefügten Testfälle mit Beschriftungsübereinstimmung. Nur mit --labels gültig und nicht mit --dynamic. 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

# assign every test case labeled smoke, including ones labeled later
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels smoke \
  --dynamic
# 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

# assign every test case labeled smoke, including ones labeled later
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels smoke \
  --dynamic

Datenform​

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}
{
  "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"
  }
}
{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:3, DEMO:4, DEMO:7",
    "MatchedLabels": "PW_Tag_smoke, PW_Project_chromium",
    "Result": "Added"
  }
}

Bei --dynamic ist Code TestSetAddTestCasesDynamic:

{
  "Code": "TestSetAddTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression", "smoke"],
    "MatchedTestCases": 14,
    "Result": "Added"
  }
}
{
  "Code": "TestSetAddTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression", "smoke"],
    "MatchedTestCases": 14,
    "Result": "Added"
  }
}

DynamicLabels ist die vollständige Beschriftungsliste nach der Zusammenführung und MatchedTestCases zählt die Testfälle, mit denen diese Beschriftungen gerade übereinstimmen. Wenn die Beschriftungen gespeichert wurden, die Zählung aber fehlgeschlagen ist, ist MatchedTestCases null und der Umschlag enthält Warning.

uip-tm-Testfälle entfernen​

Entfernen Sie Testfälle aus einem Testsatz. Übergeben Sie genau eine von --test-case-keys, wodurch statisch zugewiesene Testfälle entfernt werden, oder --dynamic, wodurch die dynamische Zuweisung durch einige oder alle Beschriftungen beendet wird. Das Entfernen eines Schlüssels hat keine Auswirkungen auf einen Testfall, der sich nur über eine dynamische Beschriftung im Testsatz befindet.

Argumente​

Keine.

Optionen​

MarkierenBeschreibung
--test-set-key <key>Erforderlich. Testsatzobjektschlüssel (z. B. DEMO:42). Das Projekt ist aus dem Präfix abgeleitet.
--test-case-keys <keys>Durch Kommas getrennte Testfallschlüssel, die entfernt werden sollen (z. B. DEMO:1,DEMO:2). Sich gegenseitig mit --dynamic ausschließen.
--dynamicDynamische Zuweisung von Testfällen beenden: Entfernen Sie die mit --labels gegebenen Beschriftungen aus der dynamischen Zuweisung des Testsatzes oder alle, wenn --labels weggelassen wird. Statische Zuweisungen bleiben erhalten. Der Befehl liest und ersetzt dann die Beschriftungsliste, also führen Sie ihn nicht gleichzeitig für denselben Testsatz aus.
--labels <labels...>Zu entfernende dynamische Zuweisungsbeschriftungen, durch Leerzeichen getrennt, ohne Groß-/Kleinschreibung abgeglichen. Nur gültig mit --dynamic.
-y, --yesErforderlich. Bestätigt das Entfernen. Die CLI fordert nie auf; Ohne --yes schlägt der Befehl mit Result: "Failure" und Exitcode 1 fehl.

Beispiele​

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

# stop assigning test cases dynamically by the smoke label
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --dynamic \
  --labels smoke \
  --yes
# remove statically assigned test cases
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

# stop assigning test cases dynamically by the smoke label
uip tm testcases remove \
  --test-set-key DEMO:42 \
  --dynamic \
  --labels smoke \
  --yes

Datenform​

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

Bei --dynamic ist Code TestSetRemoveTestCasesDynamic:

{
  "Code": "TestSetRemoveTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression"],
    "Result": "Removed",
    "NotFound": []
  }
}
{
  "Code": "TestSetRemoveTestCasesDynamic",
  "Data": {
    "TestSetKey": "DEMO:42",
    "DynamicLabels": ["regression"],
    "Result": "Removed",
    "NotFound": []
  }
}

DynamicLabels ist die verbleibende Beschriftungsliste. NotFound listet die --labels Werte auf, die nicht für den Testsatz festgelegt wurden, und wird nur angezeigt, wenn Sie --labels übergeben. Result ist einer von:

ErgebnisBedeutung
RemovedEinige Beschriftungen wurden entfernt, andere bleiben erhalten.
ClearedEs bleiben keine Beschriftungen für dynamische Zuweisungen.
UnchangedKeiner der Werte --labels wurde für den Testsatz festgelegt.
NotSetDer Testsatz hat keine dynamische Zuweisung.

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.

uip tm testcases list-steps wird für ältere Skripts immer noch als ausgeblendeter Alias dieses Verbs ausgeführt; steps list ist das dokumentierte Formular.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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
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",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed",
      "ClipboardData": ""
    }
  ]
}
{
  "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",
      "ClipboardData": ""
    }
  ]
}

Die Schritte sind in der Reihenfolge OrderNo aufgeführt.

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

Rufen Sie einen einzelnen Schritt anhand seiner UUID ab.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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
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",
    "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed",
    "ClipboardData": ""
  }
}
{
  "Code": "TestStepGet",
  "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",
    "ClipboardData": ""
  }
}

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​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Erforderlich. Testfall, dem Schritte hinzugefügt werden sollen.
--description <text>Schrittbeschreibung. Erforderlich im 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 mit einem erforderlichen description und optionalen expectedResult, actionType, clipboardData und orderNo. Übergeben Sie mehrere, durch Leerzeichen getrennte oder durch Wiederholen von --step, um mehrere Schritte in der richtigen Reihenfolge hinzuzufügen. Verwenden Sie entweder die Schritt-Flags oder --step, nicht beides.
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":"user@example.com"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'
# 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":"user@example.com"}' \
  --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": ""
      }
    ]
  }
}
{
  "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. Felder, die Sie nicht übergeben, behalten ihre Werte bei. Um die Position eines Schritts zu ändern, verwenden Sie steps move.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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"
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"
  }
}
{
  "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​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--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
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"
  }
}
{
  "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​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--step-id <uuid>Erforderlich. Testschritt-UUID.
-y, --yesErforderlich. Bestätigt die unwiderrufliche Löschung. Die CLI fordert nie auf; Ohne --yes schlägt der Befehl mit Result: "Failure" und Exitcode 1 fehl.
Beispiel​
uip tm testcases steps delete \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --yes
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"
  }
}
{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

Parameter für uip-tm-Testfälle​

testcases parameters ist eine Untergruppe, die die Parameter eines Testfalls verwaltet: Auflisten, Abrufen, Hinzufügen, Aktualisieren und Löschen. Jedes Verb identifiziert den Testfall genau durch --test-case-id oder --test-case-key. Parameternamen sind pro Testfall eindeutig und werden ohne Fall verglichen; Das Hinzufügen oder Umbenennen zu einem bereits vergebenen Namen schlägt fehl.

Liste der Parameter für UIP-TM-Testfälle​

Listen Sie die Parameter eines Testfalls auf.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Testfall-UUID. Sich gegenseitig mit --test-case-key ausschließen.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1). Sich gegenseitig mit --test-case-id ausschließen.
--search <prefix>Nur Parameter, deren Name mit diesem Präfix beginnt.
--sort-by <expression>Ausdruck sortieren, z. B. "name asc".
--limit <number>Anzahl der Ergebnisse pro Seite. Die Standardeinstellung ist 50.
--offset <number>Anzahl der zu überspringenden Ergebnisse. Die Standardeinstellung ist 0.
Beispiel​
uip tm testcases parameters list \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --sort-by "name asc"
uip tm testcases parameters list \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --sort-by "name asc"
Datenform​
{
  "Code": "TestCaseParametersList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000101",
      "Name": "Username",
      "DefaultValue": "admin",
      "Hint": "User name for the test account",
      "Type": "Text",
      "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ObjectType": "testCase",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2025-04-15T10:30:00Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2025-04-15T10:30:00Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ]
}
{
  "Code": "TestCaseParametersList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000101",
      "Name": "Username",
      "DefaultValue": "admin",
      "Hint": "User name for the test account",
      "Type": "Text",
      "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "ObjectType": "testCase",
      "ProjectId": "00000000-0000-0000-0000-000000000abc",
      "Created": "2025-04-15T10:30:00Z",
      "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
      "Updated": "2025-04-15T10:30:00Z",
      "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
    }
  ]
}

Parameter für uip-tm-Testfälle abrufen​

Rufen Sie einen Parameter eines Testfalls nach ID oder Name ab. Übergeben Sie genau eines von --parameter-id oder --parameter-name. Wenn der Testfall keinen solchen Parameter hat, schlägt der Befehl mit ErrorCode: "not_found" fehl.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Testfall-UUID. Sich gegenseitig mit --test-case-key ausschließen.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1). Sich gegenseitig mit --test-case-id ausschließen.
--parameter-id <uuid>Parameter-UUID.
--parameter-name <name>Parametername, abgeglichen ohne Groß-/Kleinschreibung.
Beispiel​
uip tm testcases parameters get \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name username
uip tm testcases parameters get \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name username
Datenform​
{
  "Code": "TestCaseParameterGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}
{
  "Code": "TestCaseParameterGet",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}

Hinzufügen von Parametern für uip-tm-Testfälle​

Fügen Sie einen Parameter zu einem Testfall hinzu.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Testfall-UUID. Sich gegenseitig mit --test-case-key ausschließen.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1). Sich gegenseitig mit --test-case-id ausschließen.
--name <name>Erforderlich. Parametername.
--default-value <value>Erforderlich. Standardwert. Übergeben Sie "" um einen leeren Wert zu speichern.
--hint <text>Hinweis, der neben dem Parameter angezeigt wird.
--type <type>Text Speichert den eingegebenen Wert; Asset speichert einen Orchestrator-Asset-Namen, den der Roboter zur Laufzeit auflöst. Die Standardeinstellung ist Text.
Beispiele​
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Username \
  --default-value admin \
  --hint "User name for the test account"
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Username \
  --default-value admin \
  --hint "User name for the test account"
# the value is the name of an Orchestrator asset
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Credentials \
  --default-value LoginCredentials \
  --type Asset
# the value is the name of an Orchestrator asset
uip tm testcases parameters add \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name Credentials \
  --default-value LoginCredentials \
  --type Asset
Datenform​
{
  "Code": "TestCaseParameterAdd",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}
{
  "Code": "TestCaseParameterAdd",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "Username",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ObjectType": "testCase",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "Created": "2025-04-15T10:30:00Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "Updated": "2025-04-15T10:30:00Z",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003"
  }
}

Aktualisierung der Parameter von uip-tm-Testfällen​

Aktualisieren Sie einen Parameter, der anhand der ID oder des Namens gefunden wird. Übergeben Sie genau eines von --parameter-id oder --parameter-name und mindestens eines von --new-name, --default-value, --hint oder --type. Felder, die Sie nicht übergeben, behalten ihren aktuellen Wert bei; --default-value "" und --hint "" löschen den gespeicherten Wert.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Testfall-UUID. Sich gegenseitig mit --test-case-key ausschließen.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1). Sich gegenseitig mit --test-case-id ausschließen.
--parameter-id <uuid>Parameter-UUID.
--parameter-name <name>Aktueller Parametername, abgeglichen ohne Groß-/Kleinschreibung.
--new-name <name>Benennen Sie den Parameter in diesen um.
--default-value <value>Neuer Standardwert.
--hint <text>Neuer Hinweis.
--type <type>Neuer Parametertyp: Text oder Asset.
Beispiel​
uip tm testcases parameters update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name Username \
  --new-name UserId
uip tm testcases parameters update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-name Username \
  --new-name UserId
Datenform​
{
  "Code": "TestCaseParameterUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "UserId",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001"
  }
}
{
  "Code": "TestCaseParameterUpdate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000101",
    "Name": "UserId",
    "DefaultValue": "admin",
    "Hint": "User name for the test account",
    "Type": "Text",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001"
  }
}

Data gibt die vom Befehl gesendeten Werte wieder, nicht den vollständigen gespeicherten Datensatz. Führen Sie parameters get für den gespeicherten Datensatz aus.

Löschen von UIP-TM-Testfallparametern​

Löschen Sie einen oder mehrere Parameter aus einem Testfall. Führen Sie zuerst parameters list aus, um die IDs zu sammeln.

Argumente​

Keine.

Optionen​
MarkierenBeschreibung
--project-key <key>Test Manager-Projektschlüssel (z. B. DEMO). Wird ignoriert, wenn --project-id auch angegeben ist.
--project-id <id>Test Manager-Projekt-ID. Wird anstelle von --project-key verwendet und gewinnt, wenn beides angegeben ist.
--test-case-id <uuid>Testfall-UUID. Sich gegenseitig mit --test-case-key ausschließen.
--test-case-key <key>Testfallschlüssel (z. B. DEMO:1). Sich gegenseitig mit --test-case-id ausschließen.
--parameter-ids <uuid...>Erforderlich. Zu löschende Parameter-UUIDs, durch Leerzeichen getrennt, bis zu 100 pro Aufruf.
-y, --yesErforderlich. Bestätigt die unwiderrufliche Löschung. Die CLI fordert nie auf; Ohne --yes schlägt der Befehl mit Result: "Failure" und Exitcode 1 fehl.
Beispiel​
uip tm testcases parameters delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-ids a1b2c3d4-0000-0000-0000-000000000101 a1b2c3d4-0000-0000-0000-000000000102 \
  --yes
uip tm testcases parameters delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --parameter-ids a1b2c3d4-0000-0000-0000-000000000101 a1b2c3d4-0000-0000-0000-000000000102 \
  --yes
Datenform​
{
  "Code": "TestCaseParameterDelete",
  "Data": {
    "Passed": 2,
    "Failed": 0
  }
}
{
  "Code": "TestCaseParameterDelete",
  "Data": {
    "Passed": 2,
    "Failed": 0
  }
}

Passed und Failed sind Zählwerte. Die Antwort gibt nicht an, welche ID fehlgeschlagen ist. Führen Sie parameters list aus, um zu sehen, was noch übrig ist.

  • 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.
  • testcaselog – Starten, Beenden und Überprüfen von Testfallprotokollen, einschließlich testcaselog list-assertions.
  • Ausführungen – Ansichten von Testfallprotokollen auf Ausführungsebene.
  • Bericht – Zusammenfassung einer Ausführung mit fehlgeschlagenen Fällen und Assertionstext.
  • requirements – die Anforderungen, auf die sich list-requirements und bulk-create --requirement-key beziehen.
  • export-jobs – überprüfen Sie den Auftrag, der testcases export startet.

Siehe auch​

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben