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.
• Target.Selector : propiedad de texto utilizada para encontrar un elemento de IU concreto cuando se ejecuta la actividad. En realidad, es un fragmento XML que especifica atributos del elemento GUI que está buscando y de algunos de sus elementos principales.
• Target.TimeoutMS : especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de que se produzca el error SelectorNotFoundException . El valor predeterminado es 30 000 milisegundos (30 segundos).

• Destino.EsperaListo : antes de realizar las acciones, espera a que el destino esté listo. Están disponibles las siguientes opciones:

  • 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 que existan todos los elementos de IU de 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.
• ElementoDeDestino : usa la variable ElementoDeIU devuelta por otra actividad. Esta propiedad no se puede utilizar junto con la propiedad Selector. Este campo solo admite variables de Elemento de IU.
• Destino.Región de recorte: define el rectángulo de recorte, en píxeles, en relación con el Elemento de IU, en las siguientes direcciones: izquierda, arriba, derecha y abajo. Admite números positivos y 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 : te permite añadir un modificador de clave. Están disponibles las siguientes opciones: Alt, Ctrl, Mayús, 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

• NombreParaMostrar: el nombre de la actividad para ser mostrado.
• DelayMS : tiempo de retraso (en milisegundos) después de ejecutar la actividad. El tiempo predeterminado es de 300 milisegundos.
• RetardoAntes : tiempo de retraso (en milisegundos) antes de que la actividad comience a realizar cualquier operación. La cantidad de tiempo predeterminada es de 200 milisegundos.

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

  Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

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