activities

latest

false

Actividades UIAutomation

Última actualización 20 de dic. de 2024

Configuración avanzada del Descriptor

Para obtener más información sobre el uso de las funciones más avanzadas de la pantalla de selección, vea el siguiente vídeo.

Duplicados

Indicar un destino puede producir duplicados, que son otros elementos de IU que se perciben como extremadamente similares al elemento de IU de destino y pueden hacer que la automatización falle en Runtime. Cuando se encuentran duplicados, se resaltan en amarillo y tienen una etiqueta encima de ellos que contiene una letra que corresponde al método de destino que encontró cada duplicado:

Una de las mejores formas de evitar duplicados es indicando un anclaje.

Anclajes

Para crear un descriptor fiable, se recomienda indicar un anclaje después de que se indique el destino.

Un anclaje es otro elemento cercano que ayuda a identificar de forma única al destino. Cuando se indica un destino, UiPath intenta identificar y seleccionar automáticamente un anclaje. También puedes añadir tres anclajes manualmente.

Si solo se habilita el Selector estricto como método de orientación, no se utilizan los anclajes.

Cuándo se puede utilizar un anclaje

Los anclajes son útiles cuando un elemento de destino no es único. Por ejemplo, un formulario de una aplicación de escritorio generalmente contiene varios cuadros de texto similares en los que se introducen diversos datos. La forma de identificar los datos que tienen que ir en cada uno de ellos es mirando las etiquetas cercanas. De forma manera similar, cuando la etiqueta de un cuadro de texto se añade como su anclaje, el robot utiliza el anclaje para identificar el cuadro de texto en el que se va a escribir.

A veces se requieren varios anclajes para distinguir un destino de otros elementos similares llamados duplicados. Por ejemplo, si un formulario contiene secciones de dirección de facturación y dirección de envío, los cuadros de texto que aparecen en ellos aparecen dos veces con la misma etiqueta, así que hay que añadir ambas etiquetas (por ejemplo, "Código postal") y el título de la sección (p. ej., "Dirección de facturación") como anclas para identificarla correctamente.

Los anclajes se pueden encontrar en varios escenarios, como se describe a continuación:

Anclaje encontrado automáticamente

Después de indicar un destino, se intenta identificar automáticamente un anclaje para este.

Importante: Si no se encuentra un anclaje con 100% de certeza, o si se encuentran duplicados, no se considera como un anclaje automático.

Si se encuentra un anclaje automático con éxito, se resalta en azul y la herramienta de ayuda de selección confirma que el destino y su anclaje son correctos.

Método de identificación de anclaje

En esta sección puedes encontrar más detalles técnicos sobre el método en el que se realiza esta búsqueda.

Una vez que se indica un destino, se identifica el tipo del elemento de IU indicado. Se buscan los siguientes elementos e direcciones:

Botón: dentro del elemento.
Casilla de verificación: a la derecha del elemento.
Desplegable: a la izquierda y encima del elemento.
Cuadro de entrada: a la izquierda y encima del elemento. En el caso de la automatización del navegador, la etiqueta también se busca dentro del cuadro de entrada, buscando el atributo AreaLabeledBy . Si esta etiqueta no está identificada, se busca un elemento con tag=label y for='id of the input box' .
Botón de opción: a la derecha del elemento.
Imagen: a la derecha y debajo del elemento.

Dependiendo del tipo de elemento que se identifique, se busca un anclaje correspondiente para el elemento automáticamente.

Un anclaje identificado automáticamente tiene la forma de un elemento de texto que siempre está presente cerca del elemento de destino y, por lo tanto, se puede utilizar para identificar el elemento en Runtime con más precisión.

Si ninguna de las direcciones anteriores proporciona resultados, se utiliza un caso genérico que busca en la jerarquía de elementos un anclaje adecuado.

Añadir un anclaje manualmente

En caso de que un anclaje no se encuentre automáticamente y no se agregue al destino especificado, el asistente de opciones de selección le notificará, como se muestra en la siguiente captura de pantalla:

