- 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
- 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
- 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 de la signature des paquets
- Message trop volumineux pour être traité
- Erreurs lors de l’exécution en tant qu’administrateur
- Mise à niveau d'Orchestrator de la version 2018.4 à la version 2020.10
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.
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.
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é.
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é.
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.
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.
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.
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.
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
UiPath_Session_Timeout
sur la machine Robot. 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.
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 l'Agent Robot (panneau) affiche le message d'erreur suivant :
Executor start process failed, reason System.UnauthorizedAccessException: Access is denied.
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.
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.
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 Robot UiPath (UiPath Robot) et double-cliquez dessus. Le panneau Propriétés du Robot UiPath (UiPath Robot Properties) est affiché.
- 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.
Connectez-vous à la machine Robot avec le même ensemble d'identifiants que celui avec lequel vous avez créé le Robot dans Orchestrator. Si un processus ne parvient pas à démarrer à partir de l'Agent Robot (panneau), vous devez contacter votre administrateur réseau afin que ce compte utilisateur dispose des droits d'administrateur.
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 l'Agent Robot (panneau) affiche le message d'erreur suivant :
Get settings from service failed, reason System.Exception: Could not connect to UiPath Robot Service.
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 Robot UiPath (UiPath Robot) et cliquez avec le bouton droit dessus. Le menu contextuel est affiché.
- 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.
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 au
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
clé de registre, et sélectionnez la sous-cléControl
. -
Si la valeur
ServicesPipeTimeout
n’est PAS disponible, créez-la comme suit :3.1. 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.3.2. Tapez ServicesPipeTimeout comme nom de la nouvelle valeur.
- 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.
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.
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 au
clé de registreHKEY_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.
%UserProfile%\.nuget\Packages
contient déjà une version du paquet avec le fichier projet .nupkg
correspondant à l'intérieur et une sans lui.
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.
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.
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. »
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).
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 ».
- Dépendances du projet pour les installations EXE
- Comportement observé
- Origine
- Solution A
- Solution B
- Le Robot ne réussit pas à démarrer l'exécution
- Comportement observé
- Cause A
- Solution A
- Cause B
- Solution B
- Mot de passe non fourni
- Comportement observé
- Cause A
- Solution A
- Cause B
- Solution B
- Cause C
- Solution C
- Pas de connexion au service Robot
- Comportement observé
- Cause A
- Solution A
- Cause B
- Solution B
- Cause C
- Solution C
- Le Robot ne parvient pas à télécharger le paquet
- Comportement observé
- Origine
- Solution
- La session n'est pas déconnectée
- 'System.Collections.IEnumerable' ne peut pas être sérialisé
- Comportement observé
- Origine
- Solution