Guide de l’utilisateur de Studio

Dernière mise à jour 20 déc. 2023

Recherche approximative

À propos de la recherche approximative

Un sélecteur contient une balise de niveau supérieur qui référence la fenêtre cible ou l'onglet du navigateur. Il contient des attributs tels que titre, nom de processus, URL, nom de fenêtre et autres, qui vous aident à identifier correctement les éléments à utiliser dans vos projets d'automatisation.

Le plus souvent, les valeurs de balise de niveau supérieur sont sujettes à des modifications dynamiques, car l’application cible les réécrit en fonction de vos actions. Par exemple, un titre de page Web peut changer pendant le processus d'automatisation, ce qui rend le sélecteur correspondant non valide.

À cet égard, les capacités de la recherche approximative du sélecteur permettent de localiser des chaînes en fonction d'un modèle, plutôt que d'une correspondance exacte avec votre entrée. Il en résulte une méthode plus flexible d'identification des éléments et valide des sélecteurs en fonction de plusieurs attributs, même si certains d'entre eux sont susceptibles de changer pendant le processus d'automatisation.

Fonctionnement de la recherche approximative

Pour utiliser les capacités de la recherche approximative, vous devez inclure quelques options de correspondance dans la balise de niveau supérieur du sélecteur cible, comme suit :

Option	Description
`matching:<tag_name>=fuzzy`	Permet de spécifier la balise de recherche cible, déterminée par la valeur `<tag_name>`.
`fuzzyLevel:<tag_name>=<numerical_value>`	Détermine le seuil correspondant de la cible `<tag_name>`. Il prend en charge une valeur numérique comprise entre 0 et 1, comme suit : Plus proche de 0 : renvoie les résultats avec une similarité inférieure à `<tag_name>` Plus proche de 1 : renvoie les résultats avec une similarité supérieure à `<tag_name>`

Remarque : si plusieurs éléments sont trouvés, l'action cible est exécutée sur le premier.

Actuellement, la recherche approximative est prise en charge par les types de sélecteur suivants :

Type de sélecteur	Assistance
`<wnd>`
`<html>`
`<webctrl>`
`<java>`
`<ctrl>`
`<sap>`
`<rdp>`
`<silverlight>`
Les étiquettes qui identifient un nom de processus. Exemple : `<html app="firefox.exe">`

Remarque :

Ajouter check:text="example" à un sélecteur approximatif permet de vérifier si l’élément cible contient le texte spécifié.

Par exemple, ajouter check:text="Options" à un sélecteur approximatif permet de vérifier si l’élément cible contient le texte Options.

Exemples d'utilisation de la recherche approximative

La recherche approximative permet d'identifier pratiquement n'importe quel type d'attribut dans les balises de niveau supérieur des sélecteurs. Dans les exemples suivants, nous visons à créer des sélecteurs valides avec des attributs mal orthographiés :

A. Utilisation d'un niveau d'approximation élevé

Supposons que nous voulons construire un sélecteur pour identifier l'attribut W3Schools Online Web Tutorials <title>. Pour les besoins de notre exemple, l'attribut est mal orthographié, ce qui rend le sélecteur non valide :

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials' />

Pour résoudre ce problème, nous devons introduire la recherche approximative dans la balise <html>. Étant donné que l'attribut d'intérêt est <title>, la valeur <tag_name> de notre expression de recherche approximative doit comporter le formulaire matching:title=fuzzy. L'erreur dans notre attribut <title> est petite, donc nous pouvons utiliser un niveau d'approximation plus proche de 1. Le sélecteur suivant est généré, qui renvoie l'attribut <title> approprié, qui, dans ce cas est W3Schools Online Web Tutorials :

<html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' /><html app='firefox.exe' title='WEScho0ls Online Web Tutorials'
      matching:title='fuzzy' fuzzylevel:title='0.8' />

B. Utilisation d'un niveau d'approximation faible

Dans ce deuxième exemple, nous devons créer des sélecteurs pour un attribut <aaname>. L'attribut cible est Colorpicker, mais dans notre exemple, il est incorrectement orthographié Clorker. Inutile de dire qu'avec un attribut incorrectement orthographié, notre sélecteur n'est pas valide et ressemble à ceci :

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Clorker' parentid='main' tag='IMG' />

La recherche approximative doit être incluse dans la balise <html>. Dans ce cas, notre cible <tag_name> <aaname>. Étant donné qu'il y a davantage d'erreurs dans l'orthographe de notre cible, nous réduisons le niveau d'approximation plus proche de 0, pour renforcer la précision de la détection. Le sélecteur suivant est généré, qui renvoie l'attribut <aaname> approprié, qui, dans ce cas est Colorpicker :

<html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' /><html title='W3Schools Online Web Tutorials' /> 
<webctrl aaname='Colorker' parentid='main' tag='IMG' matching:aaname='fuzzy' fuzzylevel:aaname='0.4' />