En esta situación, puedes seleccionar manualmente un anclaje para tu elemento de destino. Al mantener el puntero sobre otro elemento, se resalta en azul y se conecta con una línea al destino que ha seleccionado. Para seleccionar el anclaje que desea, simplemente haga clic en el texto que desea utilizar como anclaje.

Mantener el puntero en el menú

También puede editar un elemento específico (ya sea de destino o de anclaje) accediendo al menú que se muestra al pasar el ratón sobre el elemento de destino. Este menú tiene múltiples opciones:

El cierra el proceso de indicación y guarda los cambios realizados.

El te permite orientar elementos independientemente de su contenido de texto específico. Esto puede ser útil cuando se intenta seleccionar el primer elemento en una lista de búsqueda cuando no se sabe exactamente con qué se va a rellenar la lista, o cuando se interactúa con un elemento dinámico que cambia su etiqueta debido a varias razones. El uso de esta característica al indicar un destino utiliza solo el método Selector difuso para la identificación, y elimina el selector difuso para asegurarse de que el elemento sigue siendo el objetivo independientemente de los cambios de etiqueta.

Al hacer clic en el , puedes seleccionar un elemento de la IU adyacente que actúe como anclaje adicional. Puedes indicar hasta tres anclajes para cualquier destino.

El El botón expande la sección de destino en las Opciones de selección, lo que te permite configurar los métodos de destino utilizados para el descriptor actual.

El elimina el destino que has indicado y te permite elegir otro.

Configurar el descriptor

Opciones

La sección Opciones se puede expandir para mostrar las siguientes opciones:

Aplicar cambios automáticamente : cuando se selecciona, aplica cambios automáticamente a los elementos de destino y de anclaje.
Sitios web dinámicos : cuando se selecciona, permite que el anclaje se mueva automáticamente de la izquierda a la parte superior del destino, o de arriba a la izquierda del destino, lo que le permite automatizar los sitios web dinámicos.
Visibilidad del elemento : comprueba si el elemento de la IU está visible o no. Hay tres opciones disponibles en el menú desplegable:
- Ninguno : no comprueba la visibilidad.
- Interactivo (para Selector difuso) : opción predeterminada. Solo se aplica al método de orientación Selector difuso. No tiene implicaciones en el selector estricto ni en otros métodos de orientación. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de la página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando se intenta garantizar que no se está apuntando a elementos invisibles que existen en el DOM, pero que están ocultos. El propósito es filtrar los elementos que no son visibles o que están oscurecidos por otros elementos (lo que los haría no interactivos).
- Totalmente visible : garantiza que el elemento de la interfaz de usuario está visible en la pantalla.

Selector de ventanas

La sección Selector de ventana se puede expandir para ver y editar el selector de la aplicación de destino indicada. También puedes usar el botón Abrir en el Explorador de IU para editar el selector de ventana en el Explorador de IU.

Destino

Un objetivo es un elemento de la IU con el que se desea interactuar, como un botón en el que hacer clic, un cuadro de texto para escribir o una parte de una página web desde la que se puede copiar un texto.

El proceso interno de búsqueda de elementos de IU utiliza varios métodos de destino:

Estos métodos de destino son redundantes entre sí y hay una clasificación en función de la cual se utilizan los métodos de destino. La jerarquía tiene en cuenta el poder de orientación y la resistencia a los cambios de la IU de cada método de orientación. Por lo tanto, el orden en el que se encuentra el elemento de IU es el siguiente:

El método de orientación principal está representado por selectores: Selector estricto o Selector difuso.
El método de orientación secundario es Computer Vision.
El método de orientación terciaria es Imagen (deshabilitado de forma predeterminada).

El El icono se muestra junto al método de destino principal en tiempo de diseño, simulando el escenario en tiempo de ejecución.

Configuración predeterminada del proyecto para métodos de destino en todas las tecnologías

La siguiente tabla muestra la configuración predeterminada del proyecto para los métodos de destino en diferentes tecnologías.

