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 es el prefijo del comando, nunca uip test-manager. Utilice la columna commandPrefix de uip tools list para confirmar.

Recursos

Cada recurso tiene su propia página de referencia. El verbo establecido en cada página coincide con los comandos registrados por uip tm — ejecuta uip tm --help para confirmar la superficie completa en tu instalación.

Recurso	Propósito
Proyecto	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.
permisos del proyecto	Read the permissions you hold on a Test Manager project.
Migración	Inspect and download the migration jobs behind project export and project import, and list or download migration schemas.
Casos de prueba	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.
Paquete	Empaqueta un proyecto de prueba externo de Playwright en un paquete de automatización .nupkg, creando automáticamente y vinculando opcionalmente sus casos de prueba.
Conjuntos de prueba	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.
Iniciar	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.
Programaciones	Create, list, update, enable, disable, and delete recurring test set schedules; list upcoming runs.
Ejecuciones	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.
Registro de casos de prueba	Start, finish, list, get, cancel, and assign test case logs; override a result; read assertions and robot logs.
registro de pasos de prueba	Enumera el registro de ejecución a nivel de paso para un registro de caso de prueba manual o mixto.
Esperar	Sondear una ejecución de prueba hasta que alcance un estado terminal; devuelve un código de salida distinto de cero en el tiempo de espera.
Resultado	Descarga los resultados de una ejecución de prueba como informe JUnit XML.
Informar	Get a summary report (counts, pass rate, duration, failed cases) for a completed execution; export an execution report file.
exportar-trabajos	Check the asynchronous file export jobs that testcases export and report export start.
Archivo adjunto	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.
Requisitos	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.
Solicitudes	List, get, and create entries in the project prompt library that steers AI test generation and evaluation.
Campo personalizado	Gestione las definiciones de campos personalizados, sus etiquetas de visualización y los valores permitidos.
EtiquetaDeObjeto	Add, remove, get, and list labels on Test Manager objects.
Usuario	Obtenga información de perfil para el usuario de Test Manager actualmente autenticado.
escenario de rendimiento	Create, run, and delete performance scenarios (dry run or full load test); check performance testing licenses; see also load-groups, execution data, and report.

Sinopsis

uip tm <resource> <verb> [options]

La salida predeterminada es --output json. Todos los verbos uip tm respetan las cuatro opciones globales (--output, --output-filter, --log-level, --log-file).

Flujo típico

Los recursos de Test Manager forman una cadena. Una ejecución de CI completa normalmente la recorre de principio a fin:

1. proyecto : configuración única. Crea el proyecto (o reutiliza uno existente) y, opcionalmente, ancla una carpeta predeterminada de Orchestrator para que los comandos posteriores puedan omitir --folder-key.
2. casos de prueba : crea casos de prueba y vincula cada uno a un punto de entrada del paquete de Orchestrator con testcases link-automation. Este es el paso que los hace ejecutables.
3. conjuntos de pruebas : agrupa los casos de prueba en una suite ejecutable con testsets create.
4. ejecución de conjuntos de pruebas : inicia una ejecución. Devuelve un ExecutionId que cada comando descendente toma como entrada.
5. wait — block the script until the execution reaches a terminal state (Finished or Cancelled). Use --timeout to cap the wait.
6. informe/resultado/archivo adjunto : después de la ejecución: un resumen estructurado (report get), un archivo JUnit XML para paneles de prueba de CI (result download) y cualquier artefacto capturado (attachment download).
7. reintento de ejecuciones — opcional: si la ejecución tuvo fallos que pueden ser escamosos, vuelve a ejecutar solo los registros de casos de prueba fallidos en su lugar.

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.

El mismo flujo funciona ad-hoc en un terminal: cada verbo imprime un sobre JSON autónomo con los ID que necesita el siguiente paso.

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.

Autenticación y ámbito

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.

Códigos de salida

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

• uip tm testsets run seguido de uip tm wait — consulta Códigos de salida en ejecución. wait sale de 2 en el tiempo de espera, por lo que un script puede ramificarse en el tiempo de espera frente a finalizar con fallos frente a paso limpio sin analizar JSON. La detección de fallos de prueba en sí se produce a través de report get o result download, no a través del código de salida del comando de ejecución.
• 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.

Ver también

• Conceptos: cómo se organiza UiPath CLI
• Sesiones : cómo se resuelven el contexto del tenant y del proyecto.
• Patrones de scripting : ramificación de código de salida y filtrado JSON para CI.
• Formatos de salida : sobre JSON y --output-filter.