UI Explorer

UiExplorer est un outil avancé qui permet de créer un sélecteur personnalisé pour un élément d'interface utilisateur donné. Il est disponible en tant qu'outil autonome que vous pouvez télécharger à partir du Centre de ressources dans votre instance Automation Cloud, ou à partir de Studio uniquement si le package UiPath.UIAutomation.Activities est installé en tant que dépendance du projet.

Using UI Explorer as a standalone tool does not require you to install Studio. This comes in handy when you want to make sure that an application can be automated with selectors. It enables you to simply inspect elements without building a process. The standalone package also contains the utility, thus making it possible to install browser extensions and the JavaBridge to inspect elements across all your automation needs.

Pour ouvrir la fenêtre UI Explorer, cliquez sur le bouton dans la section Sélecteurs, dans l'onglet Conception, ou depuis l'éditeur avancé dans l'écran de sélection de tous les sélecteurs des attributs cible et ancres après avoir indiqué l'élément d'IU cible.

Remarque : si vous n'avez aucun pack UiPath.UIAutomation.Activities installé comme dépendance pour le projet actuel, le bouton UI Explorer ne s'affiche pas dans le Ruban (Ribbon).

Sinon, UI Explorer (UI Explorer) peut être lancé sur la page Outils (Tools) en mode Backstage de Studio. UI Explorer depuis le menu contextuel utilise les bibliothèques d'UI Automation livrées avec la version actuelle de Studio.

Remarque : la version du package UIAutomation actuellement utilisée s'affiche dans le coin inférieur droit de l'UI Explorer que vous avez ouvert. Cette version varie, car le lancement d'UI Explorer à partir de la page Outils (Tools) utilise la version par défaut d'UI Automation livrée avec la version de Studio que vous utilisez, tandis que l'ouverture d'UI Explorer à partir du ruban utilise la version que vous avez installée en tant que dépendance pour le projet en cours.

Pour choisir le sélecteur le plus adapté, souvenez-vous des conseils suivants :

• Ajoutez ou supprimez des attributs
• Ajoutez des balises parent ou enfants

• Utilisez des caractères génériques pour remplacer des valeurs changeantes

  
  

  

  
  

Description des champs de la fenêtre UI Explorer

Champ	Description
Valider	Le bouton indique l'état du sélecteur en vérifiant la validité de la définition de sélecteur et la visibilité de l'élément cible à l'écran. Le bouton Valider a trois états : Sélecteur en cours de validation Sélecteur valide Sélecteur non valide Sélecteur modifié, revalider
Indiquer l'élément (Indicate Element)	Indique un nouvel élément d'IU pour remplacer le précédent.
Indiquer l'ancre	Permet de choisir une ancre par rapport à l'élément d'IU cible.
Réparer (Repair)	Permet d'indiquer à nouveau le même élément d'IU cible et de réparer le sélecteur. Cette opération ne remplace pas complètement le sélecteur précédent. Le bouton est uniquement disponible lorsque le sélecteur n'est pas valide.
Mettre en surbrillance (Highlight)	Met l'élément cible au premier plan. Il reste surligné jusqu'à ce qu'il soit désactivé. Le bouton est uniquement activé si le sélecteur est valide.
Inspecter les événements	Ouvre l'outil d'inspection d'événement.
Options	Contient plusieurs options : Infrastructure d’IU (UI Frameworks) - Ce champ permet de changer la technologie utilisée pour définir les éléments de l'interface utilisateur ainsi que leurs sélecteurs. Les options suivantes sont disponibles : Les options suivantes sont disponibles : Par défaut (Default) : Méthode propriétaire UiPath. Fonctionne généralement très bien avec tous les types d'interfaces utilisateur. Essayez d'abord de générer un sélecteur en utilisant les extensions ou les connecteurs UiPath appropriés (ex. : extension navigateur/à distance/Java, connecteur SAP, etc.). Si ce n'est pas possible, essayez de générer un sélecteur à l'aide d'Active Accessibility (solution privilégiée pour la plupart des applications de bureau) ou UI Automation (pour les applications Office). Active Accessibility : une solution antérieure de Microsoft pour rendre les applications accessibles. Il est recommandé d'utiliser cette option avec le logiciel existant, lorsque celle par défaut ne fonctionne pas. Essayez de générer un sélecteur à l'aide d'Active Accessibility et ignorez les extensions ou les connecteurs UiPath. Pour savoir si un sélecteur utilise la technologie Active Accessibility, vous devez trouver les balises ctrl. Plus précisément, il s'agit de la sous-chaîne <ctrl. Dans XAML, cela peut être encodé en tant que &lt;ctrl. UI Automation  : il s'agit du modèle d'accessibilité amélioré de Microsoft. Il est conseillé d'utiliser cette option dans le cadre d'applications plus récentes si l'option par défaut ne fonctionne pas. Essayez de générer un sélecteur à l'aide d'UI Automation et ignorez les extensions ou les connecteurs UiPath. Remarque : cette infrastructure ne prend actuellement pas en charge les pages Web Chrome ou Edge ; à la place, elle génère des sélecteurs wnd plutôt que de revenir à l'extension. Cliquez ici pour en savoir plus sur Active Accessibility et UI Automation. Restauration différée (Delayed Restore) - Différez la restauration de la fenêtre UiExplorer jusqu’au chargement des données du sélecteur. Utilisez cette option pour indiquer les éléments d’IU qui se ferment automatiquement en cas de perte de focus, tels que les listes déroulantes ou les fenêtres superposées. Sélecteur de déclencheur (Trigger Selector) - Assure le caractère unique d’un élément d’IU dans son parent tout en améliorant la précision du suivi. Utilisez cette option lorsque vous générez des sélecteurs pour les activités de déclencheur.