Métodos de destino	Aplicaciones de escritorio	Navegadores web	Java	SAP
Selector estricto
Selector difuso
Computer Vision
Imagen

Configuración del proyecto: esperar al método de orientación principal hasta el tiempo de espera

La configuración del proyecto Esperar el método de destino principal hasta el tiempo de espera (Configuración del proyecto > Automatización de IU moderna), que está habilitada de forma predeterminada en los nuevos proyectos que comienzan con la versión 23.10.3 del paquete de actividades y que puede habilitarse manualmente para los proyectos creados antes de esta versión del paquete de actividades , ofrece al método de orientación principal algo de tiempo adicional para consumir su tiempo de espera completo hasta que se pueda utilizar cualquier método de orientación alternativo.

Si uno de los métodos de orientación principales logra encontrar el elemento de IU hasta que expira el tiempo de espera, entonces se utilizará como método para interactuar con el elemento de IU. El selector estricto es el método de orientación que primero busca el elemento de IU, seguido de cerca por el selector difuso. Además, el selector estricto tiene prioridad sobre el selector difuso.

Cuando el elemento de IU no es encontrado por los métodos de orientación principales hasta que se agota el tiempo de espera, por lo que tras todos los reintentos dentro del tiempo de espera asignado, ni el selector estricto ni el selector difuso encuentran el elemento de IU, solo entonces los métodos de orientación secundarios y terciarios comenzarán a buscar el elemento de IU en un tiempo de espera propio.

Esta configuración del proyecto también aporta más previsibilidad y visibilidad en los problemas relacionados con el selector para que puedas tener un mejor control sobre la orientación de los elementos de la IU, al tiempo que tienes la sólida alternativa que proporciona Computer Vision.

Si deshabilitas esta configuración del proyecto, todos los métodos de orientación competirán en en un solo tiempo de espera para encontrar el elemento de la IU en función de la jerarquía: un destino encontrado por el método de orientación de rango inferior solo se utiliza si un método de orientación de rango superior no lo hace.

Configuración del proyecto: mostrar las coincidencias más cercanas en el mensaje de error "Elemento no encontrado"

La configuración del proyecto Mostrar coincidencias más cercanas en el mensaje de error "Elemento no encontrado" (Configuración del proyecto > Automatización de IU moderna) está habilitada de forma predeterminada en los nuevos proyectos que comienzan con la versión 23.10.3 del paquete de actividades y se puede habilitar manualmente para los proyectos creados antes de esta versión del paquete de actividades. Cuando esta configuración está habilitada junto con la configuración del proyecto Esperar el método de orientación principal hasta el tiempo de espera , si un selector falla, se muestra una advertencia en los registros que muestra el método utilizado para encontrar el elemento de la IU junto con diez sugerencias de las coincidencias de selector más cercanas que pueden utilizarse para sustituir el selector defectuoso.

No se recomienda editar manualmente el descriptor, ya que todo este proceso está pensado para resultar fluido para el usuario y debe proporcionar buenos resultados sin la necesidad de una configuración avanzada. Aún así, si quieres configurar características más avanzadas para tu descriptor, puedes habilitar, deshabilitar y editar los métodos de destino.

Selector estricto

Un selector es un fragmento XML que contiene los atributos de un elemento de interfaz de usuario y sus elementos principales, incluida la aplicación de destino. Los selectores se utilizan para dirigirse a los elementos de la interfaz de usuario en la pantalla, inspeccionándolos y sus atributos, y haciéndolos coincidir con los atributos en el selector. Puedes obtener más información sobre qué es un selector en el ecosistema de UiPath viendo esta página.

El selector estricto del elemento de destino se puede editar desde la sección dedicada en la ventana Opciones de selección. También puede usar el botón Abrir en el Explorador de IU para editar el selector en el Explorador de IU.

El campo Selector estricto admite el uso y la creación de variables y argumentos desde el menú de contexto (accesible haciendo clic con el botón derecho).

También puede seleccionar una parte del selector y usar el menú contextual para convertirlo directamente en una variable que se rellena previamente con su selección.

