- Notes de publication
- Démarrage
- Assistant UiPath
- Installation et mise à niveau
- Types de robot
- Composants du Robot
- Licences
- Connexion des Robots à Orchestrator
- Processus et activités
- Journalisation
- Robot JavaScript SDK
- Scénarios spécifiques
- Redémarrage des composants du Robot
- Sessions Windows
- Connexion à l’aide du système d’informations d’identification Thales Luna
- Connexion à l’aide du fournisseur de services de chiffrement nShield
- Rediriger les Robots vers un serveur proxy
- Exécuter des tâches à partir d'une session de bureau à distance minimisée
- Utilisation de lecteurs réseau mappés
- Arrêter un processus :
- Désactiver le bouton Arrêt
- Dossiers de paquets personnalisés et chemins d'accès réseau
- Intégration de CrowdStrike
- Virtualisation des applis Citrix par le Robot
- Résolution des problèmes
- Robot ne répond pas sur RDP
- Journaux d'exécution en double
- Erreurs du Robot fréquemment rencontrées
- Augmentation de la durée d'exécution des processus
- Vérification forcée de la signature des paquets
- Message trop volumineux pour être traité
- Erreurs lors de l’exécution en tant qu’administrateur
- Les packages NuGet ne sont pas accessibles après la migration
- Invite de contrôle d'accès utilisateur et activités d'automatisation de l'interface utilisateur
- .NET nécessaire lors de l'installation
- L'assembly ne peut pas être chargé à partir du réseau ou d'un partage de fichiers Azure
- Les activités ne trouvent pas le runtime .NET
Guide de l'utilisateur du Robot
Erreurs du Robot fréquemment rencontrées
Dans cette section, vous trouverez davantage de détails sur les erreurs de robot les plus fréquemment rencontrées ainsi que sur leur résolution.
Comportement observé
Le Robot ne parvient pas à télécharger ou à exécuter des processus créés dans Studio v2019.2 ou version antérieure, qui ont des dépendances sur les flux officiels ou Go!, et non disponibles localement ou sur Orchestrator.
Origine
UiPathStudioSetup.exe
(généralement la configuration de l'édition communautaire), le Robot est installé en mode utilisateur. En tant que tel, le Robot ne peut télécharger et installer des dépendances de projet que si elles sont disponibles localement ou sur l'instance d'Orchestrator à laquelle il est connecté.
Solution A
Toutes les dépendances du projet doivent être téléchargées manuellement à partir du flux officiel et téléchargées vers l'instance d'Orchestrator à laquelle il est connecté.
Solution B
UiPath.Service.UserHost
). Ouvrez UiPath® Assistant et démarrez le processus depuis celui-ci. Les dépendances correspondantes sont désormais correctement téléchargées.
Comportement observé
Dans ce scénario, le robot ne réussit pas à démarrer l'exécution d'un processus et génère l'erreur suivante :
Executor start process failed, reason
System.Runtime.InteropServices.COMException: A specified logon session does not
exist. It may already have been terminated.
Cause A
La machine Robot ne dispose pas de suffisamment de ressources disponibles (telles que le processeur, la RAM ou l'espace disque). L'exécuteur Robot ne peut donc pas démarrer un processus.
Solution A
Vérifiez ou effectuez les opérations suivantes :
- La machine Robot dispose de suffisamment de ressources (telles que le processeur, la RAM ou l'espace disque).
- Délai de connexion utilisant la fonction de ligne de commande
mstsc
. Il doit être supérieur à 60 secondes. Sinon, l'erreur est affichée.
Cause B
Vous ne pouvez pas créer de session de connexion pour le moment. Cela peut se produire dans les situations suivantes :
- L'option Connexion à la console (Login To Console) est définie sur true pour les Robots HD. Dans ce cas, le service Robot se connecte à la session de console actuelle. Cela n'est pas recommandé pour les Robots HD, car il ne peut y avoir qu'une session de console active à la fois.
- Plusieurs sessions RDP sur des versions Windows autonomes (pas des serveurs). Les versions Windows autonomes ne peuvent gérer qu'une session RDP à la fois par machine, tandis que les versions de Windows Server peuvent gérer plusieurs sessions RDP.
Solution B
Dans ce cas, vous devez effectuer l'une des opérations suivantes :
- Définissez l'option Connexion à la console (Login To Console) sur false. Cela implique que le service Robot lance une connexion RDP depuis la machine Robot sur lui-même et qu'il s'y connecte. Il s'agit de la méthode recommandée pour les Robots HD.
- Vérifiez la version de Windows, cela doit être Windows Server. Apprenez-en davantage à la page Configuration de Windows Server pour les Robots HD.
- Vérifiez si la version de Studio/Robot que vous utilisez est supérieure à 2018.1.3, qui a résolu un problème causé par les mises à jour Windows KB4088876 (Windows 8.1 ou Windows Server 2012 R2 Standard), KB4088875 (Windows Server 2008 R2 SP1, Windows 7 SP1), KB4088787 (Windows Server 2016, Windows 10 Version 1607) et KB4088776 (Windows 10 version 1709). Apprenez-en davantage à la page Configuration logicielle requise.
- Augmentez la variable d'environnement système
UIPATH_SESSION_TIMEOUT
sur votre serveur. La valeur par défaut est 60 secondes, ce qui peut s'avérer insuffisant en raison des performances lentes sur certaines machines. Notez que la variable d'environnement est définie en secondes et que le service de robot UiPath doit être redémarré après la modification de cette variable. - Vérifiez si votre licence Bureau à distance est active sur la machine Robot. Vous pouvez en apprendre plus sur cette page.
- Vérifiez si les robots sont dans les groupes appropriés. Les utilisateurs locaux doivent appartenir au même groupe Bureau à distance.
- Vérifiez si le nom d'utilisateur de votre connexion RDP à la machine Robot n'est pas différent de celui configuré. Pour éviter cette erreur, déconnectez toutes les connexions RDP sur la machine Robot.
Comportement observé
La création d'un robot dans Orchestrator sans renseigner le champ du mot de passe empêche le démarrage de l'exécution du processus. Les modifications apportées aux privilèges sur la machine Robot peuvent également déclencher ce problème.
Le démarrage d’un processus à partir d’Orchestrator ou de UiPath® Assistant affiche le message d’erreur suivant :
Executor start process failed, reason System.UnauthorizedAccessException: Access
is denied.
Cause A
Le Robot a été créé sans mot de passe.
Solution A
Modifiez le Robot, comme expliqué ici et assurez-vous que les champs suivants sont correctement remplis :
- Domaine\\Nom d'utilisateur - Le nom d'utilisateur utilisé pour se connecter à la machine sur laquelle le robot est installé. Si l'utilisateur se trouve dans un domaine, vous devez également le spécifier dans un format
DOMAIN\UserName
. Utilisez la commandeWhoami
dans l'invite de commande pour le trouver facilement. - Mot de passe (Password) : mot de passe Windows de la machine. Non requis pour les Robots Attended.
Cause B
Le service Robot géré par SCM n'est pas en cours d'exécution. Apprenez-en davantage à la page À propos des types de déploiement du Robot.
Solution B
Assurez-vous que le service Robot est en cours d'exécution :
- Cliquez sur le bouton Démarrer de Windows, puis recherchez et ouvrez
Services.msc
. La fenêtre Services (Services) est affichée. - Recherchez le service de robot UiPath® et double-cliquez sur celui-ci. Le panneau Propriétés de UiPath® Robot s’affiche.
- Dans l'onglet Ouvrir la session (Log On), sélectionnez l'option Compte système local (Local System account).
- Cliquez sur le bouton Appliquer (Apply) et fermez la fenêtre pour confirmer les modifications. Cela permet de s'assurer que le service Robot est en cours d'exécution et qu'il dispose de tous les privilèges nécessaires à l'exécution des processus.
Cause C
La machine Robot ne dispose plus des privilèges d'administrateur.
Solution C
Connectez-vous à la machine Robot avec le même jeu d’informations d’identification avec lequel vous avez créé le Robot dans Orchestrator. Si un processus ne démarre pas à partir de l’assistant UiPath®, vous devez contacter votre administrateur réseau pour autoriser les droits d’administrateur pour ce compte d’utilisateur.
Comportement observé
Dans certaines situations, vous ne pouvez pas démarrer l'exécution du processus. Cela peut arriver, que le service de robot soit en cours d'exécution ou non.
Le démarrage d’un processus à partir d’Orchestrator ou de UiPath® Assistant affiche le message d’erreur suivant :
Get settings from service failed, reason System.Exception: Could not connect to
UiPath® Robot Service.
Cause A
Le service Robot n'est pas en cours d'exécution.
Solution A
Dans ce cas, vous devez démarrer manuellement le service Robot, comme suit :
- Cliquez sur le bouton Démarrer de Windows, puis recherchez
Services.msc
et ouvrez-le. La fenêtre Services (Services) est affichée. - Recherchez le service de robot UiPath® et cliquez droit sur celui-ci. Le menu contextuel s’affiche.
- Cliquez sur Démarrer (Start) pour activer le service Robot. Cela entraîne le démarrage du service Robot à l'ouverture de session Windows.
Si ces étapes doivent être répétées à chaque démarrage de la machine Robot, vous devez augmenter la valeur du délai d'expiration des services dans Windows, comme expliqué ci-dessous.
Cause B
Le démarrage du service Robot est trop long.
Solution B
Windows signale les services qui ne se chargent pas dans un délai spécifié. Par défaut, cette valeur de délai d'expiration est de 30 secondes, ce qui peut être insuffisant pour le service Robot. Pour augmenter cette valeur, vous devez effectuer les opérations suivantes :
- Ouvrez l'éditeur du Registre Windows.
- Accédez à la clé du Registre
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
, puis sélectionnez la sous-cléControl
. - Si la valeur
ServicesPipeTimeout
n’est PAS disponible, créez-la comme suit :- Cliquez avec le bouton droit sur la sous-clé
Control
et sélectionnez Valeur DWORD (32 bits) dans le menu Nouveau. Une nouvelle valeur DWORD vierge est créée. - Tapez ServicesPipeTimeout comme nom de la nouvelle valeur.
- Cliquez avec le bouton droit sur la sous-clé
- Double-cliquez sur la valeur DWORD
ServicesPipeTimeout
. La valeur Modifier la valeur DWORD (32 bits) (Edit DWORD (32-bit) Value) est affichée. - Dans la section Base (Base), sélectionnez l'option Décimal (Decimal).
- Dans le champ Données de la valeur : (Value data), saisissez 180000. Cela rend la valeur par défaut de
ServicesPipeTimeout
3 minutes. Tous les services Windows devraient avoir suffisamment de temps pour se charger correctement. - Fermez l'éditeur de Registre Windows et redémarrez l'ordinateur pour que les modifications prennent effet.
Cause C
Les autorisations de la machine Robot sont incorrectes. Dans ce cas, le service Robot peut également apparaître comme étant en cours d'exécution.
Solution C
Les autorisations d'accès aux services sont accordées à partir de l'éditeur de Registre Windows, comme suit :
- Ouvrez l'éditeur du Registre Windows.
- Accédez à la clé de registre
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
. - Cliquez avec le bouton droit sur la sous-clé
Control
, puis cliquez sur Autorisations (Permissions). La fenêtre Autorisations de contrôle (Permissions for Control) est affichée. - Sélectionnez l'utilisateur sous lequel vous êtes connecté depuis la section Noms de groupes ou d’utilisateurs (Group or user names).
- Activez l'option Autoriser (Allow) de Contrôle total (Full Control) dans la section Autorisations (Permissions). Cela accorde les autorisations nécessaires au Robot.
- Cliquez sur Appliquer (Apply) et sur OK (OK) pour confirmer les modifications et fermer la fenêtre.
- Redémarrez l'ordinateur pour que les modifications prennent effet.
Au cas où votre accès restreint vous empêcherait d'effectuer les modifications ci-dessus, contactez votre administrateur réseau.
Comportement observé
%UserProfile%\.nuget\Packages
contient déjà une version du paquet avec le fichier projet .nupkg
correspondant à l'intérieur et une sans lui.
Origine
Ce problème se produit dans un scénario particulier :
- Installez Studio/Robot v2019.4 ou une version ultérieure. Téléchargez et exécutez un paquet à partir d'Orchestrator. Le paquet est installé dans le dossier
%UserProfile%\.nuget\Packages
et contient le fichier.nupkg
correspondant. - Désinstallez la version actuelle de Studio/Robot.
- Installez une version de Studio/Robot antérieure à 2019.4. Téléchargez et exécutez le paquet précédent à partir d'Orchestrator. Le paquet précédent n'est pas supprimé, et le nouveau ne contient pas le fichier
.nupkg
correspondant. - Mettez à niveau Studio/Robot vers la version 2019.4 ou ultérieure. Le téléchargement du paquet échoue à nouveau avec l'erreur suivante :
.nupkg
manquant correspondant au projet.
Solution
%UserProfile%\.nuget\Packages
et téléchargez-les à nouveau.
Après l'exécution d'un workflow démarré par l'activitéLaunch Workflow Interactive, la session n'est pas déconnectée. Cela se produit si le robot s'exécute sur un environnement VDI et que les options LoginToConsole et KeepSessionConnected sont activées. Veuillez noter qu'à partir de la v2018.2, l'activité Launch Workflow Interactive est déconseillée.
Comportement observé
Lorsque vous utilisez une table de données dans la zone « Attendre la tâche et reprendre », l’erreur suivante est renvoyée : « Exception : Type 'System.Collections.IEnumerable' ne peut pas être sérialisée. »
Origine
DataRow n'est pas sérialisable ; il n'est donc pas en mesure de sérialiser DataRows tout en conservant le flux de travail. Ce peut également être le cas lorsque nous créons une variable DataRow et que nous essayons d'attendre (persister).
Solution
Exécutez l'activité « Créer une tâche de formulaire » et créez une liste d'objets de tâche (sortie) tout en effectuant une boucle dans DataRows (System.Data.DataRow).
Nous pouvons ensuite effectuer une boucle dans la liste des objets de tâche (sortie) à l’aide de « Parallel For Each » ou « For Each » et exécuter « Attendre la tâche et reprendre ».