Clic

UiPath.UIAutomationNext.Activities.NClick

Descripción

Hace clic en un elemento de la IU especificado, por ejemplo, un botón o un enlace. Se puede configurar para usar cualquier botón del ratón, hacer doble clic y se puede utilizar en combinación con un modificador de clave.

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.

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.

• Indicar objetivo en pantalla

  • Indique el elemento de la IU que se utilizará como destino. 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.

• Verificar : define el paso de verificación de la ejecución de la actividad.

  • Ninguno : indica que no se realiza ninguna verificación en el elemento de destino.
  • Elemento aparecido : comprueba si aparece el elemento.
  • Elemento desaparecido : comprueba si el elemento desaparece.
  • Texto del elemento cambiado : comprueba si hay algún cambio en el texto del elemento.

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

• Tipo de clic : selecciona en el menú desplegable el tipo de clic a realizar: Simple, Doble, Abajo o Arriba. La opción predeterminada es Único.
• Botón del ratón : selecciona en el menú desplegable el botón del ratón con el que hacer clic: Izquierda, Centro o Derecha. La opción predeterminada es Izquierda.
• Modificadores de teclas : añade uno o más modificadores de teclas para usar en combinación con el clic. Las siguientes opciones están disponibles: Alt, Ctrl, Mayúsculas y Win.
• Alterar elemento deshabilitado : si se selecciona, la actividad ejecuta la acción incluso si el elemento de la IU especificado está deshabilitado. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Esta propiedad no se aplica si la propiedad Modo de entrada está establecida en Eventos de hardware.
• Activar : trae el elemento de la IU al primer plano y lo activa antes de hacer clic en él. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Verdadero.
• 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 .
• Desbloquear entrada : debe usarse cuando la acción de clic desencadena un cuadro de diálogo modal o cualquier otro elemento de la IU que bloquee una mayor interacción. Solo funciona junto con el método de entrada Simular . Este campo solo admite valores booleanos (Verdadero, Falso).
• Input mode - Select which method the Robot should use to interact with the target application:
  • Igual que Navegador : utiliza la configuración Modo de entrada de la actividad principal Usar navegador .
  • Eventos de hardware : actúa como un usuario real utilizando entradas de "hardware" como los movimientos del ratón o las pulsaciones del teclado para interactuar con las aplicaciones. Estos son eventos desencadenados por hardware enviados directamente al sistema operativo. Aunque este método ofrece una emulación de comportamiento del 100 %, algunos eventos pueden perderse ocasionalmente. Como desarrollador, es tu responsabilidad garantizar que todos los eventos lleguen de forma fiable a la aplicación de destino.
  • API de Chromium : realiza acciones utilizando las API de depuración. Funciona solo para elementos de Chrome y Edge. Envía todo el texto de una vez. Funciona si la aplicación de destino no está enfocada.
  • Simular : simula el clic utilizando las API de accesibilidad. Funciona para navegadores. Envía todo el texto de una vez. Este método de entrada funciona en segundo plano (incluso si la aplicación de destino no está enfocada).
• 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 .
• 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.

Destino

• Expandir propiedades de destino : muestra las propiedades de destino y anclaje. Esto ocultará las otras propiedades de la actividad y mostrará solo las relacionadas con el destino.

• Contraer propiedades de destino : oculta las propiedades de destino y anclaje. Esto ocultará las propiedades relacionadas con el destino y mostrará las propiedades de la actividad.

• 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 : el selector estricto generado para el elemento de IU de destino.
  • Selector difuso : los parámetros del selector difuso.
  • 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.
    • Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
    • Texto de CV : indica el texto identificado mediante Computer Vision.
    • Ocurrencia de texto CV : indica una ocurrencia específica que se utilizará cuando se encuentran varias coincidencias.
    • Precisión del texto CV : indica el nivel de precisión para la coincidencia de texto OCR.
  • 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.
  • Imagen (solo Windows)
    • Precisión de imagen : indica el nivel de precisión para la coincidencia de imágenes.
    • Repetición de imagen : indica una repetición específica que se utilizará cuando se encuentran varias coincidencias.
  • Texto nativo (solo Windows)
    • Texto nativo : el texto que se buscará para identificar el elemento de la IU.
    • Ocurrencia de texto nativo : indica una ocurrencia específica que se utilizará cuando se encuentran varias coincidencias.

• Selector de ventana (instancia de la aplicación) : selector para la ventana de la aplicación. Solo aplicable cuando el modo de adjuntar ventana se establece en instancia de aplicación.

• 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. Las opciones son:

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

• Comprobación de visibilidad : cuando se habilita, la actividad también 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.

