Mantener el puntero en imagen

UiPath.Core.Activities.HoverImage

Busca una imagen dentro de un elemento de la interfaz de usuario y se desplaza sobre ella.

Propiedades

Entrada

• Imagen.Imagen: una imagen existente para buscar. Este campo solo admite variables de imagen.
• Imagen.Precisión: unidad de medida de 0 a 1 que expresa la similitud mínima entre la imagen buscada y la encontrada. Es útil en situaciones en las que la imagen que se desea encontrar es ligeramente diferente de la que se está buscando. El valor predeterminado es 0,8.
• Imagen.Perfil: te permite cambiar el algoritmo de detección de imágenes que quieres utilizar. Básico es el algoritmo clásico, que tiene velocidad media y coste de recursos. Mejorado puede ofrecer resultados más precisos, a expensas de más recursos. Por defecto, este campo está configurado como Básico.
• Destino.Selector: propiedad de texto utilizada para encontrar un elemento de la IU concreto cuando se ejecuta la actividad. En realidad es un fragmento XML que especifica atributos del elemento GUI que buscas y de algunos de sus elementos principales.
• Destino.TiempoDeEspera: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de arrojar el error SelectorNotFoundException.El valor predeterminado es 30000 milisegundos (30 segundos).
• Target.WaitForReady: antes de realizar las acciones, espera a que el objetivo esté listo. Las siguientes opciones están disponibles:
  • Ninguno: no espera a que exista nada, excepto el elemento de interfaz de usuario de destino, antes de ejecutar la acción. Por ejemplo, puedes utilizar esta opción si quieres recuperar solo el texto de una página web o hacer clic en un botón concreto, sin tener que esperar a que se carguen todos los elementos de la interfaz de usuario. Ten en cuenta que esto puede tener consecuencias no deseadas si el botón depende de elementos que aún no están cargados, como los scripts.
  • Interactivo/Completo: espera a que existan todos los elementos de la IU en la aplicación de destino antes de ejecutar la acción.Para evaluar si una aplicación está en estado Interactivo o Completo, se verifican las siguientes etiquetas:
  • Aplicaciones de escritorio: se envía un mensaje wm_null para comprobar la existencia de las etiquetas <wnd>, <ctrl>, <java> o <uia>.Si existen, se ejecuta la actividad.
  • Aplicaciones web:
  1. Internet Explorer: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML es Completo. Además, el Ocupado tiene que estar en "Falso".
  2. Otros: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML está Completo.
  • Aplicaciones SAP: primero se verifica la presencia de la etiqueta <wnd>, después se utiliza una API específica de SAP para detectar si la sesión está ocupada o no.
• Target.Element utiliza la variable ElementoDeIU devuelta por otra actividad. Esta propiedad no se puede utilizar junto con la propiedad Selector. Este campo solo admite variables ElementoDeIU.
• Destino.ÁreaDeRecorte: define el rectángulo de recorte, en píxeles, relativo al ElementoDeIU, en las siguientes direcciones: izquierda, arriba, derecha, abajo. Admite tanto números positivos como negativos.

Opciones

• EnviarMensajesDeWindows: si se selecciona esta casilla, mantener el puntero se ejecuta enviando un mensaje específico a la aplicación de destino. Este método de entrada es más rápido y funciona en segundo plano. De forma predeterminada, esta casilla de verificación no está seleccionada. Si la casilla no está seleccionada, el método por defecto mantiene el puntero utilizando el controlador de hardware. El método por defecto es el más lento, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
• ModificadoresDeClave: le permite añadir un modificador de clave. Las siguientes opciones están disponibles: Alt, Ctrl, Mayúsculas y Win.Nota: ModificadoresDeClave no se puede utilizar con la opción EnviarMensajesDeWindows. No se produce ningún error al ejecutar un flujo de trabajo que contenga una actividad con esta combinación de opciones.
• PosiciónDelCursor.DesplazamientoX: desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Posición.
• PosiciónDelCursor.DesplazamientoY: desplazamiento vertical de la posición del cursor según la opción seleccionada en el campo Posición.
• PosiciónDelCursor.Posición: describe el punto inicial del cursor al que se añaden los desplazamientos de las propiedades DesplazamientoX y DesplazamientoY. Están disponibles las siguientes opciones: ArribaIzquierda, ArribaDerecha, AbajoIzquierda, AbajoDerecha y Centro. La opción predeterminada es Centro.

Común

• Nombre para mostrar: el nombre para mostrar de la actividad.

• MSDeRetardo: tiempo de retraso (en milisegundos) después de ejecutar la actividad. El tiempo por defecto es de 300 milisegundos.

• Tiempo de retraso (en milisegundos) antes de que la actividad comience a realizar cualquier operación. El tiempo por defecto es de 200 milisegundos.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Nota:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Ejemplo de uso de la actividad Mantener el puntero en imagen

La actividad Mantener el puntero en imagen se utiliza para buscar una imagen dentro de un elemento de la IU y situarse sobre ella.

Para ilustrar cómo utilizar esta actividad, hemos creado un ejemplo que abre un navegador, pasa el ratón por encima de una imagen, inicia una acción y muestra los resultados relacionados con esa acción.

Así es como se puede construir el proceso de automatización:

1. Abre Studio y crea un nuevo Proceso.
2. Arrastra la actividad Secuencia al Diseñador de flujo de trabajo.
3. Arrastra una actividad Abrir navegador dentro del contenedor Secuencia.
   • En el panel Propiedades, selecciona la opción IE en la lista desplegable TipoDeNavegador.
   • Añade la expresión "https://www.goodreads.com/book/show/7144.Crime_and_Punishment"en el campo Url.
   • Seleccione la casilla de verificación para la opción NuevaSesión. Esta opción abre una nueva sesión en el navegador seleccionado.
4. Arrastra una actividad Mantener puntero en imagen dentro del contenedor Cuerpo de la actividad Abrir Navegador.
   • Abra la dirección del sitio web añadida previamente en la actividad Abrir navegador.
   • Seleccione el botón Hacer clic para abrir el menú de opciones de la actividad Mantener puntero en imagen y Haz clic en la opción Obtener de la pantalla. Seleccione la imagen deseada.
5. Arrastra una actividad Hacer clic en imagen debajo de la actividad Mantener el puntero en imagen.
   • En el panel de propiedades, selecciona la opción CLICK_SINGLE en la lista desplegable TipoDeClic.
   • Seleccione la opción BTN_LEFT de la lista desplegable BotónDelRatón.
   • Seleccione la opción Target en la lista desplegable Destino.
   • Añade la expresión "<html title='*' /><webctrl aaname='Other editions' parentid='imagecol' tag='A' />" en el campo Selector.
   • Seleccione la opción INTERACTIVE de la lista desplegable EsperarListo.
6. Ejecuta el proceso. El robot abre un nuevo navegador, accede al sitio web, pasa el ratón por encima de la imagen seleccionada y hace clic en el botón Otras ediciones.

Descargar ejemplo