L'arborescence visuelle

Ce panneau affiche une arborescence représentant la hiérarchie de l'interface utilisateur : il est possible de l'inspecter en cliquant sur les flèches situées devant chaque nœud.

Par défaut, lors de la première ouverture d'UI Explorer, ce panneau affiche toutes les applications ouvertes, par ordre alphabétique.

Il suffit de double-cliquer sur un élément de l'interface utilisateur dans l'arborescence, ou de faire un clic-droit avec la souris puis de sélectionner l'option Définir comme élément cible (Set as Target Element) pour remplir les modules Éditeur de sélecteur (Selector Editor), Attributs du sélecteur (Selector Attributes) et Explorateur des propriétés (Property Explorer).

Champ	Description
Mettre en surbrillance (Highlight)	Surligne l'élément sélectionné en temps réel depuis l'arborescence visuelle. Il reste surligné jusqu'à ce qu'il soit désactivé.
Afficher les options de recherche	Affiche le champ de recherche et les filtres de recherche disponibles.
Champ de recherche	Vous permet de rechercher une chaîne spécifique. Si une correspondance exacte n’est pas trouvée, les nœuds contenant la correspondance la plus proche s'afficheront. Les caractères génériques sont pris en charge. Selon l’attribut sélectionné dans la liste de recherche par liste déroulante, la recherche peut être sensible à la casse. Note : La recherche ne recherche des correspondances que dans la structure arborescente sous l’objet d’IU sélectionné.
Rechercher par	Filtre votre recherche vers un attribut sélectionné ou un sélecteur. Le contenu de cette liste déroulante change en fonction de l’élément d’IU sélectionné. Remarque : si Rechercher par est défini sur Sélecteur, vous ne pouvez saisir qu’un nœud dans le format <attribute name1='value1' ... />.
Enfants uniquement	Limite la recherche aux éléments enfants de premier niveau du nœud sélectionné. Par défaut, cette case n'est pas cochée.

Le module Éditeur de sélecteur

Ce panneau permet d'afficher et de modifier le sélecteur d'un objet d'interface utilisateur donné.

Le fragment XML qui doit être utilisé dans le projet apparait dans la partie inférieure du module. Une fois que vous avez trouvé le sélecteur de votre choix, vous pouvez le copier à partir de ce module et le coller dans le champ Sélecteur (Selector) du module Propriétés (Properties) d'une activité.

La partie supérieure de ce panneau permet d'afficher tous les nœuds dans un sélecteur et de supprimer ceux qui ne sont pas nécessaires en décochant la case en face d'eux. Un élément de la liste de nœuds du sélecteur devient actif lorsque vous activez ou désactivez un attribut, ou lorsque vous modifiez un sélecteur dans le panneau inférieur. Seul un nœud est actif à la fois.

Les attributs du nœud sélectionné apparaissent dans les modules Attributs du sélecteur (Selector Attributes) et Explorateur des propriétés (Property Explorer).

Vous pouvez également modifier les sélecteurs à l'aide de variables, soit en utilisant le raccourci clavier CTRL+K pour créer une variable dans le sélecteur proprement dit, ou en spécifiant une variable déjà créée avec la combinaison CTRL+Space. L'utilisation du raccourci clavier CTRL+K permet de spécifier une valeur et un nom pour la variable. Veuillez noter que seules les variables string peuvent être utilisées.

