Package de l\'Enregistreur
- Dernière mise à jour2024/07/23
Package de l\'Enregistreur
Le package de l\'enregistreur capture une série de tâches dans un processus, puis les automatise. Vous pouvez automatiser vos applications de gestion (par exemple, les applications de bureau, Web, SAP et Java) à l\'aide de l\'Enregistreur pour capturer les actions effectuées sur des objets d\'application tels qu\'une zone de texte, un bouton, un tableau, une case d\'option, une zone de liste déroulante et une vue de liste.
Configuration de l\'extension Automation 360
- Cliquez sur l\'icône Extensions en haut à droite de la fenêtre du navigateur.
- Cliquez sur les ellipses verticales à côté du plug-in Automation 360 et sélectionnez Gérer l\'extension.
- Activez l\'option Autoriser l\'accès aux URL des fichiers.
- Redémarrez le navigateur et exécutez le robot.
Avantages de l\'utilisation du Enregistreur package au lieu du SAP package
- Vous pouvez automatiser des objets sans créer de session. Lorsque vous utilisez le SAP package, vous devez créer une session.
- Vous pouvez automatiser l\'objet directement sans générer de chemins de champ ou sans disposer d\'une connaissance préalable des chemins de champ. Lorsque vous utilisez le SAP package, le package exécutera les actions directement sur les chemins des champs de contrôle lorsque les propriétés des critères de recherche correspondent à l\'objet que le robot recherche pendant l\'exécution.
- Si la fenêtre d\'exécution de l\'Enregistreur chevauche l\'objet que vous voulez automatiser, alors l\'Enregistreur masque la fenêtre d\'exécution avant que vous n\'automatisiez l\'objet.
- L\'Enregistreur prend en charge des actions dans les Si Boucle, Attendre et packages qui permettent de vérifier si un objet existe dans le navigateur ou la fenêtre spécifique.
Capturer à l\'aide de l\'Enregistreur
- L\'action Capturer remplace la commande Clonage d\'objet de la Version 11.3.
- Si vous lancez un navigateur ou une application pris en charge avec un compte d\'utilisateur différent de celui utilisé pour vous connecter à l\'ordinateur, le Enregistreur risque de ne pas capturer et lire avec précision les actions de contrôle.
- Pour capturer des objets de manière fiable lors de l\'utilisation de deux moniteurs, assurez-vous que la résolution de l\'écran est la même sur les deux moniteurs.
- Lorsque vous utilisez le Enregistreur package (version 2.3.0-20210806-215200 ou antérieure) avec le Bot Agent (version 21.250 ou ultérieure) publié avec Automation 360 v.29, vous pouvez rencontrer des problèmes lors de la capture d\'un objet. Nous vous recommandons d\'utiliser le Enregistreur package (version 2.4.0-20211118-080716 ou ultérieure) avec le Bot Agent (version 21.250 ou ultérieure) pour pouvoir capturer des objets.
- Lorsque le Bot Agent est installé au niveau de l\'utilisateur, c\'est-à-dire pour un type d\'installation spécifique à l\'utilisateur, Citrix, Java et SAP ne seront pas configurés car la session dans laquelle le Bot Agent est exécuté peut ne pas avoir les privilèges requis. Seul le plugin VMWare sera configuré pour l\'utilisateur actuel.
Utilisation de l\'action Capturer
Lorsque vous automatisez des pages Web fonctionnant sur les navigateurs Google Chrome et Microsoft Edge, l\' action ne fait plus défiler la page Web vers le bas si l\'objet cible est visible à l\'écran. Cette fonction améliore l\'expérience de l\'utilisateur et la fiabilité de l\'automatisation lorsque la page Web comporte un volet supérieur fixe et que certaines actions physiques, telles que les clics de souris, ne fonctionnent pas comme prévu.
Utilisez l\'action pour automatiser les objets avec succès lorsque les informations d\'identification de votre périphérique sont saisies au format UPN.
Configuration manuelle de la technologie Silverlight
- Accédez à C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources
- Rechercher ec0db824-25eb-4c57-ab44-f77ef67d2579.
Les résultats de la recherche affichent une liste de Enregistreur packages.
- Sélectionnez le Enregistreur package que vous utilisez.
- Exécutez le fichier check.exe en tant qu\'administrateur à partir de ce dossier.
- Cliquez sur le menu Fichier.
- Accédez à
- Saisissez .\Check.exe dans le script et cliquez sur Entrée.
- Ouvrez l\'invite de commande et exécutez-le en tant qu\'administrateur.
- Saisissez C:\NProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ suivi de la version du Enregistreur package que vous utilisez.
- Saisissez Check.exe dans le script et cliquez sur Entrée.
Applications prises en charge
- Applications Web Java
- Applications auxquelles vous accédez par le biais de l\'application Citrix Workspace
-
Applications virtuelles Citrix
Remarque : La version 2303 de Citrix Virtual Apps and Desktop est certifiée avec le Enregistreur package (version 2.16.0-20231101-165457 et ultérieures)
- Pour capturer avec précision ou automatiser des objets sur les applications SAP, nous vous recommandons d\'activer les scripts. Si les scripts ne sont pas activés, le message d\'invite suivant s\'affiche sous la fenêtre d\'exécution du robot :
Scripts SAP désactivés : activez les scripts pour des captures plus fiables.
Si vous n\'activez pas les scripts, au lieu d\'utiliser la technologie SAP, l\'Enregistreur utilise la technologie MSAA pour capturer les objets.
- Lors de l\'automatisation d\'une application Electron, l\'Enregistreur capture des contrôles spécifiques sur l\'application en utilisant par défaut la technologie Microsoft UI Automation (COM). Cela vous permet d\'automatiser les applications Electron en toute transparence sans avoir à capturer de nouveau l\'objet avec une technologie spécifique.
Prise en charge de Citrix XenApp
- Veillez à installer l\'Bot Agent sur le même serveur Citrix XenApp que celui à partir duquel vous lancez vos applications professionnelles.
- Lorsque vous lancez la Control Room en tant qu\'application XenApp, Automation Anywhere agent distant pour Citrix n\'est pas nécessaire.
Types de contrôles pris en charge
- Fenêtres contextuelles
- Boîtes de dialogue d\'alerte
- Boîtes de dialogue de confirmation
- Boîtes de dialogue d\'invite
Prise en charge interdomaine
Vous pouvez capturer et automatiser des objets à l\'intérieur d\'un IFrame interdomaine qui possède plusieurs IFrames avec la même source de cadre et des IFrames chargés dynamiquement au cours de l\'exécution dans les navigateurs Google Chrome et Microsoft Edge Chromium. Après avoir capturé un objet à l\'intérieur d\'un IFrame interdomaine, le chemin d\'accès au cadre est stocké dans la propriété FrameDOMXPath par défaut.
- Lorsque vous sélectionnez la propriété FrameDOMXPath dans les critères de recherche, ne modifiez pas sa valeur.
- Si vous supprimez la propriété FrameDOMXPath des critères de recherche, l\'Enregistreur ne parvient pas à identifier le cadre.
Automatiser les applications exécutées en tant qu\'utilisateur administrateur
Vous pouvez capturer des objets sur des applications qui s\'exécutent en tant qu\'administrateur en sélectionnant l\'option Capturer et exécuter avec des privilèges d\'administrateur à partir de l\'Éditeur de Bot.
- Bot Agent est installé dans le profil du système.
- Créateurs de Bot et Bot Runners ont des droits d\'administrateur sur le périphérique afin d\'automatiser les applications.
Pour éviter cette erreur, désélectionnez l\'option Capturer et exécuter avec des privilèges d\'administrateur de l\'Éditeur de Bot et exécutez l\'Enregistreur en mode non élevé pour capturer des applications Java ou SAP.
Automatiser les applications nécessitant un accès multi-utilisateurs
- Cette fonctionnalité est prise en charge pour l\'automatisation des applications web fonctionnant sur Google Chrome, Microsoft Edge et Microsoft Edge avec des navigateurs en mode IE.
- Cette fonctionnalité est prise en charge avec le Enregistreur package (version 3.2.1-20240606-105427 et versions ultérieures) et le Bot Agent (version 22.60.23 et versions ultérieures).
- Assurez-vous de capturer et d\'exécuter votre automatisation en mode élevé lorsque vous automatisez des applications de navigateur ouvertes avec d\'autres privilèges utilisateur.
- Lorsque votre Bot Agent est mis à jour, vous devez redémarrer votre application de navigateur.
- L\'option de délai d\'attente avancé n\'est actuellement pas prise en charge.
Automatisez les applications de bureau Chromium Embedded Framework (CEF)
Les développeurs utilisent un navigateur Chromium intégré dans leur application de bureau pour ajouter des fonctionnalités de navigateur Web à leur application de bureau. Enregistreur prend en charge l\'automatisation basée sur les objets de ces applications de bureau, garantissant ainsi une couverture d\'automatisation plus large.
Enregistreur détecte ces applications de bureau CEF comme technologie HTML.
- Tous les contrôles HTML existants et leurs actions correspondants sont pris en charge.
- Les applications CEF développées à l\'aide de la bibliothèque CEF Sharp et de WinForms sont prises en charge.
- Les IFrames inter-domaines sont pris en charge.
- L\'identification des éléments à l\'aide du sélecteur CSS est prise en charge. Reportez-vous à la rubrique Automatiser les applications web qui utilisent la norme Shadow DOM.
- L\'application CEF 32 bits n\'est actuellement pas prise en charge.
- Les applications CEF développées à l\'aide de WPF et des applications basées sur .net core ne sont actuellement pas prises en charge.
- L\'automatisation de plusieurs contrôles de navigateur dans une seule application CEF n\'est pas prise en charge.
- L\'automatisation des applications basées sur CEF avec Enregistreur génératif n\'est pas prise en charge.
- L\'option de délai d\'expiration avancé n\'est actuellement pas prise en charge pour les applications CEF.
- L\'automatisation des applications web qui utilisent la norme Shadow DOM n\'est pas prise en charge.
Automatisation des applications Java
Lors de l\'automatisation des commandes ayant des propriétés similaires dans des applications Java, par exemple les applications Oracle EBS, la propriété du chemin change de manière significative et n\'est donc pas fiable. Pour automatiser de manière fiable les commandes dans un tel scénario, utilisez la propriété d\'objet Occurrence.
- La propriété Occurrence ne fait pas partie des critères de recherche par défaut.
- La propriété Occurrence n\'est récupérée qu\'au cours de l\'exécution et non au moment de la capture.
- La valeur maximale de la propriété Occurrence dépend du nombre de commandes similaires visibles à l\'écran. Par exemple, si 15 commandes de type Description sont visibles à l\'écran, la valeur maximale de l\'occurrence est de 15. La valeur maximale de l\'occurrence reste définie sur 15, même si vous faites défiler les commandes à l\'écran.
- La valeur de l\'occurrence est comprise entre 1 et 999.
- Si le nom du cadre d\'un contrôle spécifique à l\'intérieur d\'un cadre interne est vide, la propriété Nom du cadre de l\'objet capturé apparaît vide et ne sera pas ajoutée comme critère de recherche par défaut.
- Si l\'objet ne se trouve pas à l\'intérieur d\'un cadre interne, la propriété n\'apparaît pas dans la liste.
- La propriété Nom du cadre prend en charge les caractères génériques et les variables.
- Nous vous recommandons d\'utiliser un caractère générique (*) pour identifier les objets de cadre interne, car le Nom du cadre peut changer pour certaines fenêtres.
- Pour vos automatismes existants, veillez à capturer de nouveau les contrôles si vous souhaitez utiliser les nouvelles propriétés.
- Notez que cette fonction n\'a aucun impact sur les robots existants, qui continuent à fonctionner sans changement.
Propriétés de l\'objet
- Vérifiez que les propriétés de l\'objet capturé correspondent à l\'objet prévu.
Par exemple, lorsque vous capturez un tableau à partir d\'un site Web, assurez-vous que les valeurs de Type de contrôle et de Balise HTML sont TABLEAU.
- Récupérez une valeur de propriété. Utilisez l\' Obtenir la propriété
action et saisissez le nom de la propriété dans le champ Nom de propriété ou sélectionnez une propriété d\'objet dans la liste des propriétés disponibles. La liste comprend les valeurs de propriété suggérées à partir des critères de recherche dans le tableau Propriétés de l\'objet. Pour sélectionner une propriété d\'objet dans la liste des propriétés, déplacez le pointeur de la souris à droite du champ Nom de propriété et cliquez sur la flèche.
Par exemple, pour récupérer le texte d\'un lien, utilisez l\' Obtenir la propriété action et saisissez HTML InnerText dans le champ Nom de propriété ou sélectionnez HTML InnerText dans la liste des propriétés.
- Vous pouvez sélectionner une combinaison de propriétés pour que le robot recherche l\'objet dans la fenêtre de votre application métier de manière unique.
La propriété de l\'objet supérieur est utilisée lorsque vous souhaitez utiliser les Clic, Clic droit, Double-clic, Définir le texte ou Obtenir la propriété actions.
Lors de la conception, l\'emplacement de l\'élément est déterminé en calculant les points du document à partir du haut (3) et de la gauche de la zone DOM (1). Par exemple, lorsque vous avez capturé l\'élément Nom, la valeur de la propriété SUPÉRIEURE a été enregistrée comme 131
, calculée à partir de la valeur supérieure (3) de DOM. Cependant, pendant l\'exécution, la valeur de la propriété TOP pour cet élément Last Name apparaît comme 216
. Cette divergence est due au fait qu\'au moment de l\'exécution, l\'extension calcule l\'emplacement de l\'élément à partir de la barre de navigation (2) au lieu de la valeur supérieure (3) de DOM.
Grâce à l\'algorithme de recherche du Enregistreur de l\'package, lorsque vous exécutez un robot, un objet n\'est capturé que si ses propriétés correspondent au critère de recherche exact que vous avez sélectionné dans le tableau Propriétés de l\'objet. Si les propriétés de l\'objet ne correspondent pas exactement au critère de recherche, alors le robot échoue avec un message d\'erreur. Toutefois, si le critère de recherche comprend un caractère générique, alors le robot capture le premier objet qui correspond au critère.
Par exemple, pour capturer une zone de texte à partir d\'une application qui a trois zones de texte nommées prénom1, prénom2 et prénom3, si vous sélectionnez Nom HTML comme critère de recherche, saisissez la valeur firstname dans le champ Nom HTML, puis exécutez le robot. Le robot échoue avec un message d\'erreur, car aucune zone de texte avec le nom HTML firstname n\'existe. Cependant, dans le champ Nom HTML, si vous saisissez firstname* et que vous exécutez le robot, alors le robot capture la première zone de texte qui correspond au critère.
Actions effectuées sur les objets capturés
Traitement en arrière-plan
- Cliquer
- Définir le texte
- Obtenir le texte
Enregistrement sécurisé
Lorsque vous enregistrez une tâche en mode d\'enregistrement sécurisé, la fenêtre Aperçu affiche temporairement une image de la zone capturée. Cette image est masquée lorsque vous quittez la fenêtre de l\'Éditeur de Bot ou l\'actualisez.
- Cette fonctionnalité est prise en charge avec le Enregistreur package (version 3.2.1-20240606-105427 et versions ultérieures) et le Bot Agent (version 22.60.23 et versions ultérieures).
- Si vous souhaitez utiliser cette option dans votre automatisation existante, vous devez recapturer les contrôles.
- La valeur des propriétés Gauche, Droite, Hauteur et Largeur ne sera pas supprimée.
Des privilèges d\'administrateur sont requis pour activer ce paramètre. Reportez-vous à la rubrique Configurer les paramètres.
Prise en charge du proxy
Si votre périphérique est configuré pour utiliser un proxy, toutes les demandes sortantes à partir du package sont acheminées via le serveur proxy. Reportez-vous à la rubrique Connecter l'Bot Agent à un périphérique avec un proxy.
Cas d\'utilisation de l\'enregistreur
Utilisez ces exemples de tâches pour vous familiariser avec l\'utilisation de l\'enregistreur pour la construction de robots.