- Vue d'ensemble (Overview)
- Automatisation de l'interface utilisateur
- Applications et technologies automatisées avec UI Automation
- Compatibilité du projet
- UI-ANA-016 - Extraire l'URL ouverte du navigateur
- UI-ANA-017 - ContinuerSurErreur (ContinueOnError) True
- UI-ANA-018 - Répertorier les activités d'OCR/d'image
- UI-DBP-006 - Utilisation du conteneur
- UI-DBP-013 - Utilisation abusive de l’automatisation Excel
- UI-DBP-030 - Utilisation de variables interdites dans les sélecteurs
- UI-PRR-001 - Simuler un clic
- UI-PRR-002 - Type de simulation
- UI-PRR-003 - Ouverture d'une utilisation abusive de l'application
- UI-PRR-004 - Délais codés en dur
- UI-REL-001 - Idx volumineux dans les sélecteurs
- UI-SEC-004 - Données d’e-mail du sélecteur
- UI-SEC-010 - Restrictions d'applications/d'URL
- UI-USG-011 - Attributs non autorisés
- UX-SEC-010 - Restrictions d'applications/d'URL
- UX-DBP-029 - Utilisation d'un mot de passe non sécurisé
- UI-PST-001 - Niveau du journal d'audit dans les paramètres du projet
- Outil de migration de navigateur UiPath
- Zone de détourage
- Enregistreur d'application/Web
- Configuration avancée du descripteur
- Extraction des éléments d'IU
- Extraction de table
- Robots Linux
- Connexion au navigateur UI Automation
- Enregistreur de Computer Vision
- Activities index
- Activer (Activate)
- Base d'ancrage (Anchor Base)
- Lier à un navigateur (Attach Browser)
- Lier à une fenêtre (Attach Window)
- Block User Input
- Légende (Callout)
- Vérifier (Check)
- Cliquer (Click)
- Cliquer sur l'image (Click Image)
- Déclencheur de clic image (Click Image Trigger)
- Cliquer sur le texte OCR (Click OCR Text)
- Cliquer sur le texte (Click Text)
- Déclencheur de clic (Click Trigger)
- Fermer l'application (Close Application)
- Fermer l'onglet (Close Tab)
- Fermer la fenêtre (Close Window)
- Context Aware Anchor
- Copier le texte sélectionné (Copy Selected Text)
- Element Attribute Change Trigger
- Élément existant (Element Exists)
- Étendue de l'élément (Element Scope)
- Element State Change Trigger
- Export UI Tree
- Extraire les données structurées (Extract Structured Data)
- Rechercher les enfants (Find Children)
- Rechercher l'élément (Find Element)
- Rechercher l'image (Find Image)
- Rechercher les correspondances de l'image (Find Image Matches)
- Rechercher une position de texte OCR (Find OCR Text Position)
- Rechercher l'élément relatif (Find Relative Element)
- Rechercher la position du texte (Find Text Position)
- Obtenir la fenêtre active (Get Active Window)
- Obtenir l'ancêtre (Get Ancestor)
- Obtenir l'attribut (Get Attribute)
- Obtenir les infos de l'événement (Get Event Info)
- Récupérer du presse-papiers (Get From Clipboard)
- Obtenir le texte complet (Get Full Text)
- Obtenir le texte OCR (Get OCR Text)
- Récupérer le mot de passe (Get Password)
- Obtenir la position (Get Position)
- Obtenir l'élément source (Get Source Element)
- Obtenir le texte (Get Text)
- Obtenir le texte visible (Get Visible Text)
- Revenir en arrière (Go Back)
- Avancer (Go Forward)
- Accéder à l'accueil (Go Home)
- Google Cloud Vision OCR
- Masquer la fenêtre (Hide Window)
- Mettre en surbrillance (Highlight)
- Déclencheur de raccourci (Hotkey Trigger)
- Pointer (Hover)
- Pointer sur l'image (Hover Image)
- Pointer sur le texte OCR (Hover OCR Text)
- Pointer sur le texte (Hover Text)
- Image existante (Image Exists)
- Indiquer sur l'écran (Indicate On Screen)
- Injecter du code .NET
- Inject Js Script
- Invoquer la méthode ActiveX
- Déclencheur de pression de touche (Key Press Trigger)
- Charger l'image (Load Image)
- Agrandir la fenêtre (Maximize Window)
- Microsoft Azure ComputerVision OCR
- Reconnaissance optique des caractères Microsoft (Microsoft OCR)
- Microsoft Project Oxford Online OCR
- Réduire la fenêtre (Minimize Window)
- Surveiller les événements (Monitor Events)
- Déclencheur de souris (Mouse Trigger)
- Déplacer la fenêtre (Move Window)
- Accéder à (Navigate To)
- Texte OCR existant (OCR Text Exists)
- Sur affichage de l'élément (On Element Appear)
- Sur disparition de l'élément (On Element Vanish)
- Sur apparition de l'image (On Image Appear)
- Sur disparition de l'image (On Image Vanish)
- Ouvrir l'application (Open Application)
- Ouvrir le navigateur (Open Browser)
- Actualiser le navigateur (Refresh Browser)
- Relire l'événement utilisateur (Replay User Event)
- Restaurer la fenêtre (Restore Window)
- Enregistrer l'image (Save Image)
- Sélectionner l'élément (Select Item)
- Sélectionner plusieurs éléments (Select Multiple Items)
- Envoyer le raccourci (Send Hotkey)
- Définir la zone de détourage (Set Clipping Region)
- Définir le focus (Set Focus)
- Définir le texte (Set Text)
- Placer dans le presse-papiers (Set To Clipboard)
- Définir l'attribut Web (Set Web Attribute)
- Afficher la fenêtre (Show Window)
- Déclencher le processus (Start Process)
- Déclencheur système (System Trigger)
- Prendre une capture d'écran (Take Screenshot)
- Tesseract OCR
- Texte existant (Text Exists)
- Info-bulle
- Saisir dans (Type Into)
- Saisir un texte sécurisé (Type Secure Text)
- Utiliser le premier plan
- Attendre un attribut (Wait Attribute)
- Attendre que l'élément disparaisse (Wait Element Vanish)
- Attendre que l'image disparaisse (Wait Image Vanish)
- Application event trigger
- Check/Uncheck
- Check App State
- Check Element
- Cliquer (Click)
- Click Event Trigger
- Glisser et déposer
- Extract Table Data
- For Each UiElement
- Obtenir l'attribut (Get Attribute)
- Get Browser Data
- Obtenir le texte (Get Text)
- Get URL
- Go To URL
- Mettre en surbrillance (Highlight)
- Pointer (Hover)
- Inject Js Script
- Raccourcis clavier
- Keypress Event Trigger
- Mouse scroll
- Navigate Browser
- Sélectionner l'élément (Select Item)
- Set Browser Data
- Définir le navigateur du runtime (Set Runtime Browser)
- Définir le texte (Set Text)
- Prendre une capture d'écran (Take Screenshot)
- Saisir dans (Type Into)
- Use Application/Browser
- Joindre
- Vérifier (Check)
- Cliquer (Click)
- Glisser et déposer
- Extraire des données
- Obtenir l'attribut (Get Attribute)
- ObtenirEnfants
- ObtenirCibleRuntime
- GetText
- Get URL
- GoToUrl
- Mettre en surbrillance (Highlight)
- Pointer (Hover)
- IsEnabled
- Raccourci clavier
- Mouse scroll
- Ouvrir
- Sélectionner l'élément (Select Item)
- Prendre une capture d'écran (Take Screenshot)
- Saisir dans (Type Into)
- ÉtatAttente
- Effectuez une recherche par navigateur et récupérez les résultats à l'aide des API UI Automation
- Navigation sur le Web
- Rechercher des images
- Cliquer sur des images
- Déclencher et surveiller des événements
- Créer et remplacer des fichiers
- Pages HTML : extraire et manipuler des informations
- Manipulation des fenêtres
- Sélection de liste automatisée
- Rechercher et manipuler des éléments de fenêtre
- Gérer l'automatisation du texte
- Charger et traiter des images
- Gérer les actions activées par la souris
- Automatiser l'exécution des applications
- Exécution automatisée d'une application locale
- Navigation avec le navigateur
- Automatisation Web
- Exemple de fonctionnalités du déclencheur
- Activer la prise en charge d’UI Automation dans DevExpress
- Computer Vision Local Server
- Automatisation mobile
- Notes de publication
- Compatibilité du projet
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Installer l'application
- Gérer l'application actuelle
- Gérer une autre application
- Ouvrir DeepLink
- Ouvrir l'URL
- Mobile Device Connection
- Balayer directionnel
- Dessiner un modèle
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Prendre une capture d'écran (Take Screenshot)
- Prendre une partie de capture d'écran
- Élément existant (Element Exists)
- Execute Command
- Obtenir l'attribut (Get Attribute)
- Get Selected Item
- Obtenir le texte (Get Text)
- Set Selected Item
- Définir le texte (Set Text)
- Balayer
- Tap
- Saisir texte
- Terminal
- Notes de publication
- À propos du package d'activités Terminal
- Compatibilité du projet
- Meilleures pratiques
- Rechercher un texte (Find Text)
- Get Color At Position
- Obtenir la position du curseur (Get Cursor Position)
- Obtenir le champ (Get Field)
- Obtenir le champ en position (Get Field at Position)
- Accéder à la zone d'écran (Get Screen Area)
- Obtenir le texte (Get Text)
- Obtenir le texte en position (Get Text at Position)
- Déplacer le curseur (Move Cursor)
- Move Cursor to Text
- Envoyer la touche Contrôle (Send Control Key)
- Envoyer les touches (Send Keys)
- Envoyer les touches en toute sécurité (Send Keys Secure)
- Définir le champ (Set Field)
- Définir le champ en position (Set Field at Position)
- Session de terminal (Terminal Session)
- Attendre le texte de champ (Wait Field Text)
- Attendre le texte d'écran (Wait Screen Text)
- Attendre le texte en position (Wait Text at Position)
Activités UIAutomation
Configuration avancée du descripteur
Pour plus d'informations sur l'utilisation des fonctionnalités plus avancées de l'écran de sélection, regardez la vidéo ci-dessous.
L'indication d'une cible peut produire des doublons, qui sont d'autres éléments d'IU qui sont perçus comme extrêmement similaires à l'élément d'IU cible et qui peuvent entraîner l'échec de l'automatisation au moment de l' Runtime. Lorsque des doublons sont trouvés, ils sont mis en surbrillance en jaune et comportent un libellé au-dessus d'eux contenant une lettre qui correspond à la méthode de ciblage qui a trouvé chaque doublon :
- S - Sélecteur strict
- F - Sélecteur approximatif
- CV – Computer Vision
- I - Image
L’un des meilleurs moyens d’éviter les doublons consiste à indiquer une ancre.
Pour créer un descripteur fiable, il est recommandé d’indiquer une ancre après l’indication de la cible.
Une ancre est un autre élément à proximité qui permet d'identifier uniquement la cible. Lorsque vous indiquez une cible, UiPath tente d’identifier et de sélectionner automatiquement une ancre. Vous pouvez également ajouter manuellement trois ancres maximum.
Si seul le Sélecteur strict est activé comme méthode de ciblage, les ancres ne sont pas utilisées.
Les ancres sont utiles lorsqu’un élément cible n’est pas unique. Par exemple, un formulaire dans une application de bureau contient généralement plusieurs zones de texte similaires dans lesquelles saisir diverses données. Pour identifier les données à saisir dans chacune d’elles, vous regardez les libellés à côté d’elles. De même, lorsque le libellé d’une zone de texte est ajouté comme ancre, le robot utilise l’ancre pour identifier la zone de texte dans laquelle saisir du texte.
Plusieurs ancres sont parfois nécessaires pour distinguer une cible d’autres éléments similaires appelés doublons. Par exemple, si un formulaire contient des sections pour l’adresse de facturation et l’adresse d’expédition, les zones de texte dans ces sections apparaissent deux fois avec le même libellé, de sorte que vous devez ajouter à la fois les libellés (p. ex., Code postal ») et le titre de la section (p. ex., « Adresse de facturation ») comme ancres pour identifier la bonne zone de texte.
Les ancres peuvent être trouvées via différents scénarios, tel que cela est décrit ci-dessous :
Après avoir indiqué une cible, une tentative est effectuée pour identifier automatiquement une ancre pour celle-ci.
Dans cette section, vous pouvez découvrir plus de détails techniques sur la méthode selon laquelle cette recherche est effectuée.
Une fois qu’une cible est indiquée, le type de l’élément d’IU indiqué est identifié. Les éléments et directions suivants sont recherchés :
- Bouton - à l'intérieur de l'élément.
- Case à cocher - à droite de l'élément.
- Liste déroulante - à gauche et au-dessus de l'élément.
- Zone de saisie - à gauche et au-dessus de l'élément. Dans le cas de l'automatisation du navigateur, le libellé est également recherché à l'intérieur de la zone de saisie, à la recherche de l'attribut
AreaLabeledBy
. Si ce libellé n'est pas identifié, un élément avec lestag=label
etfor='id of the input box'
est recherché. - Bouton radio : à droite de l'élément.
- Image - à droite et en dessous de l'élément.
Selon le type d'élément identifié, une ancre correspondante est automatiquement recherchée pour l'élément.
Une ancre identifiée automatiquement se présente sous la forme d'un élément de texte qui est toujours présent à proximité de l'élément cible et peut donc être utilisé pour identifier l'élément au moment de l' Runtime avec plus de précision.
Si aucune des directions ci-dessus ne fournit de résultats, un cas générique est utilisé, qui recherche dans la hiérarchie des éléments une ancre appropriée.
Dans cette situation, vous pouvez sélectionner manuellement une ancre pour votre élément cible. Lorsque vous survolez un autre élément, il est surligné en bleu et connecté par une ligne à la cible que vous avez sélectionnée. Pour sélectionner l'ancre souhaitée, vous pouvez simplement cliquer sur le texte que vous souhaitez utiliser comme ancre.
Vous pouvez également modifier un élément spécifique (qu'il s'agisse d'une cible ou d'une ancre) en accédant au menu qui s'affiche lorsque vous survolez l'élément cible. Ce menu comporte plusieurs options :
Le ferme le processus d'indication et enregistre les modifications que vous avez apportées.
Le vous permet de cibler des éléments indépendamment de leur contenu textuel spécifique. Cela peut être utile lorsque vous essayez de sélectionner le premier élément d’une liste de recherche lorsque vous ne savez pas exactement avec quoi la liste va être remplie, ou lorsque vous interagissez avec un élément dynamique dont le libellé est modifié pour diverses raisons. L’utilisation de cette fonctionnalité lors de l’indication d’une cible utilise uniquement la méthode du Sélecteur de correspondances approximatives pour l’identification, et ôte le sélecteur de correspondances approximatives pour s’assurer que l’élément est toujours ciblé, indépendamment des modifications de l’étiquette.
En cliquant sur bouton, vous pouvez sélectionner un élément d'IU adjacent qui agira comme ancre supplémentaire. Vous pouvez indiquer jusqu'à trois ancres pour n'importe quelle cible.
Le développe la section cible dans les Options de sélection, vous permettant de configurer les méthodes de ciblage utilisées pour le descripteur actuel.
Le supprime la cible que vous avez indiquée et vous permet d'en choisir une autre.
La section Options peut être développée pour afficher les options suivantes :
- Appliquer automatiquement les modifications (Auto-apply changes ) : lorsque cette option est sélectionnée, les modifications sont appliquées automatiquement aux éléments cible et ancre.
- Sites Web réactifs - Lorsque cette option est sélectionnée, permet à l'ancre de se déplacer automatiquement de la gauche vers le haut de la cible ou du haut vers la gauche de la cible, vous permettant ainsi d'automatiser les sites Web réactifs.
- Visibilité de l'élément : vérifie si l'élément d'IU est visible ou non. Trois options sont disponibles dans le menu déroulant :
- Aucun : ne vérifie pas la visibilité.
- Interactif (pour le sélecteur de correspondances approximatives) : option par défaut. Cela ne s’applique qu’à la méthode de ciblage du Sélecteur de correspondances approximatives. Cela n’a aucune incidence sur le sélecteur strict ou sur les autres méthodes de ciblage. Vérifie si l’élément est potentiellement visible en ignorant le défilement de la page et les obstructions par d’autres applications, ou bien si l’application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles, qui existent dans le DOM, mais sont masqués. Le but est de filtrer les éléments qui ne sont pas visibles ou masqués par d'autres éléments (ce qui les rendrait non interactifs).
- Entièrement visible : garantit que l'élément d'IU est visible à l'écran.
La section Sélecteur de fenêtre ( Window Selector) peut être développée pour afficher et modifier le sélecteur de l’application cible indiquée. Vous pouvez également utiliser le bouton Ouvrir dans UI Explorer (Open in UI Explorer ) pour modifier le sélecteur de fenêtre dans UI Explorer.
Une cible est un élément d’IU avec lequel vous souhaitez interagir (par exemple, un bouton sur lequel cliquer, une zone de texte dans laquelle saisir du texte ou une partie de page Web à partir de laquelle copier du texte).
Le processus d'arrière-plan relatif à la recherche d'un élément d'IU utilise plusieurs méthodes de ciblage :
- La méthode de ciblage principale est représentée par des sélecteurs : Sélecteur strict ou Sélecteur approximatif.
- La méthode de ciblage secondaire est Computer Vision.
- La troisième méthode de ciblage est Image (désactivée par défaut).
L'icône s'affiche à côté de la méthode de ciblage principale au moment de la conception, simulant le scénario au moment du runtime.
Paramètres de projet par défaut pour les méthodes de ciblage à travers les technologies
Le tableau ci-dessous affiche les paramètres de projet par défaut pour le ciblage des méthodes selon différentes technologies.
Méthodes de ciblage | Applications de bureau | Navigateurs Web | Java | SAP |
---|---|---|---|---|
Sélecteur strict | ||||
Sélecteur de correspondances approximatives | ||||
Computer Vision | ||||
Image |
Paramètre du projet : Attendre la méthode de ciblage principale jusqu'à l'expiration du délai
Le paramètre de projet Attendre la méthode de ciblage principale jusqu'à l'expiration du délai (Paramètres du projet > UIAutomation Modern), qui est activé par défaut dans les nouveaux projets à partir de la version 23.10.3 du package d'activités et qui peut être activé manuellement pour les projets créés avant cette version du package d'activités , offre à la méthode de ciblage principale un délai supplémentaire pour utiliser son délai d'attente complet jusqu'à ce qu'une méthode de ciblage de secours puisse être utilisée.
Si l'une des méthodes de ciblage principales parvient à trouver l'élément d'IU avant l'expiration du délai, elle sera utilisée comme méthode d'interaction avec l'élément d'IU. Le sélecteur strict est la première méthode de ciblage à rechercher l’élément d’IU, suivie juste après du sélecteur de correspondances approximatives. Le sélecteur strict a la priorité sur le sélecteur de correspondances approximatives.
Lorsque l'élément d'IU n'a pas été trouvé par les méthodes de ciblage principales avant l'expiration du délai d'attente, et si après toutes les nouvelles tentatives dans le délai imparti ni le sélecteur strict, ni le sélecteur de correspondances approximatives n'ont trouvé l'élément d'IU, alors les deuxième et troisième méthodes de ciblage vont commencer à rechercher l’élément d’IU dans le délai qui leur est imparti.
Ce paramètre de projet apporte également plus de prévisibilité et de visibilité dans les problèmes liés au sélecteur afin que vous puissiez avoir un meilleur contrôle sur votre ciblage des éléments d'IU, tout en ayant également la solide solution de repli fournie par Computer Vision.
Si vous désactivez ce paramètre de projet, toutes les méthodes de ciblage seront combinées en un seul et même délai d'attente pour trouver l'élément d'IU, en appliquant la logique hiérarchique : une cible trouvée par une méthode de ciblage de classement inférieur sera uniquement utilisée si rien n'a été trouvé par les méthodes de ciblage plus haut classées.
Paramètre du projet : Afficher les correspondances les plus proches dans le message d’erreur « Élément introuvable »
L'option Afficher les correspondances les plus proches dans le paramètre de projet du message d'erreur « Élément introuvable » (Project Settings > UI Automation Modern) est activée par défaut dans les nouveaux projets à partir du package d'activités version 23.10.3 et peut être activée manuellement pour les projets créés avant. la version du package d’activités. Lorsque ce paramètre est activé avec le paramètre de projet Attendre la méthode de ciblage principale jusqu'à l'expiration du délai d'attente , si un sélecteur échoue, un avertissement s'affiche dans les journaux présentant la méthode utilisée pour trouver l'élément d'IU avec dix suggestions des correspondances de sélecteur les plus proches qui peuvent être utilisé pour remplacer le sélecteur défectueux.
Il n'est pas recommandé de modifier manuellement le descripteur, car l'ensemble de ce processus a été conçu pour être utilisé facilement par l'utilisateur et devrait fournir de bons résultats sans nécessiter de configuration avancée. Néanmoins, si vous souhaitez configurer des fonctionnalités plus avancées pour votre descripteur, vous pouvez activer, désactiver et modifier les méthodes de ciblage.
Un sélecteur est un fragment XML qui contient les attributs d'un élément d'IU et de ses parents, y compris l'application cible. Les sélecteurs sont utilisés afin de cibler les éléments d'IU à l’écran, en les inspectant ainsi que leurs attributs et en les reliant aux attributs du sélecteur. Vous pouvez en savoir plus la nature des sélecteurs dans l'écosystème UiPath, consultez cette page.
Le sélecteur strict de l'élément cible peut être modifié à partir de sa section dédiée dans la fenêtre Options de sélection. Vous pouvez également utiliser le bouton Ouvrir dans UI Explorer (Open in UI Explorer ) pour modifier le sélecteur dans UI Explorer.
Le champ Sélecteur strict prend en charge l'utilisation et la création de variables et d'arguments à partir du menu contextuel (accessible en cliquant avec le bouton droit).
Vous pouvez également sélectionner une partie du sélecteur et utiliser le menu contextuel pour le convertir directement en une variable pré-remplie avec votre sélection.
Vous pouvez également sélectionner une variable déjà créée dans le menu déroulant Nom de la variable et l'utiliser dans votre sélecteur.
La case à cocher Remplacer la valeur par défaut ( Override default value ) vous permet de remplacer la valeur de votre variable prédéfinie par votre sélection actuelle.
Le bouton Confirmer (Confirm) permet d'enregistrer les modifications que vous avez apportées dans votre sélecteur.
Les raccourcis clavier suivants sont disponibles :
Ctrl
+Space
: choisir la variableCtrl
+Shift
+Space
: choisir l'argumentCtrl
+K
: créer une variableCtrl
+M
: créer un argument
S'il existe une variable et un argument portant le même nom, la variable est toujours utilisée par défaut lors du runtime.
Les arguments dont les noms sont identiques à des variables sont masqués dans le menu de sélection de variables de l'écran de sélection.
Les modifications effectuées avec des variables et des arguments peuvent être propagées dans toutes les autres instances où elles se trouvent. Par exemple, si une variable est utilisée à la fois dans les champs Sélecteur strict (Strict selector) et Sélecteur approximatif (Fuzzy selector), sa modification dans l'un des champs génère un message qui vous informe que la même valeur a été trouvée dans un autre champ, et vous offrant la possibilité de remplacer toutes les instances par la nouvelle valeur.
Les sélecteurs stricts prennent également en charge les caractères génériques, qui peuvent être utilisés pour remplacer zéro ou plusieurs caractères dans une chaîne. Vous pouvez en savoir plus sur cette fonctionnalité ici.
Un sélecteur approximatif est un sélecteur qui prend en compte les modifications possibles des attributs d'un élément, en les identifiant sur la base d'un modèle, plutôt que sur une correspondance exacte. Cette méthode fonctionne mieux lorsqu'elle est utilisée avec des ancres.
Le sélecteur approximatif est très similaire au sélecteur strict, à la différence que ses attributs sont correspondants de façon approximative au lieu d'être parfaitement correspondants. Cela signifie qu'un sélecteur approximatif peut générer plusieurs éléments, par opposition au sélecteur strict qui ne génère qu'un seul élément à la fois.
Le sélecteur approximatif peut être modifié à partir de sa section dédiée dans la fenêtre Options de sélection (Selection Options).
La précision des correspondances du sélecteur de correspondances approximatives est basée sur l’algorithme de distance de Levenshtein, afin de calculer la similarité des sélecteurs. La valeur par défaut est de 0,5 et peut être configurée à partir du curseur Précision, ou bien directement à partir du champ de saisie en entrant une valeur valide. La précision correspondante peut être définie sur une plage allant de 0,4 à 1 ; une valeur plus basse indique un degré d'approximation plus élevé, ce qui signifie que le sélecteur de correspondances approximatives va générer davantage d'éléments, et une valeur plus élevée révèle un degré d'approximation moins élevé, ce qui signifie que le sélecteur de correspondances approximatives va générer moins d'éléments.
Tout comme le Sélecteur strict, le champ Sélecteur approximatif prend en charge l’utilisation et la création de variables et d’arguments et prend également en charge les caractères génériques. Pour plus de détails, reportez-vous aux informations fournies ci-dessus.
Si l'élément indiqué contient du texte, celui-ci est affiché dans la zone d'entrée sous la fenêtre d'édition du sélecteur approximatif. Si du texte est affiché dans cette zone d'entrée, il doit être trouvé dans l'élément lui-même au moment de l'exécution pour être considéré comme une correspondance.
Le menu déroulant à côté de la zone de saisie contient les options suivantes :
- Text is/InnerText is/FullText is (selon la méthode d'extraction de texte utilisée) : affiche le texte extrait ; la meilleure méthode d'extraction est automatiquement identifiée et il est recommandé de l'utiliser.
- Ignorer le texte (Ignore text ) - Ignore le texte spécifié dans la zone d'entrée.
Lorsque la recherche de cible ou d'ancre à l'aide d'un sélecteur approximatif échoue, une exception personnalisée est levée, affichant les correspondances les plus proches pour réparer le sélecteur défaillant.
The UI element could not be located using the configured Fuzzy selector for Target or Anchor.
'Target' search failed for selector:
<ctrl name='Use*' role='radio button' /><ctrl name='Use mimi' role='XYZ text' automationid='' />
These are the closest selector matches found:
[84%] <ctrl name='Use Amount' role='radio button' /><ctrl role='text' automationid='' />
[83%] <ctrl name='Use Both' role='radio button' /><ctrl role='text' automationid='' />
[82%] <ctrl name='Use Piece Count' role='radio button' /><ctrl role='text' automationid='' />
'Anchor 1' search failed for selector:
<ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='XYZ Config' />
These are the closest selector matches found:
[78%] <ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='Configuration' />
[64%] <ctrl name='Transaction #:' role='text' /><ctrl name='Transaction #:' role='text' automationid='' check:text='Transaction #:' />
[63%] <ctrl name='Deposit transaction' role='text' /><ctrl name='Deposit transaction' role='text' automationid='' check:text='Deposit transaction' />
'Anchor 2' search failed for selector:
<ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use XYZZZZZZ' />
These are the closest selector matches found:
[83%] <ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use Both
' />
[74%] <ctrl name='Use Amount' role='radio button' automationid='' check:fulltext='Use Amount
' />
[68%] <ctrl name='Use Piece Count' role='radio button' automationid='' check:fulltext='Use Piece Count
' />
The UI element could not be located using the configured Fuzzy selector for Target or Anchor.
'Target' search failed for selector:
<ctrl name='Use*' role='radio button' /><ctrl name='Use mimi' role='XYZ text' automationid='' />
These are the closest selector matches found:
[84%] <ctrl name='Use Amount' role='radio button' /><ctrl role='text' automationid='' />
[83%] <ctrl name='Use Both' role='radio button' /><ctrl role='text' automationid='' />
[82%] <ctrl name='Use Piece Count' role='radio button' /><ctrl role='text' automationid='' />
'Anchor 1' search failed for selector:
<ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='XYZ Config' />
These are the closest selector matches found:
[78%] <ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='Configuration' />
[64%] <ctrl name='Transaction #:' role='text' /><ctrl name='Transaction #:' role='text' automationid='' check:text='Transaction #:' />
[63%] <ctrl name='Deposit transaction' role='text' /><ctrl name='Deposit transaction' role='text' automationid='' check:text='Deposit transaction' />
'Anchor 2' search failed for selector:
<ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use XYZZZZZZ' />
These are the closest selector matches found:
[83%] <ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use Both
' />
[74%] <ctrl name='Use Amount' role='radio button' automationid='' check:fulltext='Use Amount
' />
[68%] <ctrl name='Use Piece Count' role='radio button' automationid='' check:fulltext='Use Piece Count
' />
Les correspondances les plus proches ne s’affichent pas si vous modifiez le sélecteur par défaut en ajoutant ou en supprimant des nœuds de sélecteur, ou si la recherche de cible ou d’ancre a échoué en raison de plusieurs correspondances.
Vous pouvez trouver plus d'informations sur les sélecteurs dans le guide Studio.
Computer Vision est largement disponible : que ce soit sur Studio Desktop pour les projets Windows et multiplate-forme, ou sur Studio Web.
Pour utiliser Computer Vision comme méthode de ciblage, vous devez accéder à Paramètres du projet > Computer Vision et veiller à définir le bon point de terminaison du serveur. Vous pouvez laisser ce champ tel quel et utiliser UiPath Cloud, qui est rempli par défaut, ou bien saisir une autre valeur en sélectionnant l'un des autres points de terminaison publics spécifiques à une région de serveur ou à votre propre serveur local.
Vous pouvez également utiliser Computer Vision comme méthode de ciblage en définissant Utiliser un serveur local sur True. Cela implique que le package UiPath.ComputerVision.LocalServer soit installé dans votre projet. Lorsque le serveur local est activé, la valeur du serveur est écrasée. Le serveur local n'est cependant pas disponible avec les projets multiplate-forme.
Cette méthode de ciblage utilise une image dans la fenêtre d’application qui identifie l’élément, par exemple une icône ou un bouton.
Si l'option Automatisation de l'image (Image automation) est utilisée pour votre cible, vous pouvez également afficher la capture d'écran de l'élément et ajuster la précision de l'image. La valeur par défaut est 0,8 et peut être configurée soit à partir du curseur Précision , soit directement à partir du champ de saisie en tapant une valeur valide. La précision peut être définie dans une plage de 0,4 à 1. Pour plus d'informations, consultez la section Automatisation des images et des textes .
Si vous souhaitez définir des cibles contenant uniquement des images, vous pouvez utiliser la sélection de la région de l'image (F3) ou tracer un cadre de sélection de la zone que vous souhaitez utiliser comme cible/ancre tout en indiquant.
Vous pouvez également utiliser l'actualisation pour actualiser manuellement l'image que vous avez sélectionnée, au cas où l'image de l'élément aurait changé depuis qu'il a été indiqué.
La méthode de ciblage Image est désactivée par défaut dans les paramètres du projet.
Pour l'activer au niveau du projet, accédez à Paramètres du projet > UI Automation Modern > Méthodes de ciblage - Applications de bureau > Méthodes de ciblage - Navigateurs web / Méthodes de ciblage - Java / Méthodes de ciblage - SAP (en fonction du type d'application que vous souhaitez automatiser) > Image > sélectionnez Vrai (True).
L'élément doit être valide pour pouvoir activer la méthode sur un élément spécifié.
Si vous avez coché la case Activer le texte natif ( Enable Native text ) lors de l'indication de l'élément, la méthode de ciblage Texte natif (Native Text) est utilisée. Cette méthode vous permet d’utiliser tous les libellés de texte identifiés avec la méthode Native pour identifier l’élément avec lequel vous souhaitez interagir.
Le libellé de texte identifié grâce à cette méthode peut être modifié à partir de sa section dédiée, et vous pouvez spécifier si vous souhaitez que le texte soit sensible à la casse ou non en utilisant le bouton Activer/Désactiver la sensibilité à la casse ( Toggle case sensitive ).
La sélection de l'option Modifier hors ligne (Edit offline) ouvre l'écran de sélection en mode d'édition hors ligne. En mode d'édition hors ligne, vous ne pouvez pas ajouter d'ancres, valider le descripteur ou d'autres fonctionnalités qui nécessitent une application en direct.
Si vous cochez la case Ne plus afficher ce message, la prochaine fois que vous souhaiterez modifier la cible, cela ouvrira directement l'écran de sélection.
Le processus de validation vous permet de vérifier l’efficacité de la sélection actuelle au niveau de l’identification de la cible, en la vérifiant à l’aide de toutes les méthodes et de tous les ancrages sélectionnés. Vous pouvez valider votre sélection en utilisant le bouton Valider sur l’écran de sélection. Le résultat de la validation s’affiche en haut de la fenêtre des options de sélection. Si des ajustements sont nécessaires, un message s’affiche contenant des informations sur la façon d’améliorer la sélection.
Si vous disposez d’une paire cible-ancre, chacune d’elles utilise toutes les méthodes disponibles de ciblage. Pour trouver la cible finale, toutes les combinaisons possibles pour chacun de ces éléments sont associées aux éléments à l'écran, et un score est attribué après la correspondance.
Après avoir procédé à la validation, si des doublons sont trouvés, ceux-ci apparaîtront en surbrillance dans l’application cible. Si aucun doublon n’est trouvé, des icônes apparaîtront à côté des méthodes de ciblage et vous renseigneront sur l’état de chaque méthode de ciblage dans la situation qui vous concerne.
Les performances de chaque méthode sont affichées dans la section Configuration de la fenêtre Options de sélection et représentées à l’aide de l’une des icônes suivantes :
- La méthode de ciblage la plus rapide pour identifier avec succès l’élément.
- La méthode a correctement identifié l’élément, mais il ne s’agissait pas de la méthode la plus rapide.
- La méthode a trouvé des doublons et l’élément correct a été identifié en utilisant cette méthode conjointement à d’autres méthodes de ciblage.
- La méthode a trouvé des doublons et l’élément correct n’a pas pu être identifié en utilisant cette méthode.
- la méthode n'a identifié aucun élément.
- Doublons
- Ancres
- Quand utiliser une ancre
- Ancre trouvée automatiquement
- Méthode d'identification de l'ancre
- Ajouter manuellement une ancre
- Pointer sur le menu
- Configuration du descripteur
- Options
- Sélecteur de fenêtre
- Cible
- Sélecteur strict
- Sélecteur de correspondances approximatives
- Computer Vision
- Image
- Texte natif
- Modification hors ligne
- Validation du descripteur