Le module Attributs du sélecteur

Ce module affiche tous les attributs disponibles pour un nœud sélectionné à partir de l'Éditeur de sélecteur (Selector Editor).

Il suffit de cocher ou de décocher les attributs de nœud pour les ajouter ou de les supprimer.

La valeur de chaque attribut peut également être modifiée, mais la modification n'est enregistrée qu'à condition que le nouveau sélecteur soit lié à l'objet d'interface utilisateur d'origine.

Le module Explorateur des propriétés

Ce panneau liste l'ensemble des attributs possibles pour un objet d'interface utilisateur donné, y compris ceux qui n'apparaissent pas dans le sélecteur. Ils ne peuvent pas être modifiés.

Outil d'inspection d'événement

Dans le contexte de l'automatisation Attended basée sur un déclencheur, l'outil d'inspection d'événement peut être utilisé pour identifier le type d'événements natifs déclenchés lorsque vous interagissez avec certains éléments d'IU dans une application, puis pour configurer l'activité Déclencheur d'événement d'application (Application Event Trigger). L'outil capture et surveille tous les types d'événements sélectionnés, tels que Clic (Click), Touche enfoncée (Key pressed), Focus atteint (Focus gained), Focus perdu (Focus lost) et autres interactions pertinentes, vous permettant d'analyser les actions effectuées et, le cas échéant, de diagnostiquer les problèmes.

L'outil d'inspection d'événement peut être ouvert à partir de UI Explorer, une fois qu'un élément d'IU valide est sélectionné, en cliquant sur le bouton Inspecter les événements (Inspect Events) de la barre d'outils.

La barre d'outils se compose des options suivantes :

• Enregistrer (Record) : les événements générés par l'interaction avec l'élément d'IU sont enregistrés et ajoutés à la liste des événements.
• Suspendre (Pause) : les événements générés par l'élément d'IU lorsque vous interagissez avec lui ne sont plus enregistrés.
• Surbrillance (Highlight) : affiche le contour de l'élément cible et le met au premier plan pendant quelques secondes. Il reste surligné jusqu'à ce qu'il soit désactivé.
• Ouvrir dans UI Explorer (Open in UI Explorer) : l'élément surveillé est ouvert dans UI Explorer, d'où vous pouvez observer le sélecteur de cet élément.

Une fois que vous avez démarré l'enregistrement de l'événement, deux autres options deviennent disponibles :

• Effacer (Clear) : supprime tous les événements enregistrés.
• CSV : les événements capturés peuvent être exportés vers un fichier .csv pour une analyse plus approfondie.

La fenêtre de l'outil d'inspection d'événement comporte deux sections principales :

• Filtre d'événements (Event filter) : permet de sélectionner les types d'événements que vous souhaitez surveiller pour l'élément cible.
• Liste des événements (Event list) : affiche des informations sur les événements capturés.

Vous pouvez filtrer les types d'événement à capturer en activant ou cochant ou décochant les cases dans la liste des types d'événement. La liste peut varier en fonction de la technologie d'élément sélectionnée.

Tous les types d'événements de souris (Souris déplacée (Mouse Move), Souris enfoncée (Mouse pressed), Souris relâchée (Mouse released), Souris entrée (Mouse entered), Souris sortie (Mouse exited)), spécifiques aux éléments d'IU Web ou Java, sont désactivés par défaut car la liste d'événements, dans de tels cas, peut devenir assez volumineuse. Nous vous recommandons de n'activer les types d'événements de souris que si vous avez un besoin spécifique de les surveiller.

Il convient également de mentionner que les types d'événements peuvent être activés ou désactivés même après avoir commencé l'enregistrement de l'événement.

La liste des événements comporte trois colonnes :

• Nom de l'événement (Event Name) : le type d'événement.
• Horodatage (Time Stamp) : la date et l'heure auxquelles l'événement a eu lieu.
• Données de l'événement (Event Data) : les données et paramètres associés à un événement donné.

Chaque colonne peut être triée par ordre croissant ou décroissant. Les événements s'affichent par défaut dans l'ordre dans lequel ils ont eu lieu.

Lorsque le type d'événement Disparu (Disappeared) est trouvé, vous ne pouvez plus continuer la surveillance et un message d'erreur s'affiche à l'écran. Lorsque vous cliquez sur une option de la barre d'outils, le même message d'erreur s'affiche à l'écran. Les seules options disponibles consistent à effacer les données ou à les exporter vers un fichier .csv. Pour reprendre la surveillance, fermez la fenêtre et ouvrez une autre instance de l'outil d'inspection d'événement.