Résoudre les problèmes d’exécution

Message trop volumineux pour être traité

Description

Les automatisations qui traitent de grands volumes de données peuvent échouer en raison de l’erreur suivante : « Message : Impossible de récupérer le résultat de l’exécution de la tâche. Le message était peut-être trop long pour être traité. Type d’exception : System.Exception".

Problème potentiel

Les données produites par l’automatisation dépassent la valeur du paramètre maxMessageSizeInMegabytes dans le fichier uipath.config.

Solution

Configurez l’automatisation pour enregistrer la sortie dans un compartiment de stockage dans Orchestrator ou dans Data Service, plutôt que d’utiliser un argument de sortie.

Les automatisations Unattended utilisant les activités UIAutomation ne fonctionnent pas

Description

Les automatisations Unattended utilisant les activités UIAutomation ne fonctionnent pas.

Problème potentiel

Lorsqu’un programme tel que le Gestionnaire de serveur, configuré pour démarrer automatiquement, affiche une invite de contrôle de compte d’utilisateur Windows (UAC), cela empêche le robot d’interagir avec l’interface utilisateur.

Solution

Identifiez le programme qui déclenche l’invite de contrôle de compte d’utilisateur (UAC) et configurez-le afin qu’il ne démarre pas automatiquement.

Le Robot ne réussit pas à démarrer l'exécution

Description

Le robot ne parvient pas à démarrer l’exécution d’une automatisation et affiche l’erreur suivante : « Échec du processus de démarrage de l’exécuteur, raison System.Runtime.InteropServices.COMException : L’accès est refusé. Elle est peut-être déjà terminée. »

Les tableaux suivants résument plusieurs problèmes et leurs solutions.

Problème potentiel	Solution
La machine Robot ne dispose pas de suffisamment de ressources (telles que le processeur, la RAM ou l’espace disque). L’exécuteur Robot ne peut donc pas démarrer l’automatisation.	Assurez-vous que la machine Robot dispose de suffisamment de ressources (telles que le processeur, la RAM ou l’espace disque). Vérifiez le délai de connexion en utilisant la fonction de ligne de commande mstsc. Il doit être supérieur à 60 secondes. Sinon, l’erreur s’affiche.
Vous ne pouvez pas créer de session de connexion pour le moment. Cela peut se produire dans les situations suivantes : La propriété Connexion à la console est définie sur Vrai pour les robots haute densité. Dans ce cas, le service de robot se connecte à la session de console actuelle. Ceci 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 de bureau (pas des serveurs). Les versions Windows de bureau ne peuvent gérer qu’une seule session RDP à la fois par machine, tandis que les versions 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 sur Faux. Cela implique que le service de 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. Vérifiez si les versions de Studio et de Robot sont supérieures à 2018.1.3. Augmentez la valeur de 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. Redémarrez le service de robot UiPath après avoir modifié cette variable. Vérifiez si votre licence Bureau à distance est active sur la machine Robot. Vérifiez si les robots sont dans les groupes appropriés. Les utilisateurs locaux doivent être dans le même groupe Bureau à distance. Vérifiez si le nom d’utilisateur de votre connexion RDP à la machine Robot est le même que celui configuré. Pour éviter cette erreur, déconnectez toutes les connexions RDP sur la machine Robot.

Mot de passe non fourni

Description

Le démarrage d’une automatisation à partir d’Orchestrator ou de l’Assistant affiche le message d’erreur suivant : « Échec du processus de démarrage de l’exécuteur, raison System.UnauthorizedAccessException : L’accès est refusé. »

La table suivante résume les problèmes potentiels et leurs solutions :

Problème potentiel	Solution
Le compte Robot a été créé sans mot de passe.	Modifiez le compte Robot dans Orchestrator et fournissez les valeurs suivantes : 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. Mot de passe : mot de passe de connexion Windows.
Le service de robot est inactif.	Ouvre la fenêtre Services. Sélectionnez le service UiPathRobotSvc. Ouvrez le panneau Propriétés pour le service sélectionné. Dans l’onglet Ouvrir une session, sélectionnez Compte système local. Sélectionnez Appliquer et OK pour confirmer les modifications, puis fermez la fenêtre. Cela permet de s’assurer que le service de robot UiPath est en cours d’exécution et qu’il dispose de tous les privilèges nécessaires à l’exécution des automatisations.
La machine Robot ne dispose plus des privilèges d'administrateur.	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, vous devez contacter votre administrateur réseau pour autoriser les droits d’administrateur pour ce compte d’utilisateur.

System.Collections.IEnumerable ne peut pas être sérialisé

Description

Lorsque vous utilisez une table de données dans une activité Attendre la tâche et reprendre, elle renvoie l’erreur suivante : « Exception : Type ’System.Collections.IEnumerable’ ne peut pas être sérialisée. »

