Résolution des problèmes d'interface en ligne de commande UiPath

Si vous rencontrez des problèmes lors de votre utilisation de la CLI UiPath, envisagez les scénarios de résolution de problèmes suivants.

Problèmes liés à la version .NET

Description:

Vous pouvez rencontrer des problèmes avec les tâches CLI UiPath et les opérations de pipeline si la bonne version de l'infrastructure .NET n'est pas installée (ou est manquante) sur votre système.

Lorsque ce problème se produit, vous pouvez rencontrer des messages d’erreur tels que :

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

Vous devez vous assurer que la bonne version .NET est installée.

Pour la matrice de compatibilité des versions CLI et .NET , reportez-vous à la section Prérequis .

Exécuter les anciennes versions de la CLI sur des agents CI/CD mis à jour

Les environnements CI/CD hébergés tels qu'Azure DevOps, GitHub Actions et GitLab SharePoint Runners actualisent périodiquement leurs images d'agent de création et suppriment les anciens runtimes .NET qui ont atteint leur fin de vie.

Si votre pipeline utilise une ancienne version de CLI et que l'agent ne fournit plus le runtime .NET exact pour lequel cette version de CLI a été créée, la CLI peut ne pas démarrer avec une erreur telle que :

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

Cela n’indique pas un problème de produit avec la CLI UiPath, mais plutôt une incompatibilité de runtime entre la création de la CLI et l’environnement dans lequel elle s’exécute.

Résolution :

Pour restaurer la compatibilité, ajoutez une stratégie de restauration dans le fichier uipcli.runtimeconfig.json situé en regard de uipcli.exe. Cela permet à la CLI de s'exécuter sur des runtimes .NET plus récents que ceux pour lesquels elle a été initialement conçue.

Localisez la version uipcli.runtimeconfig.json framework cible pour laquelle votre CLI a été développée, puis créez ou modifiez le fichier comme suit :

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

Remplacez X.0 par la version d'infrastructure cible (par exemple, net6.0, net8.0) et X.0.0 par la version de runtime (par exemple, 6.0.0, 8.0.0).

Le paramètre "rollForward": "LatestMajor" permet à la CLI d'utiliser tout runtime .NET plus récent disponible sur l'agent.

Si votre environnement utilise un chemin d'installation .NET personnalisé, reportez-vous aux conseils ci-dessus pour configurer DOTNET_ROOT et vérifier l'emplacement du runtime.

Problèmes liés au caractère spécial dans les mots de passe de la chaîne de connexion

Dans la plupart des cas, les mots de passe de connexion sont encapsulés par un guillemet unique ('). Cependant, lorsque le mot de passe inclut des caractères spéciaux tels que ` ou $, il est nécessaire de procéder différemment.

Dans ces cas, le mot de passe doit être formaté en tant que \`"<password>\`", en remplaçant <password> par le mot de passe réel. De plus, vous devez également respecter les règles d’échappement comme détaillé dans la table suivante :

Format d’origine dans ADuC	Format échappé dans la chaîne 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$"

Exemple :

Supposons que le mot de passe d’origine est 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. En respectant les règles d’échappement des caractères spéciaux, elle devient : Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".