UI Explorer

UI Explorer es una herramienta avanzada que te permite crear un selector personalizado para un elemento de la IU específico. Está disponible como herramienta independiente que puedes descargar del Centro de recursos de tu instancia de Automation Cloud o de Studio solo si tienes instalado el paquete UiPath.UIAutomation.Activities como una dependencia para tu proyecto.

El uso de UI Explorer como herramienta independiente no requiere la instalación de Studio. Esto es útil cuando quieres asegurarte de que una aplicación puede automatizarse con selectores. Te permite inspeccionar elementos sin crear un proceso. El paquete independiente también contiene la utilidad SetupExtensions , lo que permite instalar extensiones del navegador y JavaBridge para inspeccionar elementos en todas tus necesidades de automatización.

Para abrir la ventana UI Explorer, haz clic en el botón de la sección Selectores, en la pestaña Diseño, o desde el editor avanzado en la pantalla de selección de todos los selectores de los atributos destino y anclajes, después de indicar el elemento de destino de la UI.

Nota:

Si no tienes el paquete UiPath.UIAutomation.Activities instalado como una dependencia para el proyecto actual, el botón UI Explorer no aparece en la Cinta.

También puedes lanzar el UI Explorer desde la página Herramientas de la vista Backstage de Studio. Desde el menú contextual, UI Explorer utiliza las bibliotecas de automatización de IU que se incluyen con la versión de Studio actual.

Nota:

La versión del paquete de Automatización de IU que se está utilizando se muestra en la esquina inferior derecha del UI Explorer que has abierto. Esta versión varía, porque al lanzar el UI Explorer desde la página Herramientas se usa la versión predeterminada de Automatización de IU que se incluye con la versión de Studio que estás utilizando, mientras que al abrir el UI Explorer desde la Cinta, se utiliza la versión que tienes instalada como una dependencia para el proyecto actual.

Para estar seguro de que eliges el mejor selector, recuerda:

• Añadir o eliminar atributos
• Añadir etiquetas principales o secundarias
• Utilizar asteriscos para reemplazar los valores cambiantes

Descripciones de campos para la ventana del UI Explorer

Campo	Descripción
Validar	El selector se está validando Selector válido Selector inválido Selector modificado, revalidar
Indicar elemento	Indica un nuevo elemento de la IU que sustituye al antiguo.
Indicar anclaje	Te permite elegir un anclaje relacionado con el elemento de destino de la IU.
Reparar	Permite volver a indicar el mismo elemento de interfaz de usuario de destino y reparar el selector. Este proceso no sustituye por completo al selector anterior. El botón está disponible solo cuando el selector no es válido.
Resaltar	Coloca el elemento de destino en primer plano. El elemento destacado permanece hasta que se desactiva. El botón solo se habilita si el selector es válido.
Inspeccionar eventos	Abre la herramienta de inspección de eventos.
Opciones	Contiene varias opciones: Marcos de IU : cambia la tecnología utilizada para determinar los elementos de la IU y sus selectores. Las siguientes opciones están disponibles: Predeterminado : método propietario de UiPath. Normalmente funciona bien con todos los tipos de interfaces de usuario. En primer lugar intenta generar un selector utilizando las extensiones o conectores de UiPath adecuados (por ejemplo browser/remote/Java extension, SAP conector, etc.). Si eso no es posible, intenta generar un selector utilizando Accesibilidad activa (preferible para la mayoría de las aplicaciones de escritorio) o Automatización de IU (preferible para las aplicaciones de Office). Accesibilidad activa : una solución anterior de Microsoft para hacer que las aplicaciones sean accesibles. Se recomienda utilizar esta opción con software heredado, cuando la predeterminada no funciona. Intenta generar un selector utilizando Active Accessibility y omite las extensiones o conectores de UiPath. Para saber si un selector utiliza la tecnología Active Accessibility, debes buscar etiquetas ctrl. En concreto, la subcadena <ctrl. En XAML, puedes encontrarlo codificado como &lt;ctrl. Automatización de IU: el modelo de accesibilidad mejorado de Microsoft. Se recomienda utilizar esta opción con las aplicaciones más nuevas, cuando la predeterminada no funciona. Intenta generar un selector utilizando la automatización de IU y omite las extensiones o conectores de UiPath. Nota: Actualmente, este marco no es compatible con las páginas web de Chrome o Edge y, en su lugar, genera selectores wnd, en lugar de recurrir a la extensión. Para obtener más información, consulta Accesibilidad activa y automatización de IU. Restauración retrasada : retrasa la restauración de la ventana de UI Explorer hasta que se carguen los datos del selector. Utiliza esta opción cuando indiques elementos de la IU que se cierran automáticamente al perder el foco, como menús desplegables o superposiciones. Selector de desencadenador : garantiza la exclusividad de un elemento de IU dentro de su elemento principal al tiempo que aumenta su precisión de supervisión. Utiliza esta opción al generar selectores para actividades de desencadenador.