Problème potentiel

L’objet LigneDonnées de la table de données ne peut pas être sérialisé, il ne peut donc pas être conservé, ce qui entraîne de potentiels problèmes ou erreurs.

Solution

Exécutez l’activité Créer une tâche de formulaire et créez la sortie en exécutant une boucle dans les lignes de données pour créer une liste d’objets de tâche. Ensuite, parcourez la liste de sortie des objets de tâche à l’aide des activités Parallèle pour chaque ou Pour chaque. Dans ces boucles, exécutez l’activité Attendre la tâche et reprendre pour chaque objet de tâche.

Tâche arrêtée avec un code de sortie inattendu

Description

L’exécution de votre tâche échoue et le message d’erreur suivant est consigné dans Orchestrator : « Tâche arrêtée avec un code de sortie inattendu : 0x40010004 ».

Problème potentiel

Généralement, cette erreur se produit lorsque :

• Le compte utilisateur, utilisé par le robot, est déconnecté de force pendant l’exécution du processus.

• La machine sur laquelle le robot est en cours d’exécution est arrêtée ou redémarrée manuellement pendant l’exécution du processus.

Solution

Pour éviter cette erreur, assurez-vous que le robot est installé correctement pour le type d’automatisation prévu : Attended ou Unattended. Lorsque le robot est installé en mode utilisateur, il est impossible d’exécuter des automatisations Unattended.

Par ailleurs, configurez la session Robot en fonction de votre environnement et des besoins de votre entreprise.

L'automatisation fonctionne en mode assisté, mais pas en mode sans assistance

Description

La même automatisation fonctionne comme prévu en mode assisté, alors qu'une personne est connectée et observe, mais elle échoue en mode sans assistance. Les autres problèmes potentiels en mode sans assistance incluent :

• Le robot clique à des endroits incorrects.
• Des fenêtres aléatoires s'ouvrent de manière inattendue.
• Des éléments de la barre des tâches s'activent sans intervention de l'utilisateur.
• L'application cible entre dans un état inattendu.

Problème potentiel

Dans les automatisations sans assistance, le service de robot UiPath initialise la session Windows par le biais d'une connexion RDP et s'appuie sur les paramètres système pour la résolution et la mise à l'échelle de l'affichage, ou sur les paramètres du robot. En conséquence, la résolution et la mise à l'échelle entre la session distante et la session locale sont différentes.

Solutions

Important :

Avant de commencer les tests, vérifiez que l'utilisateur Robot est déconnecté de la machine robot. Le robot fonctionne ainsi dans un environnement propre.

Les différences de résolution sont souvent la principale différence entre les modes assistés et sans assistance. Reportez-vous aux sections Résoudre les problèmes de résolution et Meilleures pratiques en matière de résolution.

Solution possible	Procédure
Solution 1 : vérifiez les paramètres de mise à l'échelle Les paramètres de mise à l'échelle peuvent affecter la façon dont le robot interagit avec l'interface utilisateur.	Si les recommandations liées à la résolution ne résolvent pas le problème, vérifiez les paramètres de mise à l'échelle des sessions Windows : Connectez-vous à la machine comme si vous exécutiez une automatisation assistée. Ouvrez PowerShell (utilisez la boîte de dialogue Exécuter et saisissez « powershell »). Exécutez cette commande : (Get-ItemProperty 'HKCU:\Control Panel\Desktop\WindowMetrics' -Name AppliedDPI).AppliedDPI La valeur retournée doit être 96. Sinon, il est possible que le robot ait été développé avec une mise à l'échelle non standard. Reportez-vous à la section Forcer la mise à l'échelle.
Solution 2 : capturez les problèmes en temps réel	Si la solution 1 ne vous aide pas, utilisez les fonctionnalités de diffusion en direct et de contrôle à distance pour capturer le problème dès qu'il survient. Ces outils vous permettent d'observer le comportement du robot sans vous connecter directement à la machine, ce qui vous aide à identifier les problèmes qui pourraient ne pas apparaître autrement.
Solution 3 : assistance UiPath	Si les étapes ci-dessus ne permettent pas d'identifier le problème, ouvrez un ticket d'assistance auprès d'UiPath.

Meilleures pratiques en matière de résolution

