Guía de usuario de Studio

Última actualización 18 de nov. de 2024

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.

Para usar UI Explorer como una herramienta independiente no es necesario instalar Studio. Esto resulta útil cuando quieres asegurarte de que se puede automatizar una aplicación con selectores. Te permite inspeccionar elementos de forma sencilla, sin necesidad de crear un proceso. El paquete independiente también contiene la utilidad SetupExtensions que permite instalar extensiones de navegador y el JavaBridge para inspeccionar elementos y cubrir 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 dependencia para el proyecto actual, el botón UI Explorer no aparecerá 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 Automatización de UI utilizada actualmente se muestra en la esquina inferior derecha en el UI Explorer que tengas 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	En este botón se muestra el estado del selector comprobando la validez de la definición del mismo y la visibilidad del elemento de destino en la pantalla. El botón Validar tiene tres estados: 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.
Opciones	Contiene varias opciones: UI Frameworks: cambia la tecnología utilizada para determinar los elementos de la IU y sus selectores. Las siguientes opciones están disponibles: Predeterminado: método patentado de UiPath. Normalmente funciona bien con todos los tipos de interfaz 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). Active Accessibility: una solución anterior de Microsoft para hacer accesibles las aplicaciones. Se recomienda utilizar esta opción con el software heredado, cuando la opción de 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 las etiquetas `ctrl`. Específicamente, la sub-string `<ctrl`. En XAML, puedes encontrar eso codificado como `<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 opción 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 de trabajo no admite las páginas web de Chrome o Edge y en su lugar genera selectores `wnd`, en lugar de recurrir a la extensión. Haz clic aquí para obtener más información sobre Active Accessibility 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 los elementos de la interfaz de usuario 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 en su elemento principal, aumentando su precisión de supervisión. Usa esta opción al generar selectores para actividades del 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.