Solución de problemas de la CLI de UiPath

Si tienes problemas al utilizar la CLI de UiPath, considera los siguientes escenarios de solución de problemas.

Problemas relacionados con la versión .NET

Descripción:

Puedes encontrar problemas con las tareas de UiPath CLI y las operaciones de proceso si la versión correcta del marco .NET no está instalada (o falta) en tu sistema.

Cuando se produce este problema, puedes encontrarte con mensajes de error como:

• You must install or update .NET to run this application.App: C:\Program Files (x86)\UiPath CLI\UiPath.CLI.Windows.23.10.8894.39673\tools\uipcli.exeArchitecture: x64Framework: 'Microsoft.NETCore.App', version '6.0.0' (x64).NET location: C:\Program Files\dotnetThe following frameworks were found:8.0.5 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]8.0.8 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]

• An error occurred trying to start process 'dotnet' with working directory 'C:\Users\Public\UiPathDevOpsScripts\uipathcli-23.10\tools'. The system cannot find the file specified. Failed to run the command. UiPath.CommandLine.Exceptions.CommandException: Packaging failed due to one or more errors.Message: An error occurred trying to start process 'dotnet' with working directory 'C:\Users\Public\UiPathDevOpsScripts\uipathcli-23.10\tools'. The system cannot find the file specified.Error at: System.Diagnostics.Process.StartWithCreateProcess(ProcessStartInfo startInfo)

Remedy:

Debes asegurarte de tener instalada la versión correcta de .NET.

Para obtener la matriz de compatibilidad de la CLI y la versión .NET , consulta la sección Requisitos previos .

Ejecutar versiones anteriores de CLI en agentes CI/CD actualizados

Los entornos CI/CD alojados como Azure DevOps, GitHub Actions y GitLab Runners actualizan periódicamente sus imágenes de agente de compilación y eliminan los tiempos de ejecución .NET más antiguos que han llegado al final de su vida útil.

Si tu proceso utiliza una versión de CLI más antigua y el agente ya no proporciona el tiempo de ejecución .NET exacto para el que se creó la versión de CLI, CLI puede no iniciarse con un error como:

The framework 'Microsoft.NETCore.App', version 'X.0.0' was not found.

Esto no indica un problema del producto con UiPath CLI, sino más bien una falta de coincidencia en el tiempo de ejecución entre la compilación CLI y el entorno donde se ejecuta.

Resolución:

Para restaurar la compatibilidad, añade una política de avance en el archivo uipcli.runtimeconfig.json ubicado junto a uipcli.exe. Esto permite que la CLI se ejecute en tiempos de ejecución .NET más nuevos para los que se creó originalmente.

Localiza la versión del marco de destino para la que se creó tu CLI (comprueba el mensaje de error o el archivo uipcli.runtimeconfig.json existente si está presente) y luego crea o modifica el archivo de la siguiente manera:

{  "runtimeOptions": {    "tfm": "netX.0",    "framework": {      "name": "Microsoft.NETCore.App",      "version": "X.0.0",      "rollForward": "LatestMajor"    }  }}

Reemplaza X.0 con la versión del marco de destino (p. ej., net6.0, net8.0) y X.0.0 con la versión del runtime (p. ej., 6.0.0, 8.0.0).

La configuración "rollForward": "LatestMajor" permite a la CLI utilizar cualquier tiempo de ejecución .NET más reciente disponible en el agente.

Si tu entorno utiliza una ruta de instalación .NET personalizada, consulta la guía anterior sobre la configuración de DOTNET_ROOT y la verificación de la ubicación del runtime.

Problemas relacionados con el carácter especial en las contraseñas de la cadena de conexión

En la mayoría de los casos, las contraseñas de conexión se encapsulan entre comillas simples ('). Sin embargo, cuando la contraseña incluye caracteres especiales como ` o $, se requiere un enfoque diferente.

En estos casos, la contraseña debe formatearse como \`"<password>\`", reemplazando <password> por la contraseña real. Además, también debes cumplir las reglas de escape como se detalla en la siguiente tabla:

Formato original en ADUC	Formato de escape en la cadena PowerShell
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

Ejemplo:

Supongamos que la contraseña original es 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Al adherirse a las reglas de escape de caracteres especiales, se convierte en: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".