• Consultez les directives liées à UI Automation.
• Faites de la résolution une exigence de conception prioritaire
• Vérifiez que la résolution et la mise à l'échelle de vos environnements de développement et de production sont identiques.
• Sachez que si vous ne spécifiez pas de résolution, les valeurs système par défaut sont appliquées. Cela peut entraîner des résolutions trop faibles que l'application ne prend pas en charge. Les éléments de l'interface utilisateur peuvent s'afficher hors écran ou être déformés.
• Ne négligez pas les activités dépendantes de la résolution :
  • Les activités basées sur des images, telles que les activités Find Image (Trouver l'image) ou OCR.
  • Les activités UI Automation dont les zones de découpage sont activées.
  • Les activités UI Automation dont l'option WaitVisible est activée.
  • Les activités de clic qui n'utilisent pas les méthodes d'entrée Window Messages (Messages Windows) ou Simulate (Simuler). Pour la propriété CursorPosition (Position du curseur), reportez-vous à la section Le robot clique à des endroits incorrects.

Le robot clique à des endroits incorrects

Les clics de robot incorrects indiquent généralement que l'option CursorPosition (Position du curseur) est activée dans l'activité Click (Clic).

La propriété CursorPosition (Position du curseur) est parfois configurée involontairement lorsque vous utilisez la fonctionnalité Recording (Enregistrement) dans Studio. Identifiez l'activité dans laquelle le clic a lieu au mauvais endroit et déterminez si l'option est activée intentionnellement. Dans la plupart des cas, cette propriété est inutile.

Résoudre les problèmes de résolution

1. Connectez-vous à la machine comme si vous exécutiez une automatisation assistée.
2. Ouvrez PowerShell (utilisez la boîte de dialogue Exécuter et saisissez « powershell »).
3. Exécutez cette commande :

   [void][Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")
   [System.Windows.Forms.SystemInformation]::PrimaryMonitorSize

4. Notez les valeurs de largeur (Width) et de hauteur (Height) retournées, car vous en aurez besoin à l'étape 7b.
5. Vérifiez le lissage des polices :
   • Ouvrez View advanced system settings (Affichage des paramètres système avancés) dans le menu Start (Démarrer).
   • Dans l'onglet Advanced (Avancé), sélectionnez Settings (Paramètres) sous Performance.
   • Vérifiez si l'option Smooth edges of screen fonts (Lisser les bords des polices écran) est activée.
6. Si vous avez besoin d'une profondeur de couleur ou d'un lissage des polices, vérifiez les paramètres d'affichage sur la machine locale qui se connecte à la machine robot :
   • Accédez à Display Settings (Paramètres d'affichage).
   • Accédez à la section Advanced display settings (Paramètres d'affichage avancés) pour obtenir des informations sur la profondeur de couleur.
7. Accédez à la section Robot Settings (Paramètres du robot) correspondant au compte du robot qui exécute l'automatisation (Orchestrator > Tenant (Locataire) > Manage Access (Gérer l'accès) > Access Rules (Règles d'accès) > Robot accounts (Comptes de robots).
   1. Définissez l'option Login To Console (Connexion à la console) sur No (Non). Cela indique au robot d'utiliser les sessions RDP pour les automatisations sans assistance.
   2. Définissez les valeurs des paramètres Resolution Width (Largeur de la résolution) et Resolution Height (Hauteur de la résolution). Utilisez les mêmes valeurs que celles retournées à l'étape 3.
   3. Configurez le champ Resolution Depth (Profondeur de la résolution) sur 32.
   4. Pour les automatisations basées sur des images, configurez également le champ Font Smoothing (Lissage des polices) sur Yes (Oui).
8. Sélectionnez Mettre à jour (Update).

Forcer la mise à l'échelle

De manière optimale, reconcevez l'automatisation dans un environnement de développement dont l'échelle est définie sur 100 %. Les étapes suivantes constituent une solution de contournement temporaire. Veillez à ce que le robot s'exécute dans une session RDP (l'option Login to Console (Connexion à la console) est définie sur No (Non).

1. Ouvrez l'Éditeur du Registre et accédez à HKEY_CURRENT_USER\Control Panel\Desktop\LogPixels.
2. Recherchez la valeur de registre LogPixels. Si la valeur n'existe pas, créez-la en tant que valeur 32-DWORD. Consultez la liste suivante pour connaître les valeurs décimales possibles :

   DPI (résolution)	Facteur d'échelle, % (la valeur LogPixels)
   96	100 (pas de mise à l'échelle)
   120	125 (tout ce qui s'affiche à l'écran est 25 % plus grand)
   144	150 (tout ce qui s'affiche à l'écran est 50 % plus grand)
   192	200 (tout ce qui s'affiche à l'écran est deux fois plus grand)

3. Ensuite, accédez à HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\.
4. Recherchez la valeur de registre IgnoreClientDesktopScaleFactor. Cette clé de registre indique à la connexion distante si elle doit ignorer la mise à l'échelle de la machine robot. Si la valeur n'existe pas, créez-la en tant que valeur 32-DWORD. Consultez la liste suivante pour connaître les valeurs décimales possibles :
   1. 1 : ignore la mise à l'échelle sur la machine robot.
   2. 0 : prend en compte la mise à l'échelle de la machine robot.