Probar un paquete o ejecutar un conjunto de pruebas en Test Manager

Probar un paquete o ejecutar un conjunto de pruebas en Test Manager

Requisitos previos

1. Utiliza la última versión de Test Manager (Test Manager 2.2510 o superior para la entrega de Automation Suite o Test Manager 25.10 o superior para la instalación independiente).

2. Si ya tienes un conjunto de pruebas ejecutándose en Orchestrator, importa el conjunto de pruebas a Test Manager. Para obtener más información, consulta Test Manager: importar conjuntos de pruebas de Orchestrator. Obtenga la clave del conjunto de pruebas después de la importación.

3. Crea un proyecto en Test Manager y obtén la clave del proyecto. Obtén la clave del proyecto en Test Manager > pestaña Panel > Proyectos > Todos los proyectos.

4. Crea un paquete o un conjunto de pruebas con casos de prueba automatizados. Obtenga la clave del conjunto de pruebas de Test Manager > pestaña Conjuntos de pruebas > columna Clave.

5. Obtén el IDDeCliente y el SecretoDeCliente. Para obtener más información sobre cómo obtener el IDDeCliente y el SecretoDeCliente, consulta la sección Registrar una aplicación externa del tema Integraciones CI/CD - Ejecutar tareas CLI de UiPath .

6. Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).

7. Añade los ámbitos de aplicación de acceso a la API de Test Manager necesarios. Para obtener más información sobre los ámbitos de Test Manager, consulta el tema Integraciones CI/CD: ejecución de tareas CLI de UiPath .

Uso de Test Manager con CLI

Para probar un paquete utilizando Test Manager, sigue los siguientes pasos: Ejecuta la tarea de prueba, utilizando la prueba uipcli. Puedes ver una lista de subtareas disponibles. Especifica los parámetros necesarios y ejecuta la subtarea de ejecución.

Para utilizar Test Manager en lugar de las pruebas de Orchestrator, especifica el parámetro --projectKey en el comando test run . La CLI enrutará automáticamente tus pruebas a través de Test Manager.

Parámetros del comando de prueba

Parámetro	Descripción	Obligatorio
Orchestrator URL (pos. 0)	La URL de la instancia de Orchestrator	Sí
Orchestrator Tenant (pos. 1)	El tenant dentro del cual se encuentran el paquete o el conjunto de pruebas	Obligatorio para las implementaciones de SaaS, Opcional para las implementaciones de PaaS
-P, --project-path	La ruta al archivo del paquete de prueba que desea probar	No
--projectKey	La clave del proyecto mostrada en Test Manager > pestaña Panel > Proyectos > Todos los proyectos. La clave del proyecto es el prefijo para todas las claves de objeto.	Sí (para Test Manager)
--testsetkey	La clave del conjunto de pruebas mostrada en Test Manager Test Manager > pestaña Conjuntos de pruebas > columna Clave. Asegúrese de que el conjunto de pruebas incluya la versión más reciente de los casos de prueba. Si el conjunto de pruebas no está en la carpeta predeterminada, asegúrate de incluir el nombre de la carpeta correspondiente antes. Por ejemplo, utiliza AccountingTeam\TestSet.	No
-s, --testset	El nombre que se muestra para el conjunto de pruebas que desea ejecutar. Asegúrese de que el conjunto de pruebas incluya la versión más reciente de los casos de prueba. Si el conjunto de pruebas no está en la carpeta predeterminada, asegúrate de incluir el nombre de la carpeta correspondiente antes. Por ejemplo, utiliza AccountingTeam\TestSet	No
--out	El tipo de archivo de resultado (junit o uipath)	No
-r, --result_path	La ruta de destino del archivo donde desea almacenar los resultados	No
-e, --environment	El entorno en el que desea implementar el paquete. Debes emparejarlo con el project path	Obligatorio para las carpetas clásicas
-w, --timeout	El tiempo (en segundos) que desea esperar para que se ejecute el conjunto de pruebas. El valor predeterminado es 7200 segundos	No
-i, --input_path	La ruta completa a un archivo de entrada JSON. Consulta Formato JSON de parámetros de entrada para obtener más información sobre la estructura de archivos.	Obligatorio si el flujo de trabajo de punto de entrada tiene parámetros de entrada
--attachRobotLogs	Adjunta registros de robot para cada caso de prueba ejecutado y un informe de prueba JUnit	No
--repositoryUrl	La URL del repositorio donde se versiona el proyecto	No
--repositoryCommit	La confirmación del repositorio desde la que se creó el proyecto	No
--repositoryBranch	La rama del repositorio desde la que se creó el proyecto	No
--repositoryType	Tipo de repositorio del sistema VCS	No
--projectUrl	URL de la idea de Automation Hub	No
--releaseNotes	Añadir notas de versión	No
--disableBuiltInNugetFeeds	Deshabilitar fuentes NuGet integradas	No
--retryCount	Número de reintentos para casos de prueba fallidos (de forma predeterminada, no se establece ningún reintento)	No
-u, --username	El nombre de usuario utilizado para autenticarse en Orchestrator. Debes emparejarlo con la contraseña correspondiente	Requerido para la autenticación básica
-p, --password	La contraseña utilizada para autenticarse en Orchestrator. Debes emparejarlo con el nombre de usuario correspondiente	Requerido para la autenticación básica
-t, --token	El token de actualización OAuth2 utilizado para autenticarse en Orchestrator. Debes emparejarlo con el nombre de la cuenta y el ID de cliente	Obligatorio para la autenticación basada en tokens
-a, --accountName	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización OAuth2 y el ID de cliente	Obligatorio para la autenticación basada en tokens
-A, --accountForApp	El nombre de la cuenta de Orchestrator CloudRPA (nombre de la organización). Debes emparejarlo con el ID de la aplicación, el Secreto de la aplicación y el Ámbito de la aplicación para la aplicación externa	No
-I, --applicationId	El ID de la aplicación externa. Debes emparejarlo con la cuenta de la aplicación, el secreto de la aplicación y el ámbito de la aplicación	Obligatorio para la autenticación de aplicaciones externas
-S, --applicationSecret	El secreto de la aplicación externa. Debes emparejarlo con la cuenta de la aplicación, el ID de la aplicación y el ámbito de la aplicación	Obligatorio para la autenticación de aplicaciones externas
--applicationScope	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, el ID de la aplicación y el Secreto de la aplicación para la aplicación externa	Obligatorio para la autenticación de aplicaciones externas
-o, --organizationUnit	La carpeta de Orchestrator donde desea ejecutar los conjuntos de pruebas	No
-l, --language	El idioma utilizado en la interfaz de usuario de Orchestrator	No
--traceLevel	Mostrar el seguimiento de los eventos	No
--identityURL	La URL de su servidor de identidad	Obligatorio para implementaciones de PaaS o MSI