El panel de árbol visual

Muestra una vista de árbol de la jerarquía de la IU y te permite consultarla haciendo clic en las flechas situadas junto a cada nodo.

De forma predeterminada, la primera vez que abres el UI Explorer, este panel muestra todas las aplicaciones abiertas por orden alfabético.

Al hacer doble clic en un elemento de la IU (o hacer clic derecho y seleccionar Establecer como elemento de destino) del árbol, se rellenan los paneles Editor del selector, Atributos del selector y Explorador de propiedades.

Campo	Descripción
Resaltar	Se resalta el elemento seleccionado del árbol visual en tiempo real. El elemento destacado permanece hasta que se desactiva.
Mostrar opciones de búsqueda	Muestra el cuadro de búsqueda y las opciones del filtro de búsqueda.
Cuadro de búsqueda	Te permite buscar una cadena específica. Si no se encuentra una coincidencia exacta se muestran las coincidencias más cercanas. Se admiten asteriscos. En función del atributo seleccionado en la lista desplegable Buscar por, la búsqueda puede distinguir entre mayúsculas y minúsculas. Nota: solo se buscan coincidencias en la estructura de árbol del objeto de la IU seleccionado.
Buscar por	Filtra tu búsqueda en función del atributo o selector seleccionados. Los contenidos de esta lista desplegable cambian en función del elemento de la IU seleccionado. Nota: Si Buscar por se establece en Selector, solo puedes introducir un nodo en el formato <attribute name1='value1' ... />.
Solo elementos secundarios	Limita tu búsqueda a los elementos secundarios de primer nivel del nodo seleccionado. De forma predeterminada, esta casilla de verificación no está seleccionada.

El panel Editor del selector

Muestra el selector para el objeto de la IU especificado y te permite personalizarlo.

La parte inferior del panel muestra el fragmento XML real que tienes que usar en un proyecto. Cuando encuentres el selector que deseas, puedes copiarlo desde aquí y pegarlo en el panel Propiedades de una actividad, en el campo Selector.

En la parte superior de este panel podrás ver todos los nodos de un selector y quitar los que no te hagan falta eliminando las marcas de verificación que están a su lado. Un elemento de la lista de los nodos del selector se vuelve activo cuando habilitas o deshabilitas un atributo o cuando editas un selector en el panel inferior. Solo se activa un nodo de cada vez.

Cuando se selecciona un nodo aquí, se muestran sus atributos en los paneles Atributos del selector y Explorador de propiedades.

Los selectores también se pueden editar con la ayuda de variables, bien utilizando la tecla de acceso rápido CTRL+K para crear una variable en el propio selector, o bien especificando una variable ya creada con la combinación CTRL+Space. Con la tecla de acceso rápido CTRL+K puedes especificar un valor y un nombre para la variable. Ten en cuenta que solo se pueden usar variables string.

El panel Atributos del selector

