Mantener el puntero

UiPath.UIAutomationNext.Activities.NHover

Descripción

Mantiene el puntero del ratón sobre un elemento de la IU especificado.

Esta actividad debe añadirse dentro de una actividad Usar aplicación/navegador.

Para utilizar esta actividad fuera de una actividad Usar aplicación/navegador, debe proporcionar un elemento de entrada.

Esta actividad es compatible con el repositorio de objetos.

Compatibilidad de proyectos

Windows: Legacy | Ventanas | Multiplataforma

Windows and Cross-platform configuration

• Trabajar en el ámbito : elija la pestaña del navegador que representa la aplicación web que se va a automatizar.

• Indicar destino en pantalla : indica el elemento de la IU que se usará como destino.

  Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
• Duración : la duración (en segundos) durante la cual se desplaza el elemento de la interfaz de usuario. La duración predeterminada es de 1 segundo.
• Verify - Define activity execution verification step.
  • None - Indicates that no verification is performed on the target element.
  • Element appeared - Checks whether the element appears.
  • Element disappeared - Checks whether the element disappears.
  • Element text changed - Checks whether there are any changes in the text of the element.

Panel de propiedades

Entrada/Salida

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.

Opciones

• Tipo demovimiento del cursor : especifica el tipo de movimiento realizado por el cursor del ratón. Hay dos opciones disponibles:
  • Instantáneo : el cursor salta al destino. Esta es la opción predeterminada.
  • Suave : el cursor se mueve en incrementos. El ajuste solo tiene efecto si se utiliza el modo de entrada Eventos de hardware .
• Modo de entrada : selecciona qué método debe utilizar el robot para interactuar con la aplicación de destino:
  • Igual que aplicación / navegador : utiliza el mismo modo de entrada que la actividad Usar aplicación / navegador .
  • Eventos de hardware : utiliza el controlador de hardware para realizar la acción. Este es el método más lento, no funciona en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
  • Simular : simula mediante API de accesibilidad. Recomendado para navegadores, aplicaciones basadas en Java, SAP. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.
  • Chromium API - Performs actions using debugger APIs. Works only for Chromium elements. Sends all text in one go. Works even if target app is not in focus. For more details, refer to Chromium API.
  • Window Messages (Windows only) - Simulate using Win32 messages. Recommended for desktop apps. Usually more reliable than Hardware Events. Sends all text in a single action. Works even if target app is not in focus. Please test if your target application UI element supports this.
• Modo Healing Agent : configura el comportamiento del Healing Agent para esta actividad, en función de la configuración de Gobernanza u Orchestrator a nivel de proceso o trabajo.
  • Deshabilitado : desactiva Healing Agent para esta actividad.
  • Heredar la configuración del trabajo : aplica la configuración definida en Gobernanza o en Orchestrator en el nivel de proceso o trabajo.
  • Solo recomendación : permite que Healing Agent proporcione recomendaciones sobre cómo solucionar problemas de automatización de IU en trabajos en ejecución, pero solo si lo permite la configuración de Gobernanza u Orchestrator.
  • Igual que la aplicación/navegador : hereda la configuración de la actividad principal Usar aplicación/navegador .
• Continue on error - 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.

Destino

• Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.

• Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.

• Métodos de destino: los tipos de selectores que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación del menú desplegable:
  • Ninguno
  • Strict selector - The strict selector generated for the target UI element.
  • Fuzzy selector - The fuzzy selector parameters.

  • Computer Vision: 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.

    Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.

    • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
    • Texto de CV : indica el texto identificado mediante Computer Vision.
    • CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
    • CV Text accuracy - Indicates the accuracy level for OCR text matching.
  • Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
  • Image (Windows only)
    • Image accuracy - Indicates the accuracy level for image matching.
    • Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  • Native text (Windows only)
    • Native text - The text to find to identify the UI element.
    • Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
• Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
• Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
  • Ninguno: No espera a que el objetivo esté listo.
  • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
  • Completo: espera a que se cargue la aplicación completa.
• Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
  • Ninguno : no comprueba la visibilidad.
  • Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
  • Totalmente visible : comprueba si el elemento de la IU está visible o no.
• Páginas web dinámicas: habilita el diseño de páginas web dinámicas.

Target - Clipping region

• Punto deanclaje : describe el punto de inicio del cursor al que se agregan las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: Izquierda superior, derecha superior, izquierda inferior, derecha inferiory centro. De forma predeterminada, se selecciona Centro .
• Desplazamiento X : desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32.
• Desplazamiento Y : desplazamiento vertical de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32.
• Offset width - Width of the offset region.
• Offset height - Height of the offset region.

Target - Offset point

• Punto deanclaje : describe el punto de inicio del cursor al que se agregan las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: Izquierda superior, derecha superior, izquierda inferior, derecha inferiory centro. De forma predeterminada, se selecciona Centro .
• Desplazamiento X : desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Punto de anclaje .
• Desplazamiento Y : desplazamiento vertical de la posición del cursor según la opción seleccionada en el campo Punto de anclaje .

Plazos

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

Windows - Configuración heredada

• Selecciona Indicar en aplicación/navegador para indicar el elemento de IU que se utilizará como destino.

  Después de indicar el destino, seleccione el menú para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
  • Añadir verificación / Eliminar verificación : añade o elimina la característica Indicar destino de verificación en pantalla en la tarjeta de actividad. Verifique que la ejecución esté habilitada de forma predeterminada.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.
• Duration - The duration (in seconds) during which the specified UI element is hovered. You can choose a predetermined value from the drop-down menu: 1, 3, 5. The default value is 1 second. Alternatively, you can select the Plus button and use one of the options in the menu to enter the duration.
• Indicar destino de verificación en la pantalla: indica el elemento de IU que se utilizará como destino y que debe aparecer o desaparecer después de que se realice la acción. Utiliza esta característica cuando quieras asegurarte de que una acción específica realizada por la actividad se haya ejecutado correctamente durante el runtime. Esto es particularmente útil en los procesos automatizados, en los que debes confirmar que elementos de IU específicos aparecen o desaparecen como resultado de una acción. Añade una capa adicional de verificación para garantizar que el proceso se esté ejecutando como se espera. Por lo tanto, si tu proceso de automatización depende de la ejecución correcta de ciertos pasos, probablemente quieras verificar la ejecución. Esta característica se puede habilitar desde los Ajustes del proyecto o desde el cuerpo de la actividad, seleccionando Añadir verificación.

Panel de propiedades

Común

• Continuar en caso de error : 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. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

• Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.

• Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.

• Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.

• Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

• Tipo demovimiento del cursor : especifica el tipo de movimiento realizado por el cursor del ratón. Hay dos opciones disponibles:

  • Instantáneo : el cursor salta al destino. Esta es la opción predeterminada.
  • Suave : el cursor se mueve en incrementos. El ajuste solo tiene efecto si se utiliza el modo de entrada Eventos de hardware .
• Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo se establece como (null). Una vez que se indica el destino, se muestran todas las propiedades relacionadas con el elemento que se indicó.
  • Desplazamiento declic : especifica un desplazamiento para la actividad de clic, que se puede configurar posteriormente.
    • Punto deanclaje : describe el punto de inicio del cursor al que se agregan las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: Izquierda superior, derecha superior, izquierda inferior, derecha inferiory centro. De forma predeterminada, se selecciona Centro .
    • Desplazamiento X : desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
    • Desplazamiento Y : desplazamiento vertical de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
  • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
  • Texto de CV : indica el texto identificado mediante Computer Vision.
  • Selector difuso : los parámetros para el selector difuso.
  • Texto nativo : el texto que se utiliza para identificar el elemento de la interfaz de usuario.
  • Páginas web dinámicas: habilita el diseño de páginas web dinámicas.
  • Selector estricto: el selector estricto generado para el elemento de IU.
  • Métodos de destino: los tipos de selectores que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación del menú desplegable:
    • Ninguno
    • Selector estricto
    • Selector difuso
    • Imagen
    • Texto nativo
    • Computer Vision: 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.

    • Selector semántico : aprovecha los modelos lingüísticos de gran tamaño (LLM) para generar descripciones funcionales y similares a las humanas de los elementos de la interfaz de usuario. Estas descripciones son muy fiables, lo que las hace adaptables a los cambios de la interfaz de usuario y mejora significativamente la resistencia de la automatización cuando fallan los selectores tradicionales.
  • Comprobación devisibilidad: comprueba si el elemento de la IU está visible o no. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno : no comprueba la visibilidad.
    • Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
    • Totalmente visible : comprueba si el elemento de la IU está visible o no.
  • Esperar a que se cargue la página : antes de realizar las Actions, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:
    • Ninguno: No espera a que el objetivo esté listo.
    • Interactivo: espera hasta que se cargue solo una parte de la aplicación.
    • Completo: espera a que se cargue la aplicación completa.
  • Selector de ventana (instancia de aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo se aplica cuando el modo de agregación de ventana está establecido en Instancia de aplicación.

• Verificar ejecución: durante el runtime se verifica si la acción que realizó la actividad fue la correcta. Esto se lleva a cabo indicando un elemento que debería aparecer o desaparecer después de realizarse la acción, que se monitorea y se verifica después de ejecutar la actividad. Esta característica se puede habilitar desde los Ajustes del proyecto o desde el cuerpo de cada actividad seleccionando Añadir verificación desde el menú de contexto.

  • Nombre para mostrar: el nombre para mostrar de las Actionsde verificación. Este campo se rellena automáticamente en función de las Actions de verificación y el elemento que haya elegido. Una vez que se configura Verificar ejecución , este nombre para mostrar se vuelve visible en la tarjeta de actividad.
  • Reintentar : cuando se selecciona, las Actions se vuelven a intentar durante el tiempo de espera de la actividad si no se alcanzó el resultado esperado. Esta casilla de verificación está seleccionada de forma predeterminada.
  • Destino : este destino se utiliza para indicar el elemento que quieres verificar en tiempo de Runtime. Para obtener más información sobre los campos de propiedad que se pueden expandir con esta propiedad, consulta la propiedad Destino anterior, ya que la funcionalidad de las propiedades es la misma.
  • Tiempo de espera: la cantidad de tiempo (en segundos) para esperar a que aparezca, desaparezca o cambie el elemento de verificación. Si se selecciona la casilla Reintentar , las Actions se realizan de nuevo, seguidas de la verificación, durante el tiempo especificado en la propiedad Tiempo de espera de la actividad. El valor predeterminado es 10 segundos.
  • Verificar elemento : define el cambio para el que quieres comprobar el objetivo de verificación. Las opciones disponibles son:
    • Aparecido : comprueba si el elemento aparece.
    • Desapareció : comprueba si el elemento desaparece.
    • Texto cambiado : comprueba si hay algún cambio en el texto del elemento.
    • Cambiado visualmente : comprueba si hay algún cambio en la imagen del elemento.

• Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
• Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

• Duración : consulta Duración en el panel Diseñador.

• Modo de entrada : selecciona qué método debe utilizar el robot para interactuar con la aplicación de destino:

  • Igual que aplicación / navegador : utiliza el mismo modo de entrada que la actividad Usar aplicación / navegador .

  • Eventos de hardware : utiliza el controlador de hardware para realizar la acción. Este es el método más lento, no funciona en segundo plano, pero es compatible con todas las aplicaciones de escritorio.

  • Simular : simula mediante API de accesibilidad. Recomendado para navegadores, aplicaciones basadas en Java, SAP. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.

  • API Chromium: realiza acciones mediante las API de depuración. Solo funciona para elementos de Chromium. Envía todo el texto de una vez. Funciona incluso si la aplicación de destino no está enfocada. Para más detalles, visita esta página.

  • Mensajes de ventana : simula usando mensajes Win32. Recomendado para aplicaciones de escritorio. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.