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 haces referencia a un conjunto de pruebas existente desde 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 > Todos los proyectos > Ir al menú de tres puntos del proyecto > Editar > Prefijo.

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 uipcli.dll para Windows/Linux/macOS.

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 selecciona 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 ejecutará 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)	The tenant inside where the Test Manager project is located. Required when targeting Automation Cloud. Optional for Automation Suite and standalone Orchestrator (on-premises MSI), where the tenant is part of the URL.	See description
-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 proyecto no tiene un conjunto de carpetas predeterminado, asegúrate de asignar una carpeta de prueba en el nivel de Conjunto de pruebas.	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 proyecto no tiene un conjunto de carpetas predeterminado, asegúrate de asignar una carpeta de prueba en el nivel de Conjunto de pruebas.	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
--author	El autor del paquete.	No
--nugetConfigFilePath	Ruta al archivo NuGet.Config que contiene las fuentes. La etiqueta <clear /> del archivo especificado se ignorará y solo se tendrán en cuenta las fuentes.	No
--disableBuiltInNugetFeeds	Deshabilitar fuentes NuGet integradas	No
--excludeConfiguredSources	Excludes the built-in feeds and the NuGet sources configured at the user and machine level on the host running the CLI. The CLI resolves packages only from the feeds defined in --nugetConfigFilePath. See Managing NuGet feeds.	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	Opcional para la autenticación de aplicaciones externas. Uso de ámbitos predeterminados si no se especifica lo contrario
-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	The URL of your identity server. Required when the Orchestrator runs on UiPath Automation Suite or standalone Orchestrator (on-premises MSI). Not needed for Automation Cloud — the CLI resolves the identity server from the cloud URL.	No
--ca-cert	Archivo(s) de CA raíz de confianza (PEM, DER o PKCS#7) para el certificado TLS de Orchestrator/Identity. Repetir o separar por comas. Consulta Confiar en certificados personalizados.	No
--pinnedpubkey	Anclar la clave pública hoja (sha256//<base64>). Consulta Confiar en certificados personalizados.	No

Consejo:

Para las instancias de Orchestrator firmadas por una autoridad de certificación privada (como UiPath Automation Suite), este comando también acepta los parámetros --ca-cert y --pinnedpubkey . Consulta Confiar en certificados personalizados para escenarios y ejemplos.

Nota: Ámbitos de aplicación predeterminados para pruebas

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --applicationScope , la CLI aplica automáticamente estos ámbitos predeterminados de Test Manager:

TM.Projects TM.TestSets TM.TestExecutions

Además de los ámbitos OR predeterminados:

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" `
  -o "FolderName" `
  --out "junit" `
  --result_path "C:\TestResults"
  --author ExampleAuthor

# Linux/macOS
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" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"
  --author ExampleAuthor

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" \
  -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" \
  -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" \
  -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" \
  -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

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