test-suite

2022.10

false

Importante :

Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática.

Guía de usuario de Test Suite

ENTREGA:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 13 de ago. de 2024

Ejecución de tareas

Ejecutar tareas dentro de la CLI de UiPath diseñadas para dispositivos Windows (UiPath.CLI.Windows) requiere varias tareas.

Las principales diferencias entre los procedimientos para UiPath.CLI.Windows y los procedimientos para UiPath.CLI (UiPath CLI diseñada para dispositivos Linux) consisten en argumentos adicionales que podría pasar con algunas tareas que son específicas del tipo de dispositivo que es funcionando.

Importante:

Al utilizar UiPath CLI, debe asegurarse de que el proyecto esté cerrado en Studio. Si lo hace, se provoca un conflicto que conduce al siguiente mensaje de error en CLI:

The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.

Ámbitos de la aplicación de acceso a la API

La siguiente tabla muestra los ámbitos de aplicación de acceso a la API de Orchestrator necesarios para ejecutar cualquier tarea CLI.

Ámbito de aplicación	Descripción
Activos OR	Acceso de lectura y escritura de activos en Orchestrator.
OR.Tareas	Acceso de lectura y escritura de SecondTasks en Orchestrator.
OR.Ejecución	Acceso de lectura y escritura a la ejecución en Orchestrator.
Carpetas OR	Acceso de lectura y escritura a las carpetas en Orchestrator.
O.Trabajo	Acceso de lectura y escritura a los trabajos en Orchestrator.
OR.Machines.Read	Acceso de lectura a las máquinas en Orchestrator.
OR.Monitorización	Supervisión del acceso de lectura y escritura en Orchestrator.
O.Robots. Leer	Los robots leen en Orchestrator.
OR.Configuración. Leer	Acceso de lectura a la configuración en Orchestrator.
OR.ConjuntosDePrueba	Acceso de lectura y escritura a los ConjutosDePrueba en Orchestrator.
O. Ejecuciones del ConjuntoDePruebas	Acceso de lectura y escritura a las EjecucionesDeConjuntosDePrueba en Orchestrator.
OR.TestSetSchedules	Conjunto de pruebas Programa el acceso de lectura y escritura en Orchestrator.
OR.Usuarios. Leer	Acceso de lectura a los usuarios en Orchestrator.

Además de los ámbitos enumerados en la tabla, un ámbito importante a destacar es OR.Default. El ámbito OR.Default actúa como comodín. Ofrece acceso detallado y específico para cada rol tanto a nivel de organización como de carpeta. Esto te da la flexibilidad de tener un control preciso sobre los permisos de la aplicación, más allá de los ámbitos predefinidos de toda la organización. Para obtener más información, consulta Declaración de ámbitos.

Running UiPath.CLI.Windows

Requisitos previos: para usar la CLI de UiPath para Windows y ejecutar tareas, instala .NET 6.0.7, que debe incluir .NET 6.0.7 Desktop Runtime, que se incluye con el SDK 6.0.302.

Puedes ejecutar tareas llamando auipcli.exe , incluidos los parámetros correspondientes. Para ejecutar subtareas, el comando debe tener el siguiente formato: uipcli.exe <task name> <sub-task name>. Para ejecutar la CLI:

Abra un símbolo del sistema y navegue hasta la carpeta extraída del archivo NUPKG.
Escribe uipcli.exe y selecciona la tecla Intro .

Ejecutar UiPath.CLI

Requisitos previos: para usar la CLI de UiPath para multiplataforma y ejecutar tareas de trabajo, instale .NET 6.0.7, que se incluye con el SDK 6.0.302.

Puedes ejecutar tareas llamando auipcli.exe , incluidos los parámetros correspondientes. Para ejecutar subtareas, el comando debe tener el siguiente formato: dotnet uipcli.dll <task name> <sub-task name>. Para ejecutar la CLI:

