Comprobar estado de aplicación

UiPath.UIAutomationNext.Activities.NCheckState

Descripción

Comprueba el estado de una aplicación o navegador web verificando si un elemento aparece o desaparece de la interfaz de usuario, y puede ejecutar un conjunto de actividades si se encuentra el elemento y un conjunto diferente si no se encuentra el elemento.

Puede supervisar una aplicación completa en busca de cambios, no solo un elemento de la interfaz de usuario.

Esta actividad se puede utilizar tanto dentro como fuera de una actividad Usar aplicación/navegador.

También se puede utilizar como condición para la actividad Reintentar ámbito.

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.
• Esperar a (aparecer/desaparecer): selecciona qué evento usar para determinar el estado de la aplicación o navegador:
  • Elemento que aparece : espera a que el elemento aparezca en la interfaz de usuario. Si seleccionas esta opción:
    • Añade las actividades para ejecutar si el elemento aparece en el bloque SiExiste .
    • Añade las actividades para ejecutar si el elemento no aparece en el bloque IfNotExists .
  • Elemento a desaparecer: espera a que el elemento desaparezca de la interfaz de usuario. Si seleccionas esta opción:
    • Añade las actividades para ejecutar si el elemento desaparece en el bloque SiExiste .
    • Añade las actividades para ejecutar si el elemento no desaparece en el bloque IfNotExists .
• Tiempo de espera (segundos) : la cantidad de tiempo que se debe esperar para que el elemento aparezca o desaparezca antes de ejecutar uno de los dos bloques de actividades. El valor predeterminado es 5 segundos.

Proprieties panel

Entrada/Salida

• Estado : un valor verdadero o falso que indica el estado detectado del destino.
• 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

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

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.

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.

• Comprobar visibilidad : cuando se habilita, la actividad comprueba también si el elemento de la interfaz de usuario está visible o no.

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.
  • Indicar en cualquier aplicación : cuando se utiliza dentro de una actividad Usar aplicación/navegador , puedes seleccionar esta opción para comprobar los estados de la aplicación para ventanas o elementos no asociados con la instancia de la aplicación actual sin tener que añadir una nueva tarjeta de aplicación.
  • 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.
• Esperar : seleccione qué evento se va a utilizar para determinar el estado de la aplicación o el navegador:
  • Elemento que aparece : espera a que el elemento aparezca en la interfaz de usuario. Si seleccionas esta opción:
    • Añade las actividades que se ejecutarán si el elemento aparece en el bloque El destino aparece .
    • Añade las actividades para ejecutar si el elemento no aparece en el bloque El destino no aparece .
  • Elemento a desaparecer: espera a que el elemento desaparezca de la interfaz de usuario. Si seleccionas esta opción:
    • Añade las actividades a ejecutar si el elemento desaparece en el bloque Destino a desaparecer.
    • Añade las actividades a ejecutar si elemento no desaparece en el bloque Destino no a desaparecer.
• Segundos : la cantidad de tiempo que se debe esperar para que el elemento aparezca o desaparezca antes de ejecutar uno de los dos bloques de actividades. Puedes elegir un valor predeterminado en el menú desplegable. El valor predeterminado es 5 segundos.
• Haga clic en Alternar ramas en el cuerpo de la actividad para configurar la visibilidad de los contenedores que aparece y no aparece en los que puede añadir actividades para ejecutar, según el estado. Puede trabajar con ambos contenedores, con uno o con ninguno. Ambos bloques están visibles de forma predeterminada.

Panel de propiedades

Común

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

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

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

• Tiempo de espera (segundos) : consulta los segundos en el panel Diseñador.
• Esperar (aparecer / desaparecer) : consulta Esperar en el panel Diseñador.

• Resultado : indica si el elemento existe o no. El campo solo admite Boolean variables. Opcionalmente, puedes guardar este valor (Verdadero/Falso) para su uso posterior o guardarlo en una celda de un archivo de Excel principal o en el Cuaderno del proyecto.