También puedes seleccionar una variable ya creada del menú desplegable Nombre de variable y usarla en tu selector.

La casilla de verificación Anular valor predeterminado te permite reemplazar el valor de tu variable predefinida con tu selección actual.

El botón Confirmar guarda los cambios que ha realizado en su selector.

Están disponibles los siguientes atajos de teclado:

Ctrl+Space: elegir variable
Ctrl+Shift+Space: elegir argumento
Ctrl+K: crear variable
Ctrl+M: crear argumento

Importante:

Si una variable y un argumento tienen el mismo nombre, la variable será siempre la predeterminada y se utilizará en el runtime.

Los argumentos con nombres idénticos a las variables se ocultan del menú de selección de variables en la pantalla de selección.

Los cambios realizados con variables y argumentos se pueden propagar a todas las demás instancias donde se encuentren. Por ejemplo, si se utiliza una variable tanto en los campos Selector estricto como en Selector difuso, cambiarla en uno de los campos generará un mensaje que le informará de que se encontró el mismo valor en otro campo y le ofrecerá la opción de reemplazar todas las instancias por el nuevo valor.

Los selectores estrictos también admiten caracteres comodín, que pueden utilizarse para reemplazar cero o varios caracteres en una cadena. Puedes obtener más información sobre esta funcionalidad aquí.

Selector difuso

Un selector difuso es un selector que tiene en cuenta los posibles cambios en los atributos de un elemento, identificándolos en función de un patrón, en lugar de una coincidencia exacta. Este método funciona mejor cuando se utiliza con anclajes.

El selector difuso es muy similar al selector estricto, con la diferencia de que sus atributos tienen una coincidencia aproximada en lugar de una coincidencia perfecta. Esto significa que un selector difuso puede generar múltiples elementos, a diferencia del selector estricto, que genera un solo elemento a la vez.

El selector difuso se puede editar desde su sección dedicada en la ventana Opciones de selección.

La precisión de coincidencia del selector difuso se basa en el algoritmo de distancia de Levenshtein para hacer recuento de la similitud de los selectores. El valor predeterminado es 0.5 y se puede configurar desde el control deslizante Precisión o directamente desde el campo de entrada escribiendo un valor válido. La precisión de coincidencia se puede establecer dentro de un rango de 0,4 a 1, donde un valor inferior indica un mayor grado de difuminación, lo que significa que el selector difuso genera más elementos y un valor superior indica un menor grado de difuminación, lo que significa que el selector difuso genera menos elementos.

Al igual que el selector estricto, el campo del selector difuso admite el uso y la creación de variables y argumentos, y también admite comodines. Para obtener más información, consulta la información proporcionada anteriormente.

Si el elemento indicado contiene texto, el texto se muestra en el cuadro de entrada debajo de la ventana de edición del selector difuso. Si se muestra texto en este cuadro de entrada, en tiempo de ejecución debe encontrarse en el propio elemento para que se considere una coincidencia.

El menú desplegable junto al cuadro de entrada tiene las siguientes opciones:

El texto es/ El TextoInteriores/El TextoCompleto es (dependiendo del método de extracción de texto utilizado): muestra el texto que se extrae; el mejor método de extracción se identifica automáticamente y se recomienda su uso.
Ignorar texto : ignora el texto especificado en el cuadro de entrada.

Cuando falla la búsqueda de destino o anclaje utilizando un selector difuso, se lanza una excepción personalizada que muestra las coincidencias más cercanas para reparar el selector fallido.

The UI element could not be located using the configured Fuzzy selector for Target or Anchor.

'Target' search failed for selector:
	<ctrl name='Use*' role='radio button' /><ctrl name='Use mimi' role='XYZ text' automationid='' />
These are the closest selector matches found:
	[84%] <ctrl name='Use Amount' role='radio button' /><ctrl role='text' automationid='' />
	[83%] <ctrl name='Use Both' role='radio button' /><ctrl role='text' automationid='' />
	[82%] <ctrl name='Use Piece Count' role='radio button' /><ctrl role='text' automationid='' />
	
