UIP-TM

Manage Test Manager projects, test cases, test sets, executions, schedules, defects, requirements, custom fields, labels, results, and attachments using the `uip tm` tool.

uip tm is the Test Manager tool: it manages test projects, test cases, test sets, executions, schedules, defects, requirements, results, reports, and attachments on a UiPath Test Manager tenant. Install it with uip tools install tm, or invoke uip tm … and let auto-install run. See Tools (plugins) for the install model and uip tools for the command that manages tool installation.

tm ist das Befehlspräfix – niemals uip test-manager. Verwenden Sie die commandPrefix Spalte aus uip tools list zum Bestätigen.

Ressourcen

Jede Ressource hat eine eigene Referenzseite. Das auf jeder Seite festgelegte Verb stimmt mit den von uip tm registrierten Befehlen überein – führen Sie uip tm --help aus, um die vollständige Oberfläche Ihrer Installation zu bestätigen.

Ressource	Zweck
Projekt	Create, list, update, delete Test Manager projects; get or set the tenant default project; set or clear the default Orchestrator folder; list owners; read and update project settings; export and import a project.
Projektberechtigungen	Read the permissions you hold on a Test Manager project.
Migration	Inspect and download the migration jobs behind project export and project import, and list or download migration schemas.
Testfälle	Create, bulk-create, clone, list, get, update, delete, and export test cases; manage manual test steps and parameters; link or unlink Orchestrator automations; assign test cases to test sets statically or dynamically by label; list result history, test sets, requirements, packages, and Studio projects for a test case.
Packen	Verpacken Sie ein externes Playwright-Testprojekt in ein .nupkg -Automatisierungspaket und erstellen Sie optional seine Testfälle automatisch.
Testsätze	Create, clone, list, get, update, delete test sets; list contained test cases and dynamic assignments; set execution order, execution target, folder, and robot; read and update settings; assign a user; run a test set and return an execution ID.
Ausführen	Run every test in a package already uploaded to Orchestrator, wait for the results, and write a report; exits non-zero when a test fails.
Zeitpläne	Create, list, update, enable, disable, and delete recurring test set schedules; list upcoming runs.
Ausführungen	List and filter executions; re-run an existing execution; retry the failed test cases of a finished execution; finish, cancel, delete, and export executions; set the reporting date; get aggregated stats.
Testfallprotokoll	Start, finish, list, get, cancel, and assign test case logs; override a result; read assertions and robot logs.
Testschrittprotokoll	Listen Sie das Ausführungsprotokoll auf Schrittebene für ein manuelles oder gemischtes Testfallprotokoll auf.
Warten	Eine Testausführung abrufen, bis sie einen Endzustand erreicht; Gibt bei einer Zeitüberschreitung einen Exitcode ungleich Null zurück.
Ergebnis	Laden Sie die Ergebnisse einer Testausführung als JUnit-XML-Bericht herunter.
Melden	Get a summary report (counts, pass rate, duration, failed cases) for a completed execution; export an execution report file.
Exportaufträge	Check the asynchronous file export jobs that testcases export and report export start.
Anhang	Upload, list, get, update, delete, and download attachments (screenshots, logs, files) on Test Manager objects.
Defects	Create, list, get, update, and delete defects raised from failed test results; read related objects, the linked external issue, and defect attachments.
Anforderungen	Create, list, get, update, delete, and export requirements; manage test case links; generate test cases from a requirement, evaluate requirements, and find obsolete test cases with AI.
Aufforderungen	List, get, and create entries in the project prompt library that steers AI test generation and evaluation.
benutzerdefiniertes Feld	Verwalten Sie benutzerdefinierte Felddefinitionen, deren Anzeigebeschriftungen und zulässige Werte.
Objektbeschriftung	Add, remove, get, and list labels on Test Manager objects.
Benutzer	Rufen Sie Profilinformationen für den aktuell authentifizierten Test Manager-Benutzer ab.
perf-szenario	Create, run, and delete performance scenarios (dry run or full load test); check performance testing licenses; see also load-groups, execution data, and report.

Zusammenfassung

uip tm <resource> <verb> [options]

