UIP TM

uip tm es la herramienta Test Manager: gestiona proyectos de prueba, casos de prueba, conjuntos de pruebas, ejecuciones, resultados, informes y archivos adjuntos en un tenant de UiPath Test Manager. Instálalo con uip tools install tm o invoca uip tm … y deja que se ejecute la instalación automática. Consulta Herramientas (complementos) para el modelo de instalación y herramientas uip para el comando que gestiona la instalación de herramientas.

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	Crear, enumerar, actualizar, eliminar proyectos de Test Manager; establecer o borrar la carpeta predeterminada de Orchestrator.
Casos de prueba	Crear, enumerar, actualizar, eliminar casos de prueba; vincular o desvincular automatizaciones de Orchestrator; mostrar el historial de resultados; enumerar conjuntos de pruebas que contienen un caso de prueba; añadir o eliminar casos de prueba de un conjunto de pruebas.
Conjuntos de prueba	Crear, enumerar, actualizar, eliminar conjuntos de pruebas; lista de casos de prueba contenidos; ejecutar un conjunto de pruebas y devolver un ID de ejecución.
Ejecuciones	Enumerar ejecuciones para un conjunto de pruebas; enumerar los registros de casos de prueba para una ejecución; reintentar los casos de prueba fallidos de una ejecución finalizada.
Resultado	Descarga los resultados de una ejecución de prueba como informe JUnit XML.
Informar	Obtenga un informe de resumen (recuentos, tasa de aprobación, duración, casos fallidos) para una ejecución completada.
Archivo adjunto	Descarga los archivos adjuntos (capturas de pantalla, registros, archivos) capturados por los registros de casos de prueba en una ejecución.
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.

tm testcaselogs list-assertions vive en la página de casos de prueba — consulta casos de prueba. Se registra como un subcomando testcaselogs independiente en runtime, pero se documenta con casos de prueba porque lee los artefactos de aserción adjuntos a un registro de casos de prueba.

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 seguido de testcases add.
4. ejecución de conjuntos de pruebas : inicia una ejecución. Devuelve un ExecutionId que cada comando descendente toma como entrada.
5. esperar : bloquea el script hasta que la ejecución alcanza un estado terminal (Passed, Failed, Cancelled). Usa --timeout para limitar la espera.
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.

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.

Autenticación y ámbito

Cada verbo uip tm resuelve el contexto del tenant y del proyecto a través de la sesión activa. Consulta Autenticación para el inicio de sesión; el marcador --tenant / -t en cada verbo anula el valor predeterminado de la sesión para esa llamada. El ámbito del proyecto se resuelve a partir de --project-key (o se deriva de --test-set-key en verbos de nivel de ejecución que aceptan cualquiera de los dos).

Códigos de salida

Los códigos de salida CLI estándar se aplican a cada verbo. Un verbo añade un comportamiento específico del dominio:

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

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.