Probar un paquete o ejecutar un conjunto de pruebas

Prerequisites:

• Crea un paquete o un conjunto de pruebas.
• Ejecuta el archivo CLI exe (para Windows Legacy) o dll (para Windows/Linux/macOS).
• Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Para probar un paquete, sigue los siguientes pasos:

1. Ejecuta la tarea test , utilizando uipcli test. Puedes ver una lista de las subtareas disponibles.
2. Especifica los parámetros necesarios y ejecuta la subtarea run . La siguiente tabla describe los parámetros necesarios:

Parámetro	Descripción
Orchestrator URL (pos. 0) ( Obligatorio )	La URL de la instancia de Orchestrator.
Orchestrator Tenant (pos. 1)	The tenant inside which the package, or Test Set are. Required when targeting Automation Cloud. Optional for Automation Suite and standalone Orchestrator (on-premises MSI), where the tenant is part of the URL.
-P , or --project-path	La ruta al archivo del paquete de prueba que desea probar.
-s , or --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.
--out	El tipo del archivo de resultados \<junit|uipath\>.
-r , or --result_path	La ruta de destino del archivo donde quieres almacenar los resultados.
-e o --environment ( Obligatorio para las carpetas clásicas)	El entorno en el que desea implementar el paquete. Debes emparejarlo con el project path .
-w , or --timeout	El tiempo (en segundos) que desea esperar para que se ejecute el conjunto de pruebas. El valor predeterminado es 7200 segundos .
-i , o --input_path ( Obligatorio si el flujo de trabajo de punto de entrada tiene parámetros de entrada que deseas pasar a través de la línea de comandos)	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.
--attachRobotLogs	Adjunta registros de robot para cada caso de prueba ejecutado y un informe de prueba JUnit.
--repositoryUrl	La URL del repositorio donde se versiona el proyecto.
--repositoryCommit	La confirmación del repositorio desde la que se creó el proyecto.
--repositoryBranch	La rama del repositorio desde la que se creó el proyecto.
--repositoryType	Tipo de repositorio del sistema VCS.
--projectUrl	URL de la idea de Automation Hub.
--releaseNotes	Añadir notas de la versión.
--author	El autor del paquete.
--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.
--disableBuiltInNugetFeeds	Deshabilitar las fuentes nuget integradas.
--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.
--retryCount	Número de reintentos para casos de prueba fallidos (de forma predeterminada, no se establece ningún reintento).
-u o --username ( obligatorio si utilizas la autenticación básica , mediante un nombre de usuario y una contraseña)	El nombre de usuario utilizado para autenticarse en Orchestrator. Debe emparejarlo con la contraseña correspondiente.
-p o --password ( obligatorio si utilizas la autenticación básica , mediante un nombre de usuario y una contraseña)	La contraseña utilizada para autenticarse en Orchestrator. Debes emparejarlo con el nombre de usuario correspondiente.
-t o --token ( Obligatorio si utilizas la autenticación basada en tokens )	El token de actualización OAuth2 utilizado para autenticarse en Orchestrator. Debes emparejarlo con el Nombre de cuenta y el ID de cliente .
-a o --accountName ( Obligatorio si utilizas la autenticación basada en tokens )	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización OAuth2 y el ID de cliente .
-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 aplicaciones externas.
-I o --applicationId ( Obligatorio si utilizas la autenticación de aplicación externa )	El ID de aplicación externo. Debes emparejarlo con la Cuenta de la aplicación, el Secreto de la aplicación y el Ámbito de la aplicación.
-S o --applicationSecret ( Obligatorio si utilizas la autenticación de aplicación externa )	El Secreto de la aplicación externo. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y Ámbito de la aplicación.
--applicationScope ( Opcional para la autenticación de aplicaciones externas )	La lista de ámbitos de aplicación, separados por espacios individuales. Opcional cuando se utiliza la autenticación de aplicaciones externas, ya que los ámbitos predeterminados se aplican automáticamente. Debe 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
-o , or --organizationUnit	La carpeta de Orchestrator donde desea ejecutar los conjuntos de prueba.
-l , or --language	El idioma utilizado en la interfaz de usuario de Orchestrator.
--traceLevel	Mostrar el seguimiento de los eventos.
--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.
--ca-cert	Uno o más archivos de certificado de CA raíz de confianza (PEM, DER o PKCS#7) utilizados al validar los certificados TLS de Orchestrator e Identity Server. Repite el marcador o separa con comas varias rutas. Consulta Confiar en certificados personalizados para obtener más detalles.
--pinnedpubkey	Anclar la clave pública del certificado de hoja del servidor. Formato: sha256//<base64>. Se comprueba además de la validación de certificados estándar. Consulta Confiar en certificados personalizados para obtener más detalles.

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

Para las operaciones de Test Manager, consulta Probar un paquete o ejecutar un conjunto de pruebas en Test Manager que utiliza diferentes ámbitos predeterminados.

Uso:**

uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Ejemplos:

• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --author ExampleAuthor