Ámbito del elemento

Actividad de ámbito de elemento que se adjunta a un elemento de IU existente y lo expone como ámbito para varias actividades secundarias.

Importante:

La actividad Ámbito de elemento moderna solo está disponible en Vista previa.

UiPath.UIAutomationNext.Activities.NElementScope

Descripción

La actividad Ámbito del elemento identifica un único elemento de la IU una vez y luego lo expone como el ámbito para cada actividad colocada en su cuerpo. Todas las actividades secundarias (por ejemplo, Hacer clic, Escribir en, Obtener texto, Obtener atributo) se dirigen a elementos relativos al elemento que has indicado, en lugar de buscar de nuevo en toda la pantalla.

Úsalo cuando quieras ejecutar varias acciones dentro del mismo contenedor (una fila de tabla, una sección de formulario, una tarjeta o un panel) mientras mantienes los selectores cortos, estables y rápidos.

El cuerpo de la actividad es un contenedor. Las actividades secundarias que deben dirigirse al elemento indicado (o sus descendientes) se colocan dentro del cuerpo. Cada actividad secundaria se ejecuta en el elemento capturado por el ámbito, por lo que solo indicas el elemento principal una vez.

Nota:

El ámbito del elemento se puede colocar dentro de una actividad Usar aplicación/navegador , de modo que el elemento se resuelva dentro del ámbito de esa aplicación/navegador y las actividades secundarias puedan heredar su configuración. También se puede utilizar por sí solo indicando un elemento directamente.

Compatibilidad de proyectos

Windows | Multiplataforma

Configuración

• Indicar en pantalla : indica el elemento de IU al que quieres adjuntar. Una vez indicada, la tarjeta de actividad muestra una vista previa del elemento de destino y sus anclajes.
  Después de indicar el destino, gestiona el destino seleccionando el botón de opciones del menú y eligiendo una de las siguientes opciones:
  • Indicar destino : indica el destino de nuevo. Si el Descriptor está definido en el Repositorio de objetos, debes desvincularlo antes de poder indicar un Descriptor solo para la actividad actual.
  • Editar destino : abre el asistente de selección para configurar el elemento de destino.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla del elemento de destino.
  • Cambiar captura de pantalla informativa : cambia la captura de pantalla del elemento de destino.
  • Mostrar en el repositorio de objetos : abre el panel Repositorio de objetos con el Descriptor seleccionado.
  • Desvincular del repositorio de objetos : desvincula el descriptor del repositorio de objetos.
  • 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.

Panel de propiedades

Destino

El elemento de IU al que se adjunta el ámbito. El destino se configura cuando indicas el elemento en la pantalla y se puede refinar utilizando las siguientes opciones:

• Selector de ventana (instancia de la aplicación): el selector para la ventana de la aplicación (aplicación/navegador).
• Selector estricto : el selector generado para el elemento indicado. Un selector es un fragmento XML que identifica el elemento por sus atributos.

Opciones

• 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.
  • Igual que la aplicación/navegador : hereda la configuración de la actividad principal Usar aplicación/navegador .
  • Heredar la configuración del trabajo : aplica la configuración definida en Gobernanza o en Orchestrator en el nivel de proceso o trabajo.
  • Deshabilitado : desactiva Healing Agent para esta actividad.
  • 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.
• 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 (True, False). El valor predeterminado es False. Como resultado, si el campo está en blanco y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en True, la ejecución del proyecto continúa independientemente de cualquier error.
• Modo de entrada : especifica qué tecnología se utiliza para interactuar con el elemento de destino. Las actividades secundarias dentro del ámbito pueden heredar este modo. Las opciones disponibles son:
  • Eventos de hardware : actúa como un usuario real, utilizando el ratón y el teclado a través del sistema operativo. Emula completamente el comportamiento humano, pero algunos eventos pueden perderse y la aplicación de destino debe estar enfocada.
  • Simular : simula la acción utilizando las API de accesibilidad. Recomendado para navegadores, aplicaciones basadas en Java y SAP. Suele ser más fiable que los Eventos de hardware, envía todo el texto en una sola acción y funciona incluso cuando la aplicación de destino no está enfocada. Verifique que el elemento de destino lo admita.
  • API de Chromium : realiza acciones utilizando las API de depuración. Funciona solo para elementos de Chromium. Envía todo el texto de una vez y funciona cuando la aplicación de destino no está enfocada.
  • Mensajes de ventana : utiliza mensajes de Win32. Recomendado para aplicaciones de escritorio. Suele ser más fiable que los Eventos de hardware, envía todo el texto a la vez y funciona incluso cuando la aplicación de destino no está enfocada. Verifique que el elemento de destino lo admita.
  • Segundo plano : se ejecuta en segundo plano. Utiliza Simular siempre que sea posible; las actividades complejas (imagen, texto nativo) aún se ejecutan en primer plano.

Plazos

• Tiempo de espera : especifica la cantidad de tiempo (en segundos) que se debe esperar para encontrar el elemento de destino antes de arrojar un error. El valor predeterminado es 30 segundos.

Nota:

Las propiedades Retraso antes y Retraso después no son utilizadas por el Ámbito del elemento y están ocultas en el Diseñador. La configuración de retraso en el nivel de proyecto no se aplica intencionadamente a esta actividad.

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 : el elemento de IU resuelto, almacenado en un objeto UiElement . Esta variable puede pasarse a otras actividades que acepten UiElement como entrada.