Solução de problemas do UiPath CLI

Se você encontrar problemas ao usar o UiPath CLI, considere os seguintes cenários para a solução dos problemas.

Problemas relacionados à versão .NET

Descrição:

Você pode encontrar problemas com as tarefas do UiPath CLI e operações de pipeline se a versão correta da estrutura .NET não estiver instalada (ou ausente) no seu sistema.

Quando esse problema ocorre, você pode encontrar mensagens de erro 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:

Você deve se certificar de ter a versão correta do .NET instalada.

Para a matriz de compatibilidade de versões de CLI e .NET , consulte a seção Pré-requisitos .

Execução de versões de CLI mais antigas em agentes de CI/CD atualizados

Ambientes de CI/CD hospedados, como Azure DevOps, GitHub Actions e GitLab Runners, atualizam periodicamente suas imagens de agentes de compilação e removem runtimes .NET mais antigos que atingiram o fim da vida útil.

Se seu pipeline usar uma versão de CLI mais antiga e o agente não fornecer mais o runtime .NET exato para o qual a versão de CLI foi criada, a CLI pode falhar ao iniciar com um erro como:

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

Isso não indica um problema de produto com o UiPath CLI, mas sim uma incompatibilidade de runtime entre a compilação do CLI e o ambiente no qual ele é executado.

Resolução:

Para restaurar a compatibilidade, adicione uma política de rolagem para frente no arquivo uipcli.runtimeconfig.json localizado ao lado de uipcli.exe. Isso permite que a CLI seja executada em runtimes .NET mais recentes do que foi originalmente construído.

Localize a versão da estrutura de destino para a qual sua CLI foi criada (verifique a mensagem de erro ou o arquivo uipcli.runtimeconfig.json existente, se presente) e, em seguida, crie ou modifique o arquivo da seguinte forma:

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

Substitua X.0 pela versão do framework de destino (por exemplo, net6.0, net8.0) e X.0.0 pela versão do runtime (por exemplo, 6.0.0, 8.0.0).

A configuração "rollForward": "LatestMajor" permite que a CLI use qualquer runtime .NET mais recente disponível no agente.

Se seu ambiente usar um caminho de instalação .NET personalizado, consulte a orientação acima sobre a configuração DOTNET_ROOT e a verificação do local do runtime.

Problemas relacionados ao caractere especial em senhas da string de conexão

Na maioria das instâncias, as senhas de conexão são encapsuladas dentro de uma única aspa ('). No entanto, quando a senha inclui caracteres especiais, como ` ou $, é necessária uma abordagem diferente.

Nesses casos, a senha deve ser formatada como \`"<password>\`", substituindo <password> pela senha verdadeira. Além disso, você também deve aderir às regras de escape conforme detalhado na seguinte tabela:

Formato original no ADUC	Formato escapado na string do 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$"

Exemplo:

Presuma que a senha original seja 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Aderindo às regras de escape de caractere especial, ele se torna: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".