Desplazamiento del ratón

UiPath.UIAutomationNext.Activities.NMouseScroll

Descripción

Habilita el desplazamiento en las aplicaciones enviando eventos de desplazamiento del ratón al 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 , debes proporcionar un Elemento de entrada.

Esta actividad es compatible con el repositorio de objetos.

Nota:

Si no se proporciona un destino para esta actividad, utiliza automáticamente el destino del ámbito en el que se incluye. Además, debido a la naturaleza de esta actividad, no se puede utilizar en modo de fondo.

Para obtener más información sobre la indicación y configuración de destinos, consulta Pantalla de selección.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Configuración de Windows y multiplataforma

• Trabajo en ámbito : elige la pestaña del navegador que representa la aplicación web para automatizar.
• Contenedor de desplazamiento : desplaza toda la página o dentro de un elemento. La opción predeterminada es Toda la página.
• Dirección de desplazamiento : la dirección en la que quieres que se realice el desplazamiento. Las siguientes opciones están disponibles: Izquierda, Arriba, Derecha, Abajo. La opción predeterminada es Abajo.
• Tipo de desplazamiento : selecciona entre los dos métodos de uso para esta actividad:
  • A elemento : se desplaza hasta que se encuentra un elemento de IU especificado en la aplicación de destino. Esta es la opción predeterminada.
  • Distancia : solo se desplaza tanto como se especifica en el campo de propiedad Número de desplazamientos .
• Indicar elemento buscado en pantalla : indica el elemento de IU al que quieres desplazarte. Esta opción solo aparece si se selecciona A elemento en el menú desplegable Tipo de desplazamiento . Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:
  • Indicate target on screen - Indicate the target again.
  • Editar destino : abre el modo de selección para configurar el destino.
• Número de desplazamientos : la cantidad de veces para desplazarse. Esta opción solo aparece si se selecciona Distancia en el menú desplegable Tipo de desplazamiento .

Panel de propiedades

Entrada/Salida

• Elemento de entrada : el elemento de la IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite objetos UIElement . Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de Automatización de IU.
• Elemento de salida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede utilizarse posteriormente para apuntar al mismo elemento con otras actividades.

Opciones

• Input mode - Select which method the Robot should use to interact with the target application:
  • Igual que la aplicación/navegador : utiliza el mismo modo de entrada que la actividad Usar aplicación/navegador .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • API de Chromium : realiza acciones utilizando 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 obtener más información, consulta API de Chromium.
• Modo Healing Agent : configura el comportamiento del Healing Agent para esta actividad, en función de la configuración de Gobernanza u Orchestrator en el 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 .
• Tipo de movimiento 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. La configuración solo tiene efecto si se utiliza el modo de entrada de eventos de hardware .
• Modificadores clave : añade uno o más modificadores clave para usar en combinación con la acción de la actividad. Las siguientes opciones están disponibles: Ninguno, Alt, Ctrl, Mayúsculas y Win. La opción predeterminada es Ninguno.
• Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Plazos

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• 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 el botón Menú para acceder a las siguientes opciones:
  • Indicate target on screen - Indicate the target again.
  • Editar destino : abre el modo de selección para configurar el destino.
  • 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 puede reutilizarse en todo tu proceso de automatización.
• Dirección : la dirección en la que quieres que se realice el desplazamiento. Las siguientes opciones están disponibles: Izquierda, Arriba, Derecha, Abajo. La opción predeterminada es Abajo.
• Tipo de desplazamiento : selecciona entre los dos métodos de uso para esta actividad:
  • A elemento : se desplaza hasta que se encuentra un elemento de IU especificado en la aplicación de destino. Esta es la opción predeterminada.
    Nota:

    Si seleccionas A elemento en el campo Tipo de desplazamiento , el campo de propiedad # de desplazamientos se ignora y se busca el elemento de IU especificado. Si, en tiempo de ejecución, no se encuentra el elemento indicado, la actividad se desplaza tanto como se especifica en el campo N.º de desplazamientos y luego vuelve a intentar la búsqueda del elemento indicado. Este comportamiento se repite tantas veces como sea necesario, hasta que se encuentra el elemento, y puede ser útil en el caso de aplicaciones que tienen tiempos de carga más largos.

  • Distancia : solo se desplaza tanto como se especifica en el campo de propiedad N.º de desplazamientos .
    Nota:

    The number of lines scrolled by a scroll movement is configured in the Mouse settings section in Windows. If scrolling to a specific element, the element is searched after all rotations are executed. Selecting this method also displays the # of scrolls property in the body of the activity.