'Anchor 1' search failed for selector:
	<ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='XYZ Config' />
These are the closest selector matches found:
	[78%] <ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='Configuration' />
	[64%] <ctrl name='Transaction #:' role='text' /><ctrl name='Transaction #:' role='text' automationid='' check:text='Transaction #:' />
	[63%] <ctrl name='Deposit transaction' role='text' /><ctrl name='Deposit transaction' role='text' automationid='' check:text='Deposit transaction' />
	
'Anchor 2' search failed for selector:
	<ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use XYZZZZZZ' />
These are the closest selector matches found:
	[83%] <ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use Both&#xD;&#xA;' />
	[74%] <ctrl name='Use Amount' role='radio button' automationid='' check:fulltext='Use Amount&#xD;&#xA;' />
	[68%] <ctrl name='Use Piece Count' role='radio button' automationid='' check:fulltext='Use Piece Count&#xD;&#xA;' />The UI element could not be located using the configured Fuzzy selector for Target or Anchor.

'Target' search failed for selector:
	<ctrl name='Use*' role='radio button' /><ctrl name='Use mimi' role='XYZ text' automationid='' />
These are the closest selector matches found:
	[84%] <ctrl name='Use Amount' role='radio button' /><ctrl role='text' automationid='' />
	[83%] <ctrl name='Use Both' role='radio button' /><ctrl role='text' automationid='' />
	[82%] <ctrl name='Use Piece Count' role='radio button' /><ctrl role='text' automationid='' />
	
'Anchor 1' search failed for selector:
	<ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='XYZ Config' />
These are the closest selector matches found:
	[78%] <ctrl name='Configuration' role='text' /><ctrl name='Configuration' role='text' automationid='' check:text='Configuration' />
	[64%] <ctrl name='Transaction #:' role='text' /><ctrl name='Transaction #:' role='text' automationid='' check:text='Transaction #:' />
	[63%] <ctrl name='Deposit transaction' role='text' /><ctrl name='Deposit transaction' role='text' automationid='' check:text='Deposit transaction' />
	
'Anchor 2' search failed for selector:
	<ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use XYZZZZZZ' />
These are the closest selector matches found:
	[83%] <ctrl name='Use Both' role='radio button' automationid='' check:fulltext='Use Both&#xD;&#xA;' />
	[74%] <ctrl name='Use Amount' role='radio button' automationid='' check:fulltext='Use Amount&#xD;&#xA;' />
	[68%] <ctrl name='Use Piece Count' role='radio button' automationid='' check:fulltext='Use Piece Count&#xD;&#xA;' />

Las coincidencias más cercanas no se muestran si modificas el selector predeterminado añadiendo o eliminando nodos selectores o si la búsqueda de destino o anclaje ha fallado debido a varias coincidencias.

Puedes encontrar más información sobre los selectores en la guía de Studio.

Computer Vision

Computer Vision es un motor impulsado por IA que permite a los UiPath Robots ver y comprender cada elemento de IU en una pantalla de ordenador.Computer Vision mejora la orientación: cuando el controlador no puede "ver" algunos elementos de la IU, Computer Vision puede habilitar la automatización de la IU. Así que aumenta la fiabilidad y la resistencia al cambio en las automatizaciones basadas en la IU y es una potente alternativa a los otros métodos de destino.

Computer Vision está ampliamente disponible: ya sea en Studio Desktop para Windows y proyectos multiplataforma o en Studio Web.

Para utilizar Computer Vision como método de orientación, debes ir a Configuración del proyecto > Computer Vision y asegurarte de establecer el punto final del servidor correcto. Puedes dejar este campo tal como está y utilizar UiPath Cloud, que se rellena de forma predeterminada, o puedes introducir otro valor seleccionando cualquiera de los otros puntos finales públicos específicos de una región del servidor o tu propio servidor local.