Abra un símbolo del sistema y navegue hasta la carpeta extraída del archivo NUPKG.
Tipo dotnet uipcli.dll, y selecciona la clave Enter.

Visualización de la versión de la CLI

Ejecuta el comando uipcli --version.

Eliminar activos de Orchestrator

Prerrequisitos:

Crear activos en Orchestrator.
Crea un archivo CSV que contenga los activos que quieres eliminar. El archivo CSV debe tener las siguientes tres columnas: name, typey value. Las celdas de datos debajo de las columnas typey value pueden permanecer vacías.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Para obtener más información sobre el archivo CSV, consulta los ejemplos de la siguiente tabla:

name	Tipo	valor
asset1_name	`N/A`	`N/A`
asset2_name	Booleano	`true`
asset3_name	Entero	`N/A`
asset4_name	Credencial	username:password

Para eliminar activos de Orchestrator:

Ejecuta la tarea asset , utilizando uipcli asset. Puede ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea delete .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Assets File (pos. 0)` (obligatorio)	El nombre del archivo CSV que contiene los activos que quieres eliminar.
`Orchestrator URL (pos.1)` (obligatorio)	La URL de la instancia de Orchestrator.
`Orchestrator Tenant (pos.2)` (Obligatorio) para implementaciones de SaaP. (Opcional) para implementaciones de PaaS.	El tenant de la instancia de Orchestrator donde quieres administrar tus activos.
`-u,` o `--username` (obligatorio si usa la autenticación básica, a través de 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`-A`o `--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 usa 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 usa 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` (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`-o`o `--organizationUnit`	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`--identityUrl` (requerido solo para implementaciones de PaaS )	La URL de su servidor de identidad.

Ejemplos:

asset eliminar asset_file.csv "https://uipath-orchestrator.myorg.com" predeterminado -u admin -p 123456 -l es
asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization
asset eliminar asset_file.csv "https://uipath-orchestrator.myorg.com" predeterminado -t a7da29a2c93a717110a82 -a myAccount
asset eliminar asset_file.csv "https://uipath-orchestrator.myorg.com" predeterminado -Una cuentaParaAplicaciónExterna -I miIdDeAplicaciónExterna -S miSecretoDeAplicaciónExterna --ÁmbitoDeAplicación "OR.Folders.Read OR.Settings.Read"

Implementar activos en Orchestrator

Prerrequisitos:

Crea un archivo CSV que contenga los activos que quieres implementar en Orchestrator.
El archivo CSV debe tener las siguientes tres columnas: name, type, valuey description.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Para obtener más información acerca del archivo CSV, consulta el ejemplo a continuación.

name	Tipo	valor	Descripción
asset_1_name	text	"tengo un comentario"	asset_1_description
asset_2_name	Entero	`1`	asset_2_description
asset_3_name	Booleano	`false`	asset_3_description
asset_4_name	Credencial	username:password	asset_4_description

Para implementar activos en Orchestrator:

Ejecuta la tarea asset , utilizando uipcli asset. Puede ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea deploy .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Assets File (pos. 0)` (obligatorio)	El nombre del archivo CSV que contiene los activos que quieres eliminar.
`Orchestrator URL (pos.1)` (obligatorio)	La URL de la instancia de Orchestrator.
`Orchestrator Tenant (pos.2)` (Obligatorio) para implementaciones de SaaP. (Opcional) para implementaciones de PaaS.	El tenant de la instancia de Orchestrator, donde quieres gestionar tus activos.
`-u`, o `--username` (necesario cuando 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`-A`o `--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 usa 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 usa 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` (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`-o`o `--organizationUnit`	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`--identityUrl` (requerido solo para implementaciones de PaaS )	La URL de su servidor de identidad.

Ejemplos:

asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US.
asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization.
asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount.
asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".

Ejecutar un trabajo dentro de Orchestrator

Crea un proceso en Orchestrator.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Ejecuta la tarea job, utilizando uipcli job. Ahora puedes ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea run .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Process Name (pos.0)` (obligatorio)	El nombre del proceso que desea ejecutar.
`Orchestrator URL (pos.1)` (obligatorio)	La URL de la instancia de Orchestrator.
`Orchestrator Tenant (pos.2)` : (necesario) para las implementaciones de SaaP. : (opcional) para las implementaciones de PaaS.	El tenant de la instancia de Orchestrator donde quieres ejecutar los procesos.
`-i`o `--input_path` (solo serequiere si el punto de entrada del flujo de trabajo tiene parámetros de entrada)	La ruta completa al archivo de entrada JSON correspondiente al proceso que desea ejecutar. Ejemplo de formato de archivo JSON: `{ "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }`{ "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
`-u`, o `--username` (necesario cuando 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`-I`, o `--applicationID`(necesario cuando 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`(necesario cuando 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` (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`-P`o `--priority`	La prioridad con la que desea ejecutar el trabajo: - Baja. Normal (predeterminado). Alto.
`-r`o `--robots`	Una lista de nombres de robots específicos, separados por comas.
`-j`o `--jobscount`	El número de veces que desea ejecutar el proceso. El número predeterminado de veces que se ejecuta el proceso es una.
`-U`o `--user`	El nombre del usuario. Debe ser un usuario de la máquina, no un usuario de Orchestrator. Para usuarios locales, el formato es NómbreDeMáquina\NombreDeUsuario.
`-M`o `--machine`	El nombre de la máquina en la que desea ejecutar el proceso.
`-R`o `--result_path`	La ruta completa a un archivo JSON o a una carpeta donde quieres almacenar los resultados del trabajo. Los resultados se devuelven como archivos JSON.
`-W`o `--timeout`	El tiempo de espera para las ejecuciones de trabajos (segundos). El valor predeterminado es 1800 segundos.
`-f`o `--fail_when_job_fails`	El comando falla cuando se produce un error en un trabajo. El valor predeterminado es Verdadero.
`-w`o `--wait`	El comando espera a que finalice el trabajo. El valor predeterminado es Verdadero.
`-b`o `--job_type` (solo para carpetas modernas)	El tipo de runtime para el trabajo. Puede elegir: - `Unattended`- `NonProduction`.
`-A`o `--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.
`-o`o `--organizationUnit`	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .

NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -u admin -p 123456 -P High -o MyFolder
NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -t a7da29a2c93a717110a82 -a miCuenta -P High -j 3 -w falso
NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -t a7da29a2c93a717110a82 -a mi cuenta -r robotName -RC: \ Temp \ status.json

Analizar un proyecto

Prerrequisitos:

Crear un proyecto.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Ejecuta la tarea package , utilizando uipcli package. Puede ver una lista de las subtareas disponibles.
Especifica los parámetros necesarios y ejecuta la subtarea analyze .

Consulta la lista de parámetros a continuación.

Nota:

La validación del proyecto no la realizan las tareas Empaquetar o Analizar de la CLI de UiPath.

Leyenda: (*) - opcional, recomendado cuando se utilizan fuentes de paquetes adicionales.

Parámetro	Descripción
`Project(s) Path (pos.0)` (obligatorio)	La ruta del archivo `project.json` o la ruta de la carpeta que contiene varios archivos `project.json` .
`--analyzerTraceLevel`	Elija qué tipos de mensajes generar después de analizar: Desactivado = no mostrar ningún mensaje Error -Advertencia -Info -Detallado.
`-stopOnRuleViolation`	El trabajo falla cuando se incumple cualquier regla.
`--treatWarningsAsErrors`	Tratar las advertencias como errores.
`--resultPath`	La ruta completa a un archivo JSON donde desea almacenar los resultados. Si no agrega esto como argumento, los resultados se imprimirán solo en la consola estándar.
`--ignoredRules`	Una lista de reglas que desea ignorar durante el análisis, separadas por comas.
`--orchestratorUsername` () (necesario* cuando utilizas la Autenticación básica, a través de un nombre de usuario y una contraseña)	El nombre de usuario utilizado para autenticarse en Orchestrator. Debe emparejarlo con la contraseña correspondiente.
`--orchestratorPassword` () (necesario* cuando utilizas la Autenticación básica, a través de un nombre de usuario y una contraseña)	La contraseña utilizada para autenticarse en Orchestrator. Debes emparejarlo con el nombre de usuario correspondiente.
`-orchestratorAuthToken` () (Necesario* si utilizas la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`--orchestratorAccountName` () (Necesario* si utilizas la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`--orchestratorAccountForApp` (*)	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.
`--orchestratorApplicationId` () (necesario* cuando 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**.
`--orchestratorApplicationSecret` () (necesario* cuando 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.
`--orchestratorApplicationScope` () (necesario* cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`--orchestratorFolder` (*)	El nombre de la carpeta de Orchestrator de destino. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .
`--orchestratorUrl` (*)	La URL de la instancia de Orchestrator.
`--orchestratorTenant` (*)	El tenant de la instancia de Orchestrator donde desea eliminar la máquina.
`--help`	Muestra los parámetros y ejemplos de este comando.

Ejemplos:

analizar el paquete "C: \ UiPath \ Project \ project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsError --resultPath "C: \ UiPath \ Project \ output.json"
analizar el paquete "C: \ UiPath \ Project \ project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsError --resultPath "C: \ UiPath \ Project \ output.json" - Reglas ignoradas "ST-NMG-009, ST-DBP-020, UI-USG-011, ST-DBP-020"
analizar el paquete "C: \ UiPath \ Project \ project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsError --resultPath "C: \ UiPath \ Project \ output.json" --Im --orchestratorTenant "default" --orchestratorUsername "username" --orchestratorPassword "\ _ye5zG9 (x" --orchestratorAuthToken "AuthToken" --orchestratorAccountName "AccountName" --orchestratorFolder "OrchestratorFolder"

Eliminar un paquete

Prerrequisitos:

Publicar un paquete en Orchestrator.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Ejecuta la tarea package , utilizando uipcli package. Puede ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea delete .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Package name (pos. 0)` (obligatorio)	El nombre del paquete que desea eliminar.
`Orchestrator URL (pos. 1)`	La URL de la instancia de Orchestrator.
`Orchestrator Tenant (pos. 2)` (Obligatorio) para implementaciones de SaaP. (Opcional) para implementaciones de PaaS.	El tenant de la instancia de Orchestrator donde desea eliminar la máquina.
`-u`, o `--username` (necesario cuando 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`-A`o `--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 usa 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 usa 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` (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`-o`o `--organizationUnit`	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`--identityUrl` (requerido solo para implementaciones de PaaS )	La URL de su servidor de identidad.
`--help`	Muestra los parámetros y ejemplos de este comando.

Ejemplos:

package delete PackageName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US.
package delete PackageName "https://uipath-orchestrator.myorg.com" default -t refreshToken -a accountName.
package delete PackageName "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".

Implementar un paquete en Orchestrator

Prerrequisitos:

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

Ejecuta la tarea package , utilizando uipcli package. Puede ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea deploy .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Package(s) Path (pos. 0)` (obligatorio)	La ruta a un archivo de paquete o la ruta a una carpeta que contiene varios paquetes.
`Orchestrator URL (pos. 1)` (obligatorio)	La URL de la instancia de Orchestrator.
`Tenant de Orchestrator (pos. 2) (Obligatorio) para implementaciones de SaaP. (opcional) para las implementaciones de PaaS.`	El tenant de la instancia de Orchestrator donde desea eliminar la máquina.
`-u`, o `--username` (necesario cuando 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
`-A`o `--accountForApp`	El nombre de la cuenta de Orchestrator CloudRPA (nombre de la organización). Debe 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
`-I`o `--applicationId` (obligatorio si usa 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 usa 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 el Ámbito de la aplicación.
`--applicationScope` (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
`-c`o `--createProcess`	Cuando se establece en `true`, crea un proceso en la carpeta de Orchestrator que se pasa en el comando. El valor predeterminado para esto es Verdadero. Cuando se establece en `false`, no crea un proceso en la carpeta de Orchestrator. Por ejemplo, `--createProcess false.`
`-e`o `--environments` (para carpetas clásicas)	Una lista de entornos en los que quieres implementar el paquete, separados por comas. Si el entorno no pertenece a la carpeta predeterminada (unidad de organización), debe añadir el nombre de la carpeta como prefijo del entorno. Por ejemplo, si el entorno es EntornoDePruebay el nombre de la carpeta es EquipoDeContabilidad, escribe el entorno como EquipoDeContabilidad \ EntornoDePrueba.
`-h`o `--entryPointsPath`	Define los puntos de entrada específicos para crear o actualizar el proceso. Esta es la ruta del archivo del punto de entrada a partir de la raíz del proyecto. Para las carpetas clásicas, solo se puede especificar un punto de entrada para cada entorno.
`-o`o `--organizationUnit`	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam/TeamJohn`usa .
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`--identityUrl` (requerido solo para implementaciones de PaaS )	La URL de su servidor de identidad.
`--help`	Muestra los parámetros y ejemplos de este comando.

El uipcli crea un proceso con un punto de entrada default si no especifica uno. Si se especifica el punto de entrada, se crea un proceso con ese punto de entrada y _{entryPoint} se anexa al nombre del proceso. Además, todos los procesos asociados con package.Id se actualizan a la última versión, independientemente de si el proceso se creó manualmente o desde un proceso.

Ejemplos:

package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US.
package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".
package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US -h EntryPoint1,EntryPoint2.

Empaquetar proyectos en un paquete

Prerrequisitos:

Crear proyectos.
Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).
Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Ejecuta la tarea package , utilizando uipcli package. Puede ver una lista de las subtareas disponibles.
Especifica los parámetros necesarios y ejecuta la subtarea pack .

Consulta la lista de parámetros a continuación.

Nota:

La validación del proyecto no la realizan las tareas Empaquetar o Analizar de la CLI de UiPath.

Leyenda: (*): opcional, útil solo cuando tiene dependencias de una biblioteca en Orchestrator.

Parámetro	Descripción
`Project(s) Path (pos. 0)` (obligatorio)	La ruta a un archivo `project.json` o a una carpeta que contiene archivos `project.json` .
`-o`, o `--output` (necesario)	La carpeta de destino de Orchestrator, donde desea empaquetar los proyectos.
`-v`o `--version`	Establezca la versión del paquete.
`--autoVersion`	Se genera automáticamente una versión del paquete.
`--outputType`	Fuerza la salida a ser de un tipo específico.
`--releaseNotes`	Añadir notas de la versión.
`--libraryOrchestratorUsername` () (necesario* cuando utilizas la Autenticación básica, a través de un nombre de usuario y una contraseña)	El nombre de usuario utilizado para autenticarse en Orchestrator. Debe emparejarlo con la contraseña correspondiente. Esto es necesario si su paquete hace referencia a bibliotecas de la fuente de Orchestrator
`--libraryOrchestratorPassword` () (necesario* cuando utilizas la Autenticación básica, a través de un nombre de usuario y una contraseña)	La contraseña utilizada para autenticarse en Orchestrator. Debes emparejarlo con el nombre de usuario correspondiente. Esto es necesario si su paquete hace referencia a bibliotecas de la fuente de Orchestrator
`--libraryOrchestratorAuthToken` () (Necesario* si utilizas la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente. Esto es necesario si su paquete hace referencia a bibliotecas de la fuente de Orchestrator
`--libraryOrchestratorAccountName` () (Necesario* si utilizas la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente. Esto es necesario si su paquete hace referencia a bibliotecas de la fuente de Orchestrator
`--libraryOrchestratorAccountForApp` (*)	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 Esto es necesario si tu paquete hace referencia a bibliotecas de la fuente de Orchestrator.
`--libraryOrchestratorApplicationId` () (necesario* cuando 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. Esto es necesario si tu paquete hace referencia a bibliotecas de la fuente de Orchestrator.
`--libraryOrchestratorApplicationSecret` () (necesario* cuando 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. Esto es necesario si tu paquete hace referencia a bibliotecas de la fuente de Orchestrator.
`--libraryOrchestratorApplicationScope` () (necesario* cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas. Esto es necesario si tu paquete hace referencia a bibliotecas de la fuente de Orchestrator.
`--libraryOrchestratorFolder` (*)	El nombre de la carpeta de Orchestrator de destino. Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, `AccountingTeam\TeamJohn`usa .
`--libraryOrchestratorUrl` (*)	La URL de la instancia de Orchestrator.
`--libraryOrchestratorTenant` (*)	El tenant de la instancia de Orchestrator donde desea eliminar la máquina.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`--disableBuiltInNugetFeeds`	Deshabilite las fuentes nuget integradas.
`--help`	Muestra los parámetros y ejemplos de este comando.

Ejemplos:

package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" -v 1.0.6820.22047.
package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --autoVersion.
package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --outputType Tests -l en-US.

Probar un paquete / Ejecutar un conjunto de prueba

Prerrequisitos:

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

Ejecuta la tarea test , utilizando uipcli test. Puede ver una lista de las subtareas disponibles.

Especifica los parámetros necesarios y ejecuta la subtarea run .

Consulta la lista de parámetros a continuación.

Parámetro	Descripción
`Orchestrator URL (pos. 0)` (obligatorio)	La URL de la instancia de Orchestrator.
`Orchestrator Tenant (pos. 1)` (Obligatorio) para implementaciones de SaaP. (Opcional) para implementaciones de PaaS.	El tenant en el que se encuentra el paquete o el conjunto de pruebas.
`-u`, o `--username` (necesario cuando 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` (necesario cuando 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 utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
`-a`o `--accountName` (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de 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 usa 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 usa 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` (necesario cuando utilizas la autenticación de aplicación externa)	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
`-P`o `--project-path`	La ruta al archivo del paquete de prueba que desea probar.
`-s`o `--testset`	El nombre mostrado para el conjunto de pruebas que deseas ejecutar. Asegúrate de que el conjunto de pruebas incluye 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 relevante antes. Por ejemplo, `AccountingTeam\TestSet`usa .
`--out`	El tipo de archivo de resultado <junit\|uipath>.
`-r`o `--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 `project path`.
`-w`o `--timeout`	El tiempo (en segundos) que desea esperar para que se ejecute el conjunto de prueba. El valor predeterminado es 7200 segundos.
`-i`o `--input_path` (obligatorio si el flujo de trabajo del punto de entrada tiene parámetros de entrada que desea pasar por la línea de comandos)	La ruta completa a un archivo de entrada json.
`--attachRobotLogs`	Adjunta registros de robot para cada caso de prueba ejecutado y un informe de prueba JUnit.
`-o`o `--organizationUnit`	La carpeta de Orchestrator donde desea ejecutar los conjuntos de prueba.
`-l`o `--language`	El idioma utilizado en la interfaz de usuario de Orchestrator.
`-y`o `--disableTelemetry`	Deshabilitar los datos de telemetría.
`--traceLevel`	Mostrar el seguimiento de los eventos.
`--identityURL` (requerido solo para implementaciones de PaaS)	La URL de su servidor de identidad.
`--releaseNotes`	Añadir notas de la versión.
`--disableBuiltInNugetFeeds`	Deshabilite las fuentes nuget integradas.
`--help`	Muestra los parámetros y ejemplos de este comando.

Ejemplos:

test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
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"
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"
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
test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out junit
test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out uipath