Package de l\'Recorder
- Dernière mise à jour2025/09/11
Package de l\'Recorder
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\'Recorder 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 bot.
Avantages de l\'utilisation du Recorder 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 bot recherche pendant l\'exécution.
- Si la fenêtre d\'exécution de l\'Recorder chevauche l\'objet que vous voulez automatiser, alors l\'Recorder masque la fenêtre d\'exécution avant que vous n\'automatisiez l\'objet.
- L\'Recorder prend en charge des actions dans les If Loop, Wait et packages qui permettent de vérifier si un objet existe dans le navigateur ou la fenêtre spécifique.
Capturer à l\'aide du Recorder
- L\'action Capturer remplace la commande Object Cloning de 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 Recorder 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 Recorder 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 Recorder 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.
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. Cela améliore l\'expérience utilisateur et la fiabilité de l\'automatisation lorsqu\'il y a un panneau supérieur fixe sur la page web et si certaines actions physiques comme les clics de souris ne fonctionnent pas comme prévu.
Utilisez l\' action pour automatiser les objets avec succès lorsque les identifiants de votre périphérique sont saisis au format UPN.
Lorsque les applications web subissent des changements fréquents et sont dynamiques par nature, utilisez Generative Recorder pour les automatiser. Reportez-vous à la rubrique Generative Recorder.
Automatisation Web du navigateur Safari sur la plateforme macOS
Recorder prend en charge l\'automatisation sur le navigateur Safari en fournissant une automatisation basée sur les objets des applications web sur les plateformes macOS. Safari étant le navigateur par défaut des utilisateurs de macOS, cette fonctionnalité améliorera l\'adoption et la couverture de l\'automatisation, permettant aux utilisateurs de macOS d\'automatiser les applications web. Le Recorder permet une interaction directe avec les éléments web de Safari, tels que les boutons, les formulaires et les liens, sans avoir besoin de plugins tiers.
- La propriété Type de navigateur dans les Propriétés de l\'objet affiche Apple Safari.
- Le champ Application du navigateur affiche Apple Safari.
- Pendant l\'enregistrement, la fenêtre du navigateur Safari apparaît dans la liste des fenêtres, groupée avec d\'autres navigateurs tels que Google Chrome et Microsoft Edge.
Technologies prises en charge par macOS
- Technologie HTML (Google Chrome uniquement)
- Technologie d\'accessibilité macOS
La nouvelle technologie d\'accessibilité macOS améliore les capacités d\'automatisation en tirant parti des fonctionnalités d\'accessibilité intégrées de macOS. Cette technologie permet à l\'Enregistreur d\'interagir directement avec les éléments de l\'interface utilisateur des applications sur macOS. Elle peut effectuer des actions telles que cliquer sur des boutons, saisir du texte et lire des valeurs à l\'écran, ce qui est essentiel pour créer des scripts d\'automatisation.
De plus, la technologie d\'accessibilité macOS prend en charge un large éventail de saisies clavier spécifiques à macOS, y compris les touches de fonction et les combinaisons de touches spéciales, ce qui vous permet de créer, d\'effectuer des essais et de déployer des automatisations efficacement.
Voir pour une liste des propriétés capturées par l\'Enregistreur afin d\'identifier efficacement les éléments de l\'interface utilisateur.
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 Recorder packages.
- Sélectionnez le Recorder 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-la en tant qu\'administrateur.
- Saisissez C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\ suivi de la version du Recorder 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 Recorder package (version 2.16.0-20231101-165457 et ultérieure)
- 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 bot :
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\'Recorder utilise la technologie MSAA pour capturer les objets.
- Lors de l\'automatisation d\'une application Electron, le Recorder 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.
- Microsoft Active Accessibility (MSAA)
- Microsoft UI Automation
- Automatisation Microsoft COM UI
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 remote agent for Citrix n\'est pas nécessaire.
- Les automatisations créées avec d\'anciennes versions du package sont entièrement compatibles avec la nouvelle version 3.5.2 de l\'agent distant. Vous pouvez continuer à exécuter vos automatisations existantes sans qu\'aucune modification ne soit nécessaire.
- Lorsque vous utilisez le package (version 5.0.5-20250903-100026 ou ultérieure) avec l\'ancien agent distant, vos automatisations fonctionneront de la même manière qu\'avec la version précédente de l\'agent distant.
Cela garantit la compatibilité entre différents package et versions de l\'agent à distance, afin que vous puissiez effectuer des mises à jour en toute confiance et maintenir des performances d\'automatisation cohérentes.
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 Chromium Google Chrome et Microsoft Edge. 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 la valeur de cette propriété.
- Si vous supprimez la propriété FrameDOMXPath des critères de recherche, le Recorder 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\'Bot editor.
- Bot Agent est installé dans le profil du système.
- Bot Creators 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\'Bot editor et exécutez l\'Recorder 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 les navigateurs Google Chrome, Microsoft Edge et Microsoft Edge en mode IE.
- Cette fonctionnalité est prise en charge avec le Recorder package (version 3.2.1-20240606-105427 et ultérieure) et l\'Bot Agent (version 22.60.23 et ultérieure).
- 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\'expiration 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. Recorder prend en charge l\'automatisation basée sur les objets de ces applications de bureau, garantissant ainsi une couverture d\'automatisation plus large.
Recorder détecte ces applications de bureau CEF comme technologie HTML.
Pour exécuter un extrait JavaScript ou appeler une fonction JavaScript dans les applications CEF de bureau, voir action Exécuter JavaScript | Appeler une fonction JavaScript action.
- Tous les contrôles HTML existants et leurs actions correspondantes 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 Automate web apps that use the shadow DOM standard.
- 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 Generative Recorder 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.
Automatiser 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îtra 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 bots existants, qui continuent à fonctionner sans changement.
Propriétés d\'objet
- Vérifiez que les propriétés d\'objet capturées correspondent à votre objet prévu.
Par exemple, lorsque vous capturez un tableau depuis 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 le Obtenir la propriété
action et saisissez le nom de la propriété dans le champ Nom de la 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 d\'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 la 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 bot recherche l\'objet dans la fenêtre de votre application métier de manière unique.
La propriété d\'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 propriété TOP a été enregistrée comme 131, calculée à partir de la valeur supérieure (3) du DOM. Cependant, pendant l\'exécution, la valeur de propriété TOP pour cet élément Nom de famille 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 Recorder de l\'package, lorsque vous exécutez un bot, 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 bot échoue avec un message d\'erreur. Toutefois, si le critère de recherche comprend un caractère générique, alors le bot 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, entrez la valeur prénom dans le champ Nom HTML, puis exécutez le bot, le bot échoue avec un message d\'erreur, car aucune zone de texte avec le nom HTML prénom n\'existe. Cependant, dans le champ Nom HTML, si vous entrez prénom* et que vous exécutez le bot, alors le bot 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\'Bot editor ou l\'actualisez.
- Cette fonctionnalité est prise en charge avec le Recorder package (version 3.2.1-20240606-105427 et ultérieure) et l\'Bot Agent (version 22.60.23 et ultérieure).
- 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.
Un utilisateur disposant de privilèges d\'administrateur doit activer ce paramètre. Reportez-vous à la rubrique Configurer les paramètres.
Prise en charge de proxy
Si votre appareil est configuré pour utiliser un proxy, toutes les demandes sortantes à partir de ce 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 bots.