Guía de usuario de Studio

Última actualización 20 de dic. de 2023

Búsqueda RegEx

Acerca de la búsqueda de RegEx

Una expresión regular o RegEx, es una cadena especial de texto que se utiliza para describir un patrón de búsqueda. Esto las hace idóneas para las búsquedas, el procesamiento de texto y la validación de datos. El uso de las capacidades de búsqueda de RegEx en los selectores te permite identificar varios elemento de destino con una única ejecución de búsqueda. Sin RegEx, sería necesario generar varios selectores para identificar cada elemento de destino.

Cómo funciona la búsqueda de RegEx

Para poder utilizar las capacidades de búsqueda de RegEx, debe incluirse una opción de concordancia en la etiqueta del elemento que quieras identificar, tal y como se indica a continuación:

Opción	Descripción
`matching:<tag_name>=’regex’`	Permite especificar la etiqueta de búsqueda de destino, determinada por el valor `<tag_name>`.
`<tag_name>='<regex_command>'`	Te permite especificar el patrón de búsqueda mediante la expresión `<regex_command>` utilizada para identificar el `<tag_name>`.

Actualmente, la búsqueda de RegEx es admisible con los siguientes tipos de selector:

Tipo de selector	Soporte
`<wnd>`
`<html>`
`<webctrl>`
`<java>`
`<ctrl>`
`<sap>`
Etiquetas que identifican un nombre de proceso. Ejemplo: `<html app="firefox.exe">`

Ejemplos de uso de la búsqueda de RegEx

Supongamos que queremos crear un proceso de automatización dirigido a la aplicación Calculadora. Sin embargo, a efectos de este ejemplo, el valor de la etiqueta <name> varía entre 0 y 2. Sin la búsqueda RegEx, se habrían creado dos selectores, uno para cada valor de la etiqueta <name>, de la siguiente forma:

Selector para la etiqueta <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' />

Selector para la etiqueta <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' />

La introducción de la búsqueda de RegEx dentro de la segunda etiqueta <uia> permite generar un único selector para servir a ambos casos. Un selector válido, en este caso, tendría el siguiente aspecto:

Selector con búsqueda de 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' />

El atributo matching:name='regex' indica a nuestro selector que utilice RegEx para identificar la etiqueta <name>, mientras que el comando <name='Display is \d'> devuelve todos los valores numéricos para la etiqueta <name> a la que identifica.

A continuación se muestran un par de ejemplos adicionales sobre cómo funciona la búsqueda de RegEx y qué valores devuelve:

Expresión regular	Descripción	Resultados devueltos
`(.RPA.)\|(.Robotic Process Automation)`	Coincide con cada cadena que contenga las cadenas de Automatización de procesos robóticos (RPA).	(...) herramienta RPA líder (...) UiPath es una Automatización de procesos robóticos (...)
`^Index[0-5]`	Coincide con cada cadena que comience con el valor `Index`, seguido de cualquier número entre 0 y 5.	Índice5 Índice03