# Configuración de selectores

Para que un robot de software imite acciones específicas en la interfaz de usuario (sistema operativo, programas, páginas web), necesita interactuar con diversas ventanas, botones, listas desplegables, hipervínculos, etc. En las acciones con formularios en pantalla, Sherpa RPA busca (itera) la posición de los elementos en la pantalla. La selección del elemento correcto en la pantalla es una tarea compleja, ya que la iteración puede realizarse entre varios miles de elementos presentes en la pantalla. Con bastante frecuencia, los identificadores de los elementos de control, que permiten encontrarlos en la pantalla (nombres, etiquetas, propiedades del sistema y descriptores), están sujetos a cambios dinámicos; por ejemplo, el título de una página web puede cambiar durante el proceso de automatización.

Para resolver este problema, el Diseñador utiliza los llamados "Selectores". Los selectores almacenan los atributos del elemento de la interfaz gráfica de usuario en forma de un conjunto de instrucciones en formato XML, que indican al robot cómo encontrar un determinado elemento de control en la pantalla.

En la mayoría de los casos, los selectores son generados automáticamente por el Diseñador durante el proceso de grabación de las acciones del usuario y no requieren entrada adicional del usuario, especialmente si las aplicaciones a automatizar tienen una interfaz de usuario estática.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-777fa17d2090f72366794d72dd5ab8a03ada61ef%2Fimage%20(148).png?alt=media" alt=""><figcaption></figcaption></figure>

**Selector** – es una pista, una guía de acción para el robot sobre cómo encontrar un determinado elemento de control en la pantalla. El robot graba estos selectores automáticamente al registrar cualquier acción.

Sin embargo, en algunos programas se utilizan diseños variables y atributos con valores cambiantes, como en las aplicaciones web. El Diseñador no puede predecir estos cambios, por lo que algunos selectores pueden necesitar ser creados o editados manualmente.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-b7c79e31b2a87cb5b400663c13cb2c129f5dc3c3%2Fimage%20(147).png?alt=media" alt=""><figcaption></figcaption></figure>

## **Ventana "Editar selector"**

La ventana "Editar selector" se invoca desde el panel derecho de propiedades del selector (solo para aquellos bloques que tienen selectores) al hacer clic en el botón con los puntos suspensivos. Todos los bloques relacionados con elementos gráficos tienen esta propiedad. El selector está disponible tanto cuando los Bloques se añaden al Proyecto mediante la herramienta "Grabación", como en bloques listos para operaciones con formularios en pantalla (UI Automation) desde la paleta.

La ventana "Editar selector" permite ver el selector generado automáticamente y modificar el propio selector y sus atributos. Puede incluir o excluir ciertos atributos o agregar comodines a los valores que cambian dinámicamente.

Al hacer clic en el botón con los puntos suspensivos a la derecha del campo "Selector", aparecerá la ventana de edición del selector.

