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.

L’utilisation d’UI Explorer comme outil autonome ne vous oblige pas à installer Studio. Cela peut être utile lorsque vous voulez vous assurer qu’une application peut être automatisée avec des sélecteurs. Cela vous permet simplement d’inspecter les éléments sans construire de processus. Le package autonome contient également l’utilitaire SetupExtensions, ce qui permet d’installer des extensions de navigateur et le JavaBridge pour inspecter les éléments à travers tous vos besoins d’automatisation.

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.
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.