Guide de l’utilisateur de Studio

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

Recherche dans RegEx

À propos de la recherche RegEx

Une expression régulière, ou RegEx, est une chaîne de texte spéciale pour décrire un modèle de recherche. Cela les rend parfaitement adaptés à la recherche, au traitement de texte et à la validation des données. L'utilisation des capacités de recherche RegEx dans les sélecteurs permet d'identifier plusieurs éléments cible avec une seule exécution de recherche. Sans RegEx, plusieurs sélecteurs auraient été créés pour identifier chaque élément cible.

Fonctionnement de la recherche RegEx

Pour utiliser les capacités de la recherche RegEx, une option correspondante doit être incluse dans la balise de l'élément à identifier, comme suit :

Option	Description
`matching:<tag_name>=’regex’`	Permet de spécifier la balise de recherche cible, déterminée par la valeur `<tag_name>`.
`<tag_name>='<regex_command>'`	Permet de spécifier le modèle de recherche via l'expression `<regex_command>` utilisée pour identifier `<tag_name>`.

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

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

Exemples d'utilisation de la recherche RegEx

Supposons que nous voulions créer un processus d'automatisation qui cible l'application Calculatrice. Toutefois, pour les besoins de cet exemple, la valeur de la balise <name> change entre 0 et 2. Sans la recherche RegEx, deux sélecteurs auraient été créés, un pour chaque valeur de la balise <name>, comme suit :

Sélecteur pour la balise <name='Display is 0'> :

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 0' role='text' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 0' role='text' />

Sélecteur pour la balise <name='Display is 2'> :

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 2' role='text' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' />  <uia cls='LandmarkTarget' />  <uia automationid='CalculatorResults' name='Display is 2' role='text' />

L'introduction de la recherche RegEx dans la deuxième balise <uia> permet de générer un seul sélecteur pour les faire correspondre aux deux cas. Dans ce cas, un sélecteur valide ressemble à ceci :

Sélecteur avec recherche RegEx

<wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' /> 
<uia cls='LandmarkTarget' /> 
<uia automationid='CalculatorResults' name='Display is \d' role='text' matching:name='regex' /><wnd app='applicationframehost.exe' appid='Microsoft.WindowsCalculator_8wekyb3d8bbwe!App' title='Calculator' /> 
<uia cls='LandmarkTarget' /> 
<uia automationid='CalculatorResults' name='Display is \d' role='text' matching:name='regex' />

L'attribut matching:name='regex' indique à notre sélecteur d'utiliser RegEx pour identifier la balise <name>, tandis que la commande <name='Display is \d'> renvoie toutes les valeurs numériques de la balise <name> qu'elle identifie.

Vous trouverez ci-dessous quelques exemples supplémentaires sur le fonctionnement de la recherche RegEx et sur les valeurs renvoyées :

Expression régulière	Description	Résultats renvoyés
`(.RPA.)\|(.Robotic Process Automation)`	Correspond à chaque chaîne contenant les chaînes RPA ou Automatisation des processus par la robotique (Robotic Process Automation).	(...) outil RPA de tête (...) UiPath est une Automatisation des processus par la robotique (Robotic Process Automation) (...)
`^Index[0-5]`	Correspond à chaque chaîne commençant par la valeur `Index`, suivie de n'importe quel nombre compris entre 0 et 5.	Index5 Index03