Guía de usuario de Studio

Última actualización 17 de dic. de 2024

Búsqueda aproximada

Acerca de la búsqueda aproximada

Un selector contiene una etiqueta de nivel superior que hace referencia a la ventana o pestaña del navegador de destino. Contiene atributos como el título, el nombre del proceso, la URL, el nombre de la ventana y otros, que te ayudan a identificar correctamente los elementos que desea utilizar en sus proyectos de automatización.

A menudo, los valores de las etiquetas de nivel superior están sujetos a cambios dinámicos porque la aplicación de destino los reescribe en función de sus acciones. Por ejemplo, el título de una página web puede cambiar durante el proceso de automatización, lo que hace que el selector correspondiente no sea válido.

En este sentido, las capacidades de búsqueda difusa del selector te permiten localizar cadenas basadas en un patrón, en lugar de en una coincidencia exacta con tu entrada. Como resultado, se obtiene un método más flexible de identificación de elementos y se validan los selectores en función de múltiples atributos, incluso si algunos son propensos a cambiar durante el proceso de automatización.

Cómo funciona la búsqueda aproximada

Para utilizar las funciones de búsqueda difusa, es necesario incluir un par de opciones coincidentes en la etiqueta de nivel superior del selector de destino, de la siguiente manera:

Opción	Descripción
`matching:<tag_name>=fuzzy`	Permite especificar la etiqueta de búsqueda de destino, determinada por el valor `<tag_name>`.
`fuzzyLevel:<tag_name>=<numerical_value>`	Determina el umbral correspondiente para el destino `<tag_name>`. Permite un valor numérico de 0 a 1, como se indica a continuación: Más cercano a 0: devuelve resultados con menor similitud a `<tag_name>` Más cercano a 1: devuelve resultados con mayor similitud a `<tag_name>`

Nota: En caso de encontrar más elementos, la acción de destino se ejecuta en el primero.

Tipos de selectores compatibles

Actualmente, la búsqueda aproximada es compatible con los siguientes tipos de selectores:

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

Nota:

Al agregar check:text="example"un selector diferenciado se comprueba si el elemento de destino contiene el texto especificado.

Por ejemplo, al agregar check:text="Options" a un selector diferenciado se comprueba si el elemento de destino contiene el texto Options.

Ejemplos de uso de la búsqueda aproximada

La búsqueda aproximada puede utilizarse para identificar casi cualquier tipo de atributo En los siguientes ejemplos, pretendemos construir selectores válidos con atributos que están mal escritos:

A. Utilización de un nivel alto de aproximación

Supongamos que queremos construir un selector para identificar el atributo W3Schools Online Web Tutorials <title>. Para el propósito de nuestro ejemplo, el atributo está mal escrito, por lo que el selector no es válido.

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

Para solucionarlo, tenemos que introducir la búsqueda aproximada dentro de la etiqueta <html>. Dado que el atributo de interés es <title>, la expresión <tag_name> de nuestra búsqueda aproximada debe tener la forma matching:title=fuzzy. El error de nuestro atributo <title> es pequeño, por lo que podemos utilizar un nivel de aproximación más cercano a 1. Se genera el siguiente selector, que devuelve el atributo <title> correcto, que en este caso es 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. Utilización de un nivel bajo de aproximación

En este segundo ejemplo, necesitamos construir selectores para un atributo <aaname>. El atributo de destino es Colorpicker, pero en nuestro ejemplo está incorrectamente escrito Clorker. No es necesario mencionar que, con un atributo mal escrito, nuestro selector no es válido, y se ve algo así:

<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' />

Es preciso incluir la búsqueda aproximada en la etiqueta <webctrl>. En este caso, nuestro objetivo es <aaname>. Dado que hay más errores en la ortografía de nuestro objetivo, se reduce el nivel de aproximación más cercano a 0, para que haya más posibilidades de detección precisa. Se genera el siguiente selector, que devuelve el atributo <aaname> correcto, que en este caso es 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' />