<table data-header-hidden><thead><tr><th width="104"></th><th width="245"></th><th></th></tr></thead><tbody><tr><td><strong>N.º</strong></td><td><strong>Elemento de interfaz</strong></td><td><strong>Descripción</strong></td></tr><tr><td>1.</td><td>botón “Convertidor de selectores UiPath…”</td><td>Permite abrir la ventana para ingresar texto desde el campo Selector de la actividad UIPath.</td></tr><tr><td>1.1.</td><td>botón <img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeU5XOKxdixXFJw3rPuUFD8cZpF4UulMjnL2NVSVpa60-EYLgMvDU8oEKwZWuo8-_Vq4k8--Iom4ivb3GajuIT0Bez4ZUg2cJdqRe9dPX91IUp_RyQ1Hm5gn0U14Qm3z2l73q36YDEyqbhfm62zbRXO27sk?key=QcJUoh8mLAmXqxEVD8uJXA" alt=""></td><td>Permite abrir la opción para cambiar el modo de operación de UIPath.</td></tr><tr><td>3.</td><td>botón “Agregar nueva fila”</td><td>Permite agregar una nueva fila.</td></tr><tr><td>4.</td><td>botón “Eliminar fila”</td><td>Permite eliminar la fila seleccionada.</td></tr><tr><td>5.</td><td>botón “Pegar desde el portapapeles”</td><td>Permite pegar información desde el portapapeles.</td></tr><tr><td>6.</td><td>botón “Abrir Sherpa Explorer”</td><td>Permite abrir .Sherpa Explorer</td></tr><tr><td>7.</td><td>botón “Insertar modificador”</td><td><p>Permite insertar un modificador que se puede seleccionar de una lista desplegable. Opciones posibles:</p><ul><li>? (un solo carácter);</li><li>* (varios caracteres);</li><li>xpath: (procesamiento de XPath);</li><li>regex: (procesamiento de Regex).</li></ul></td></tr><tr><td>8.</td><td>botón “Insertar variable”</td><td>Permite insertar una variable de las que se han definido en el diagrama, que se puede seleccionar mediante una lista desplegable.</td></tr><tr><td>9.</td><td>botón “Grabar”</td><td>Permite iniciar el procedimiento de grabación del selector.</td></tr><tr><td>10.</td><td>botón “Verificar”</td><td>Permite verificar la posición del elemento especificada en el selector.</td></tr><tr><td>11.</td><td>botón “Resaltar”</td><td>Permite “resaltar” (indicar) el último elemento del selector.</td></tr><tr><td>11.1.</td><td>botón <img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeU5XOKxdixXFJw3rPuUFD8cZpF4UulMjnL2NVSVpa60-EYLgMvDU8oEKwZWuo8-_Vq4k8--Iom4ivb3GajuIT0Bez4ZUg2cJdqRe9dPX91IUp_RyQ1Hm5gn0U14Qm3z2l73q36YDEyqbhfm62zbRXO27sk?key=QcJUoh8mLAmXqxEVD8uJXA" alt=""></td><td>Permite resaltar la ruta (es decir, cada línea del selector). Este botón permite ver cómo se realiza la búsqueda del selector en la interfaz de la ventana.</td></tr><tr><td>12.</td><td>botón “Eliminar selector”</td><td>Permite eliminar el selector.</td></tr></tbody></table>

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-f1d46ca9521e638b8c8ca4141822873aaa22e643%2Fimage%20(149).png?alt=media" alt=""><figcaption></figcaption></figure>

En esta ventana se puede ver cómo se ve el selector, verificarlo y corregirlo si es necesario, así como enriquecer el selector con herramientas auxiliares, como la inserción de comodines o la inserción del valor de una variable. También se pueden eliminar filas innecesarias o limpiar valores innecesarios de las celdas.

Así, el selector es una tabla compuesta por columnas y filas, donde cada fila es un comando, un paso que el robot debe ejecutar. Los comandos se leen de arriba hacia abajo. La fila superior se ejecuta primero, la inferior, la última. El robot avanza por los pasos de arriba hacia abajo y ejecuta cada fila como un comando. Busca en la pantalla un elemento cuyos atributos sean simultáneamente iguales a lo que se indica en las columnas de la fila del selector.

Por ejemplo, consideremos la primera fila del selector, donde:

* Tipo – proceso. Es decir, esta fila busca la aplicación necesaria para iniciar.
* El nombre del proceso aquí es – Calculator, se registra tal como aparece en el administrador de tareas.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-2d8b93dd3d540013d4e998e9be64c584b429833f%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>

Así, en la primera etapa, el robot encontrará el proceso llamado Calculator entre los procesos en ejecución en la memoria del ordenador.

La siguiente fila se designa como UIElement, que ya es una ventana o un elemento de control específico de este selector. Para encontrar el elemento de control necesario, el robot buscará simultáneamente un elemento con el nombre Calculator, el nombre de clase especificado y el elemento de control Window, de aquí se entiende que se trata de una ventana. Esta fila permite encontrar la ventana específica de la calculadora.