Otra forma de utilizar Computer Vision como método de orientación es establecer Usar servidor local en Verdadero. Esto implica que el paquete UiPath.ComputerVision.LocalServer se instale en tu proyecto. Cuando el servidor local está habilitado, el valor del servidor se sobrescribe. Sin embargo, el servidor local no está disponible en proyectos multiplataforma.

Imagen

Este método de orientación utiliza una imagen en la ventana de la aplicación que identifica el elemento, por ejemplo, un icono o un botón.

Si se utiliza la automatización de imagen para su destino, también puede ver la captura de pantalla del elemento, así como ajustar la precisión de la imagen. El valor predeterminado es 0,8 y se puede configurar desde el control deslizante Precisión o directamente desde el campo de entrada escribiendo un valor válido. La precisión se puede establecer en un rango de 0,4 a 1. Para más información, consulta la sección Automatización de imágenes y texto .

Si desea definir destinos de solo imagen, puede usar la selección de región de imagen (F3) o dibujar una selección de cuadro del área que desea usar como destino / anclaje mientras lo indica.

También puede utilizar la actualización para actualizar manualmente la imagen que has seleccionado, en caso de que la imagen del elemento haya cambiado desde que se indicó.

El método de orientación de imagen está deshabilitado de forma predeterminada en la configuración del proyecto.

Para habilitarlo en el nivel de proyecto, ve a Configuración del proyecto > Automatización de IU moderna > Métodos de destino - Aplicaciones de escritorio / Métodos de destino - Navegadores web / Métodos de destino - Java / Métodos de destino - SAP (dependiendo del tipo de aplicación que quieras automatizar) > Imagen > seleccionar Verdadero.

Para habilitar el método en un elemento especificado, el elemento debe ser válido.

Texto nativo

Si seleccionaste la casilla de verificación Habilitar texto nativo al indicar el elemento, se utiliza el método de destino Texto nativo. Este método te permite utilizar todas las etiquetas de texto que se identifican con el método Nativo para identificar el elemento con el que quieres interactuar.

La etiqueta de texto identificada a través de este método puede editarse desde su sección dedicada, y puedes especificar si quieres que el texto distinga o no entre mayúsculas y minúsculas usando el botón Alternar distinción entre mayúsculas y minúsculas .

Editar sin conexión

Cuando una aplicación ya no está abierta pero quieres editar su descriptor, selecciona Editar objetivo (E) en el menú contextual en el cuerpo de la actividad te pide Reintentar , Editar sin conexión o Cancelar .

Al seleccionar la opción Editar sin conexión , se abre la pantalla de selección en el modo de edición sin conexión. En el modo de edición sin conexión, no se pueden añadir anclajes, validar el descriptor u otra funcionalidad que requiera una aplicación en vivo.

Si seleccionas la casilla No volver a mostrar , la próxima vez que quieras editar el destino, se abrirá directamente la pantalla de selección.

Validando el descriptor

El proceso de validación te permite comprobar la eficacia de la selección actual en la identificación del destino, comprobándolo utilizando todos los métodos y anclajes seleccionados. Puedes validar tu selección utilizando el botón Validar en la pantalla de selección. El resultado de la validación se muestra en la parte superior de la ventana Opciones de selección. Si se necesitan los ajustes, se muestra un mensaje con información sobre cómo mejorar la selección.

Si tienes un par de destino y anclaje, cada uno de ellos utiliza todos los métodos de destino disponibles. Para encontrar el destino final, todas las combinaciones posibles de cada uno de estos elementos se emparejan con los elementos de la pantalla y se puntúa después de la coincidencia.

Después de realizar la validación, si se encuentran duplicados, se resaltan en la aplicación de destino. Si no se encuentran duplicados, los iconos aparecen junto con los métodos de orientación, lo que te informa del estado de cada método de orientación en la situación determinada.

El rendimiento de cada método se muestra en la sección de Configuración de la ventana de Opciones de selección utilizando uno de los siguientes iconos:

: el método de orientación que fue el más rápido para identificar correctamente el elemento.

: el método identificó correctamente el elemento, pero no fue el más rápido.