Nota: Ámbitos de aplicación necesarios para Test Manager

Al utilizar Test Manager, debes incluir los siguientes ámbitos en el parámetro --applicationScope :

TM.Projects TM.TestSets TM.TestExecutions

Además de los ámbitos de Orchestrator:

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Ejemplos de uso

Ejecuta un conjunto de pruebas existente en Test Manager:

# Windows
uipcli test run "https://cloud.uipath.com/" "TenantName" `
  --projectKey "MyTestProject" `
  --testsetkey "MyTestSet" `
  -A "organizationName" `
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" `
  -S "********" `
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" `
  -o "FolderName" `
  --out "junit" `
  --result_path "C:\TestResults"

# Linux
uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S "********" \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"

Crea y ejecuta un conjunto de pruebas transitorio desde un proyecto:

Los conjuntos de pruebas transitorios son conjuntos de pruebas temporales creados sobre la marcha desde la ruta de tu proyecto.

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  -P "./MyTestProject/project.json" \
  -e "TestEnvironment" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S "********" \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" \
  -o "FolderName" \
  --out "uipath" \
  --result_path "./test-results"

Ejecutar pruebas con anulaciones de parámetros:

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -i "./test-parameters.json" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S "********" \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"

Ejecutar pruebas con archivos adjuntos de registros de robot:

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  --attachRobotLogs true \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S "********" \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"

Tipos de informes

Test Manager admite dos formatos de salida:

Formato	Descripción	Caso de uso
junit	Formato XML JUnit	Integración de CI/CD (Jenkins, Azure DevOps, GitHub Actions)
uipath	Formato nativo de UiPath	Informes de ejecución detallados con datos específicos de Test Manager

Migración desde las pruebas de Orchestrator

Antes (pruebas de Orchestrator):

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  -s "MyTestSet" \
  -u "username" \
  -p "password" \
  -o "FolderName" \
  -P "./project.json"

Después (Test Manager):

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S "********" \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./results"

Diferencias clave:

1. Añadir el parámetro --projectKey para habilitar Test Manager
2. Utilice --testsetkey en lugar de -s para la identificación del conjunto de pruebas
3. Test Manager requiere autenticación OAuth (credenciales de aplicación)
4. Especifique el formato de salida con --out y el destino con --result_path
5. Incluir ámbitos de Test Manager en --applicationScope

Mejores prácticas

Configuración de Test Manager:

• Cree proyectos de Test Manager dedicados para diferentes aplicaciones o equipos
• Utilice claves de proyecto significativas y claves de conjunto de pruebas para una fácil identificación
• Organizar conjuntos de pruebas por propósito (regresión, humo, integración, etc.)

Gestión de parámetros:

• Utilizar archivos de parámetros (-i) para configuraciones específicas del entorno
• Almacene los parámetros confidenciales en secretos de CI/CD, no en archivos de parámetros
• Documente los parámetros necesarios en las descripciones de su conjunto de pruebas

Lógica de reintento:

• Utilice --retryCount para pruebas escamosas que pueden fallar de forma intermitente
• Establezca valores --timeout adecuados en función de la duración de la prueba
• Supervise los patrones de reintento para identificar y corregir pruebas inestables

Informes:

• Utilice el formato junit para la integración del proceso CI/CD
• Utilice el formato uipath para el análisis detallado en Test Manager
• Habilitar --attachRobotLogs para depurar fallos de prueba

Integración de CI/CD:

• Configurar la autenticación de Test Manager utilizando variables de entorno seguras
• Configurar la ejecución de pruebas automatizadas en confirmaciones de código o solicitudes de extracción
• Archivar informes de prueba como artefactos de compilación para el seguimiento histórico