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.

This activity must be added inside a Use Application/Browser activity.

To use this activity outside a Use Application/Browseractivity, you need to provide an Input element.

Esta actividad es compatible con el repositorio de objetos.

Nota:

Si no se proporciona ningún destino para esta actividad, utiliza automáticamente el destino del ámbito donde se incluye.

Además, debido a la naturaleza de esta actividad, no se puede utilizar en segundo plano.

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

Windows (heredado), configuración de Windows

Panel del Diseñador

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

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

  • Al 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 Al elemento en el campo Tipo de desplazamiento, se ignora el campo de propiedad N.º de desplazamientos 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 haya especificado 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: El número de líneas desplazadas por un movimiento de desplazamiento se configura en la sección Configuración del ratón en Windows. Si se desplaza a un elemento específico, el elemento se busca después de que se hayan ejecutado todas las rotaciones. Al seleccionar este método también se muestra la propiedad N.º de desplazamientos en el cuerpo de la actividad.

• Desplazarse al elemento : haz clic en Indicar en aplicación / navegador para indicar el elemento de IU al que deseas desplazarte. Esta opción aparece solo si se selecciona el elemento A 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á 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.

  Importante: si se desplaza a un destino de imagen, se recomienda aumentar el valor de la propiedad Tiempo de espera para acomodar los tiempos de búsqueda de imágenes más largos.

Entrada

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

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

Elemento de 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.

Otros

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

Opciones

• N.º de desplazamientos : la cantidad de veces que desplazarse, almacenada en una variable Int32 . Si el Tipo de desplazamiento en el cuerpo de la actividad está establecido en el elemento Para, 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.

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

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

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

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

  • Elemento desalida : la referencia del elemento de la interfaz de usuario buscado, que puedes usar en otras actividades de automatización de la interfaz de usuario, en la propiedad Elemento de entrada .
  • Destino : este elemento de la interfaz de usuario tiene su propia propiedad de Destino que se puede configurar igual que el principal.
  • Tiempo de espera: la cantidad de tiempo de espera (en segundos) para que aparezca el elemento que desea. El valor predeterminado es 0,2 segundos.

Configuración multiplataforma

• Trabajar en el ámbito : elija la pestaña del navegador que representa la aplicación web que se va a automatizar.
• Desplazar contenedor : desplaza toda la página o dentro de un elemento. La opción predeterminada es Toda la página.
• Dirección dedesplazamiento : 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:
  • Al 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 el elemento buscado en la pantalla : indica el elemento de la IU al que deseas desplazarte. Esta opción aparece solo si se selecciona el elemento A 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:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.

• Número de desplazamientos : la cantidad de veces que hay que desplazarse. Esta opción aparece solo si se selecciona Distancia en el menú desplegable Tipo de desplazamiento .

Opciones adicionales

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.

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

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.
• Elemento desalida buscado : la referencia del elemento de IU buscado, para usar en otras actividades como elemento de IU de entrada. Esta opción aparece solo si se selecciona el elemento A en el menú desplegable Tipo de desplazamiento .