• Desplazarse al elemento : haz clic en Indicar en aplicación/navegador para indicar el elemento de la IU al que quieres desplazarte. Esta opción solo aparece si se selecciona A elemento en el menú desplegable Tipo de desplazamiento .

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á vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.

• Nombre para mostrar : el nombre que se muestra para la actividad en el panel Diseñador. Al indicar un destino, se genera automáticamente un nombre para mostrar.

• 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.

  Importante:

  Si te desplazas a un destino de imagen, se recomienda aumentar el valor de la propiedad Tiempo de espera para adaptarse a los tiempos de búsqueda de imágenes más largos.

• Tipo de movimiento 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. La configuración solo tiene efecto si se utiliza el modo de entrada de eventos de hardware .

• Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo está establecido en (null). Una vez indicado el destino, se muestran todas las propiedades relativas al elemento indicado.

  • Desplazamiento de clic : especifica un desplazamiento para la actividad de clic, que puede configurarse aún más.
    • Punto de anclaje : describe el punto de partida del cursor al que se añaden las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: ArribaIzquierda, ArribaDerecha, AbajoIzquierda, AbajoDerecha y 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.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo : el texto que se utiliza para identificar el elemento de IU.
  • Sitios web adaptables : habilita el diseño de sitios web adaptables.
  • Selector estricto : el selector estricto generado para el elemento de IU.
  • Métodos de orientación : los tipos de selector que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación desde el 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 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 está instalado 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 de visibilidad : comprueba si el elemento de la IU es 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 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.
    • Totalmente visible
      • Comprueba si el elemento de la IU es visible o no.
  • Esperar a que se cargue la página : antes de realizar la acción, 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 la aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo aplicable cuando el modo de adjuntar ventana se establece en Instancia de aplicación.

• Elemento de entrada : el elemento de la IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite objetos UIElement . Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de Automatización de IU.

• Elemento de salida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede utilizarse posteriormente para apuntar al mismo elemento con otras actividades.

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

• Número de desplazamientos : la cantidad de veces para desplazarse, almacenada en una variable Int32 . Si el Tipo de desplazamiento en el cuerpo de la actividad se establece en A elemento, este campo se establece de forma predeterminada en 10. Si se establece en Distancia, este campo se establece en 5 de forma predeterminada.

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

• Input mode - Select which method the Robot should use to interact with the target application:

  • Igual que la aplicación/navegador : utiliza el mismo modo de entrada que la actividad Usar aplicación/navegador .
  • Hardware Events - Uses the hardware driver to perform the action. This is the slowest method, it cannot work in the background, but it is compatible with all desktop apps.
  • API de Chromium : realiza acciones utilizando 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 obtener más información, consulta esta página.

• Modificadores clave : añade uno o más modificadores clave para usar en combinación con la acción de la actividad. Las siguientes opciones están disponibles: Ninguno, Alt, Ctrl, Mayúsculas y Win. La opción predeterminada es Ninguno.

• Elemento buscado : el elemento de la IU indicado al que quieres desplazarte.

  • Elemento de salida : la referencia del elemento de IU buscado, que puedes utilizar en otras actividades de Automatización de IU, en la propiedad Elemento de entrada .
  • Destino : este elemento de la IU tiene su propia propiedad Destino que se puede configurar igual que el principal.
  • Tiempo de espera : la cantidad de tiempo (en segundos) que se debe esperar para que aparezca el elemento buscado. El valor predeterminado es 0,2 segundos.