• Sitios web adaptables : habilita el diseño de sitios web adaptables.

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

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 Indicar en aplicación/navegador para indicar el elemento de IU que se utilizará como destino.

Después de indicar el destino, selecciona el 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.
• 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 puede reutilizarse en todo tu proceso de automatización.

• Tipo de clic : selecciona en el menú desplegable el tipo de clic a realizar: Simple, Doble, Abajo o Arriba. La opción predeterminada es Único.
• Botón del ratón : selecciona en el menú desplegable el botón del ratón con el que hacer clic: Izquierda, Centro o Derecha. La opción predeterminada es Izquierda.
• Indicar destino de verificación en pantalla : indica el elemento de IU que se utilizará como destino y que debe aparecer o desaparecer después de realizar la acción. Utiliza esta característica cuando quieras asegurarte de que una acción específica realizada por la actividad se ejecutó correctamente durante el tiempo de ejecución. Esto es particularmente útil en procesos automatizados, donde necesitas confirmar que elementos específicos de la IU aparecen o desaparecen como resultado de una acción. Añade una capa adicional de verificación para garantizar que el proceso se ejecuta como se espera. Por lo tanto, si tu proceso de automatización depende de la correcta ejecución de ciertos pasos, probablemente quieras verificar la ejecución. Esta característica puede habilitarse desde la Configuración 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á 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.

• Tipo de clic : consulta Tipo de clic en el panel Diseñador.

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

• Botón del ratón : consulta Botón del ratón en el panel Diseñador.

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

• Verificar ejecución : en tiempo de ejecución, verifica si la acción realizada por la actividad fue correcta. Esto se hace indicando un elemento que debe aparecer o desaparecer después de realizar la acción, que se supervisa y verifica después de ejecutar la actividad. Esta característica puede habilitarse desde la Configuración del proyecto, o desde el cuerpo de la actividad, seleccionando Añadir verificación en el menú contextual.

  • Nombre para mostrar : el nombre para mostrar de la acción de verificación. Este campo se rellena automáticamente en función de la acción de verificación y el elemento que haya elegido. Una vez configurada la ejecución de Verificar , este nombre para mostrar se vuelve visible en la tarjeta de actividad.
  • Reintentar : cuando se selecciona, la acción se vuelve a intentar durante el tiempo de espera de la actividad, si no se ha conseguido el resultado esperado. De forma predeterminada, esta casilla de verificación está seleccionada.
  • Destino : este destino se utiliza para indicar el elemento que quieres verificar en tiempo de ejecución. Para obtener más información sobre los campos de propiedad que se pueden expandir en 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) que se debe esperar a que aparezca, desaparezca o cambie el elemento de verificación. Si la casilla Reintentar está seleccionada, la acción se realiza de nuevo, seguida de la verificación, durante la duración especificada en la propiedad Tiempo de espera de la actividad. El valor predeterminado es 10 segundos.

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

• Activar : trae el elemento de la IU al primer plano y lo activa antes de hacer clic en él. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Verdadero.

• Alterar elemento deshabilitado : si se selecciona, la actividad ejecuta la acción incluso si el elemento de la IU especificado está deshabilitado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Esta propiedad no se aplica si la propiedad Modo de entrada está establecida en Eventos de hardware.

• 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 .
• Desbloquear entrada : debe usarse cuando la acción de clic desencadena un cuadro de diálogo modal o cualquier otro elemento de la IU que bloquee una mayor interacción. Solo funciona junto con el método de entrada Simular . Este campo solo admite valores Boolean (Verdadero, Falso).
• 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 .
  • Eventos de hardware : utiliza el controlador de hardware para realizar la acción. Este es el método más lento, no puede funcionar en segundo plano, pero es compatible con todas las aplicaciones de escritorio. Esta opción se selecciona de forma predeterminada si cambias la configuración predeterminada para cualquiera de las siguientes propiedades TipoDeClic, BotónDelRatón o ModificadoresDeClave.
  • Simular : simula el uso de las 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 acción. Funciona incluso si la aplicación de destino no está enfocada. Compruebe si el elemento de IU de su aplicación de destino lo admite. Simular solo se puede utilizar con las opciones de tipo Clic único y Botón izquierdo del ratón.
  • 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. Cuando el navegador se inicia con la API de Chromium, aparece una cinta que indica que el navegador se ha iniciado en modo de depuración. Este mensaje no aparece si la extensión se instala a través de una política.
  • Mensajes de ventana : simula el uso de 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 acción. Funciona incluso si la aplicación de destino no está enfocada. Compruebe si el elemento de IU de su aplicación de destino lo admite.
• 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. Los modificadores de teclas no se pueden utilizar con el modo de entrada Simular .