Bajamos a la fila siguiente. Ahora, en la ventana encontrada, es necesario buscar secuencialmente todos los contenedores que llevarán al botón necesario. Hay tres contenedores aquí. Estos contenedores pueden no ser visualmente visibles en la aplicación, ya que fueron creados para desarrolladores. Sin embargo, por el nombre “Panel numérico” se puede deducir que es un contenedor que contiene todos los botones de la calculadora. Y luego vemos que el último elemento es el número 6, en el que hizo clic el usuario.

El botón "**Verificar**" verifica la posición del elemento especificada en el selector, es decir, como resultado de la Verificación pueden surgir dos estados:

* Error en la verificación

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe2xLoGirjfMaMRznbU-16_QpuPtYbyJ4JwdTGOcmV3COLh8frIAM0FiEnCsk5Vksf0r-eLQ5dVyNlUJukTblSH46pV4ByCK6cyrcxE9zWQg6xz9GXvgwafcr2A8t15rE0Yn3VDX_Pc0VO9mc3IwoXGsRcy?key=QcJUoh8mLAmXqxEVD8uJXA" alt=""><figcaption></figcaption></figure>

\* La verificación se realizó con éxito, el elemento con la posición especificada en el Selector se encontró en la pantalla.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdy76SNBB0sntIUViZzmmy9nyFoBwAuLBsmcW36-C63ngLY5AVZp0QFycu81vPxJ1957gD-xLWmbYlj5hNhDL2y9LXkdtN0y7WFueRmgFdCEUc0VcmkYzLleFvXQU1NcwKbhnDUDsdjOJz4mgr6slBX9Vep?key=QcJUoh8mLAmXqxEVD8uJXA" alt=""><figcaption></figcaption></figure>

El botón "**Resaltar**" indica el elemento de la interfaz de usuario, resalta el propio elemento y los elementos de nivel superior en el camino hacia él con marcos rojos. La selección desaparece automáticamente después de unos segundos.

El botón "**Grabar**" inicia el procedimiento de grabación del Selector haciendo clic en el elemento de control deseado en la pantalla.

Acceda a Selector y haga clic en "Grabar". La ventana **SherpaDesigner** (con la ventana "Editar selector" abierta) se minimiza. En la parte superior de la pantalla aparecerá una sugerencia para trabajar en modo de Grabación. Seleccione la acción necesaria para su proceso de negocio, es decir, el elemento deseado en la pantalla y haga clic en él. Tenga en cuenta que los elementos deben resaltar antes de hacer clic (es decir, debe aparecer un marco rojo).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_DYBBQ3OPhjyFt4M9bO0UsEgxhcdjWRrwxvy7yk71TVFh8ed_129s0hHy49zueYcI6Hws-DcHylVecYHG8m2mRnyWDWczyZwsUHiJ_plp4IeJrbTDUG65Kn0wqODnubrZdE0CLEc6FXxR0-lVY7RaQeYM?key=QcJUoh8mLAmXqxEVD8uJXA" alt=""><figcaption></figcaption></figure>

Si el resaltado no aparece automáticamente o desaparece, para resaltar el elemento deseado, es necesario presionar la tecla Shift en el teclado. El resaltado es necesario para seleccionar con precisión el elemento bajo el cursor.

Opciones para grabar un clic:

* hacer clic con el botón izquierdo del ratón;
* presionar Ctrl izquierdo, lo que emula el clic con el botón izquierdo del ratón;
* presionar Ctrl derecho, lo que emula el clic con el botón derecho del ratón, es decir, en muchas aplicaciones, invoca el menú contextual;
* la emulación de la pausa del cursor del ratón sobre el elemento se graba utilizando la tecla Shift.