Muestra todos los atributos disponibles de un nodo seleccionado (desde el panel Editor del selector).

Puedes añadir o eliminar algunos de los atributos del nodo añadiendo o eliminando la marca de verificación en el cuadro situado junto a cada atributo.

Además, puedes modificar el valor de cada atributo, aunque esta modificación solo se mantiene si el nuevo selector señala al objeto de la UI seleccionado originalmente.

El panel Explorador de propiedades

Muestra todos los atributos que un objeto de la UI especificado puede tener, incluidos los que no aparecen en el selector. No se pueden modificar.

Herramienta de inspección de eventos

En el contexto de la automatización attended basada en desencadenadores, la herramienta de inspección de eventos puede utilizarse para identificar el tipo de eventos nativos que se desencadenan al interactuar con ciertos elementos de la IU en una aplicación y luego puede utilizarse para configurar la actividad Desencadenador de eventos de la aplicación. La herramienta captura y supervisa todos los tipos de eventos seleccionados, como Hacer clic, Tecla pulsada, Enfoque obtenido, Enfoque perdido y otras interacciones relevantes, lo que te permite analizar las acciones realizadas y si corresponde, diagnosticar incidencias.

La herramienta de inspección de eventos puede abrirse desde el UI Explorer una vez que se selecciona un elemento de IU válido, haciendo clic en el botón Inspeccionar eventos de la barra de herramientas.

La barra de herramientas consta de las siguientes opciones:

• Grabar : los eventos generados al interactuar con el elemento de IU se graban y se añaden a la lista de eventos.
• Pausar : los eventos generados por el elemento de la IU al interactuar con él ya no se registran.
• Resaltar : muestra el contorno del elemento de destino y lo trae al primer plano durante unos segundos. El resaltado permanece hasta que se deshabilita.
• Abrir en UI Explorer : el elemento supervisado se abre en UI Explorer, donde puedes observar el selector de ese elemento.

Una vez que inicias la grabación de eventos, estarán disponibles dos opciones más:

• Borrar : elimina todos los eventos grabados.
• CSV : los eventos capturados se pueden exportar a un archivo .csv para su posterior análisis.

La ventana de Herramienta de inspección de eventos tiene dos secciones principales:

• Filtro de eventos: permite seleccionar los tipos de eventos que quieres supervisar para el elemento de destino.
• Lista de eventos: muestra información sobre los eventos capturados.

Puedes filtrar los tipos de eventos a capturar habilitando o deshabilitando las casillas de verificación de la lista de tipos de eventos. La lista puede variar en función de la tecnología del elemento seleccionado.

Todos los tipos de eventos del ratón (mover el ratón, pulsar el ratón, soltar el ratón, introducir con el ratón, salir con el ratón), específicos para los elementos de la IU Web o Java, están deshabilitados de forma predeterminada porque la lista de eventos, en estos casos, puede llegar a ser bastante grande. Nuestra recomendación es habilitar los tipos de eventos del ratón solo si tienes una necesidad específica de supervisarlos.

Además, vale la pena mencionar que los tipos de eventos pueden habilitarse o deshabilitarse incluso después de iniciar la grabación de eventos.

La lista de eventos tiene tres columnas:

• Nombre del evento : el tipo de evento.
• Marca de tiempo : la fecha y la hora en que se realizó el evento.
• Datos del evento : los datos y parámetros asociados a un determinado evento.

Cada columna puede ordenarse en orden ascendente o descendente. Los eventos se muestran de forma predeterminada en el orden en que se realizaron.

Cuando se encuentra el tipo de evento Desaparecido , ya no puedes seguir supervisando y se muestra un mensaje de error en la pantalla. Al hacer clic en cualquier opción de la barra de herramientas, se muestra el mismo mensaje de error en la pantalla. Las únicas opciones disponibles son borrar los datos o exportarlos a un archivo .csv . Para volver a iniciar la supervisión, cierra la ventana y abre otra instancia de la herramienta de inspección de eventos.