Die Standardausgabe ist --output json. Alle uip tm -Verben berücksichtigen die vier globalen Optionen (--output, --output-filter, --log-level, --log-file).

Typischer Fluss

Test Manager-Ressourcen bilden eine Kette. Eine vollständige CI-Ausführung durchläuft sie normalerweise von Anfang bis Ende:

1. Projekt – einmalige Einrichtung. Erstellen Sie das Projekt (oder verwenden Sie ein vorhandenes wieder) und heften Sie optional einen standardmäßigen Orchestrator-Ordner an, damit spätere Befehle --folder-key weglassen können.
2. Testfälle – Erstellen Sie Testfälle und verknüpfen Sie jeden mit einem Orchestrator-Paket-Einstiegspunkt mit testcases link-automation. Das ist der Schritt, der sie ausführbar macht.
3. testsets – gruppieren Sie Testfälle in einer ausführbaren Suite mit testsets create.
4. Testsätze ausgeführt – Starten Sie eine Ausführung. Gibt ein ExecutionId zurück, das jeder nachgelagerte Befehl als Eingabe verwendet.
5. wait — block the script until the execution reaches a terminal state (Finished or Cancelled). Use --timeout to cap the wait.
6. Bericht/Ergebnis/Anhang – nach der Ausführung: eine strukturierte Zusammenfassung (report get), eine JUnit-XML-Datei für CI-Testdashboards (result download) und alle erfassten Artefakte (attachment download).
7. Ausführungswiederholung – optional: Wenn die Ausführung Fehler aufwies, die fehlerhaft sein können, führen Sie nur die fehlgeschlagenen Testfallprotokolle erneut aus.

For manual or mixed runs, the extended flow adds: testcaselog start / finish — mark individual test case logs as started and finished; and teststeplog list — retrieve step-level pass/fail detail. requirements links test cases to requirements for traceability reporting, defects tracks bugs raised from failed results, and objectlabel / customfield provide metadata management across all entity types.

For an existing Playwright test project, pack collapses steps 2 and 3 into one command: pointing it at the project root with --project-key packages the suite and auto-creates and auto-links matching test cases in a single call. A Playwright test case that pack created and linked must never be linked again with testcases link-automation — see pack.

For a package already uploaded to Orchestrator, run collapses steps 2 through 6 into one command: uip tm run --type package runs every test case in the package, waits, writes a report, and exits non-zero when a test fails — see run. To run a test set on a recurring cadence instead of from a pipeline, create a schedule — see schedules.

Der gleiche Ablauf funktioniert spontan an einem Terminal: Jedes Verb gibt einen in sich geschlossenen JSON-Umschlag mit den IDs aus, die der nächste Schritt benötigt.

Run without a project

If you run tests without specifying a project, Test Manager stores the results in the default project of your tenant. For more information, refer to Default project for execution results.

Authentifizierung und Scope

Every uip tm verb resolves tenant and project context through the active session. Refer to Authentication for sign-in. Project-scoped verbs take --project-id or --project-key. When you pass both, --project-id is used. Verbs that take an object key such as --test-set-key DEMO:42 can also derive the project from the key's prefix.

Exitcodes

Standard CLI exit codes apply to every verb. Two verbs add domain-specific behavior:

• uip tm testsets run gefolgt von uip tm wait – siehe Exitcodes bei der Ausführung. wait beendet 2 bei einer Zeitüberschreitung, sodass ein Skript bei einer Zeitüberschreitung entweder mit „Fertig stellen mit Fehlern“ oder mit einem sauberen Durchlauf ohne Parsen der JSON verzweigen kann. Die Erkennung von Testfehlern selbst erfolgt über report get oder result download, nicht über den Exitcode des Ausführungsbefehls.
• uip tm run — exits 1 when a test fails or reports no result, no test runs, or the run is cancelled, and 4 when --timeout elapses. See run.

Siehe auch

• Konzepte: So ist die UiPath CLI organisiert
• Sitzungen – wie Mandanten- und Projektkontext aufgelöst werden.
• Skriptmuster – Exit-Code-Verzweigung und JSON-Filterung für CI.
• Ausgabeformate – JSON-Umschlag und --output-filter.