**Nota:** *desde la ventana "Editar selector" solo se graba una acción (clic, inserción, pausa sobre el botón, etc.), a diferencia del uso de la herramienta de grabación a través del menú principal, donde puede grabar varias acciones a la vez. Es decir, después de realizar una acción (clic), el usuario regresa automáticamente a la ventana "Editar selector".*

Después de regresar a la ventana de edición del Selector, se recomienda utilizar los botones "Resaltar" o "Verificar" para comprobar si el elemento ha sido seleccionado correctamente. Si el elemento se seleccionó incorrectamente, se puede intentar nuevamente haciendo clic en el botón Grabar, o encontrar y corregir el error en las líneas del Selector manualmente.

## **Configuración del selector**

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-2d8b93dd3d540013d4e998e9be64c584b429833f%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>

Cada línea del selector tiene uno o varios atributos que ayudan a identificar correctamente la ubicación exacta de la sección seleccionada de la pantalla. Los atributos muestran en qué programa se está grabando, en qué ventana y elemento, así como el nivel específico del elemento seleccionado mediante atributos como Type, Name, ClassName, ControlType, Index, Id, Text. Cada atributo puede tener un valor asignado, que se utilizará para la búsqueda. Es importante elegir atributos con valores constantes. Si el valor del atributo cambia en cada ejecución de la aplicación, el selector no podrá identificar correctamente el elemento. En este caso, se recomienda no utilizar dicho atributo (dejar su valor vacío).

<table data-header-hidden><thead><tr><th width="100"></th><th width="169"></th><th></th></tr></thead><tbody><tr><td><strong>N.º</strong></td><td><strong>Atributo</strong></td><td><strong>Descripción del atributo</strong></td></tr><tr><td>1.</td><td>Type</td><td>Tipo de elemento.</td></tr><tr><td>2.</td><td>Name</td><td>Nombre del elemento.</td></tr><tr><td>3.</td><td>ClassName</td><td>Nombre de la clase del elemento.</td></tr><tr><td>4.</td><td>ControlType</td><td>Tipo de elemento de control (por ejemplo, botón, campo de texto, etc.).</td></tr><tr><td>5.</td><td>Id</td><td>Identificador del elemento (generalmente único para cada elemento).</td></tr><tr><td>6.</td><td>Index</td><td>Índice del elemento en la lista de elementos coincidentes.</td></tr><tr><td>7.</td><td>Text</td><td>Texto dentro del elemento.</td></tr></tbody></table>

Además, en casos complejos, puede utilizar caracteres comodín o sustituir el valor de un atributo o parte de un atributo de una variable:

* El asterisco (\*) reemplaza cualquier cantidad de caracteres en el valor del atributo;
* El signo de interrogación (?) reemplaza un solo carácter en el valor del atributo;
* $NombreVariable – el uso del nombre de la variable que comienza con el símbolo $, permite insertar el valor de esta variable en lugar del valor del atributo o su parte.

## Video demostrativo sobre el uso de selectores

* Grabación de selectores: elementos superpuestos o invisibles en el ejemplo de la ventana de inicio de sesión de Chrome

{% embed url="<https://sherparpa.ru/ucontent/?09>" %}

* Trabajo con selectores de la ventana "Descargas" de Chrome

{% embed url="<https://sherparpa.ru/ucontent/?42zd>" %}

* Grabación de selectores de la ventana emergente en Internet Explorer

{% embed url="<https://sherparpa.ru/ucontent/?LSpu>" %}

* Conversión de selectores UIPath > Sherpa RPA en la ventana "Editar selector"

{% embed url="<https://sherparpa.ru/ucontent/?gHJc>" %}

* Funcionamiento de la función "Resaltar camino" en la ventana "Editar selector"

{% embed url="<https://sherparpa.ru/ucontent/?gMbc>" %}

La guía completa sobre el trabajo con web-selectores se encuentra [aquí](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/rukovodstvo-po-veb-selektoram).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/paneli-svoistv-i-peremennykh-i-rabota-s-nimi/panel-svoistv/nastroika-selektorov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
