Buscar elementos secundarios

UiPath.Core.Activities.FindChildren

Recupera una colección de elementos de la interfaz de usuario secundarios según un alcance y un criterio de filtro especificados.

Propiedades

Entrada

• Filtro : el filtro es un selector. La actividad busca todos los elementos secundarios o descendientes del elemento de destino, que coincidan con el selector. Por ejemplo, el uso de <webctrl tag='UL' /> iniciaría una búsqueda de elementos de la lista desordenados dentro de una página web determinada.

  Nota:

  Si la condición de filtro que estás utilizando deja fuera todos los elementos posibles, se devuelve una lista vacía de elementos.

Opciones

• Ámbito: permite establecer el ámbito de los elementos de la IU en la colección. Las siguientes opciones están disponibles:
  • ENCONTRAR_NIÑOS : la búsqueda incluye los elementos secundarios inmediatos del elemento.
  • ENCONTRAR_DESCENDIENTES : la búsqueda incluye los descendientes del elemento, incluidos los elementos secundarios.
  • FIND_TOP_LEVEL : la búsqueda incluye el orden y el número de elementos secundarios.
  • ENCONTRAR_PROCESO : la búsqueda incluye los tipos de datos para los elementos secundarios.
  • ENCONTRAR_HILO : la búsqueda incluye los valores predeterminados y fijos para los elementos secundarios.

Salida

• Children - All UI children found according to the filter and scope set. The field supports only IEnumerable<UiElement>variables.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.
• Destino.Selector: propiedad de texto utilizada para encontrar un elemento de la IU concreto cuando se ejecuta la actividad. En realidad es un fragmento XML que especifica atributos del elemento GUI que buscas y de algunos de sus elementos principales.
• Destino.TiempoDeEspera: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de arrojar el error SelectorNotFoundException.El valor predeterminado es 30000 milisegundos (30 segundos).
• Target.WaitForReady: antes de realizar las acciones, espera a que el objetivo esté listo. Las siguientes opciones están disponibles:
  • Ninguno: no espera a que exista nada, excepto el elemento de interfaz de usuario de destino, antes de ejecutar la acción. Por ejemplo, puedes utilizar esta opción si quieres recuperar solo el texto de una página web o hacer clic en un botón concreto, sin tener que esperar a que se carguen todos los elementos de la interfaz de usuario. Ten en cuenta que esto puede tener consecuencias no deseadas si el botón depende de elementos que aún no están cargados, como los scripts.
  • Interactivo/Completo: espera a que existan todos los elementos de la IU en la aplicación de destino antes de ejecutar la acción.Para evaluar si una aplicación está en estado Interactivo o Completo, se verifican las siguientes etiquetas:
  • Aplicaciones de escritorio: se envía un mensaje wm_null para comprobar la existencia de las etiquetas <wnd>, <ctrl>, <java> o <uia>.Si existen, se ejecuta la actividad.
  • Aplicaciones web:
  1. Internet Explorer: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML es Completo. Además, el Ocupado tiene que estar en "Falso".
  2. Otros: la etiqueta <webctrl> se utiliza para comprobar si el estado Listo del documento HTML está Completo.
  • Aplicaciones SAP: primero se verifica la presencia de la etiqueta <wnd>, después se utiliza una API específica de SAP para detectar si la sesión está ocupada o no.
• Target.Element utiliza la variable ElementoDeIU devuelta por otra actividad. Esta propiedad no se puede utilizar junto con la propiedad Selector. Este campo solo admite variables ElementoDeIU.
• Destino.ÁreaDeRecorte: define el rectángulo de recorte, en píxeles, relativo al ElementoDeIU, en las siguientes direcciones: izquierda, arriba, derecha, abajo. Admite tanto números positivos como negativos.

Común

• Nombre para mostrar: el nombre para mostrar de la actividad.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Nota:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.