Exportar el árbol de la IU

UiPath.Core.Activities.ExportUiTree

Exporta todos los elementos de la IU y sus respectivos atributos y valores que se encuentran en el elemento indicado como un archivo XML o JSON.Esta actividad te ayuda a entender por qué falló un selector durante la ejecución inspeccionando la salida de la actividad y comparándola con la configuración del selector.

Propiedades

Común

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

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

Entrada

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

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• FormatoDeExportación: un desplegable que especifica el formato en el que quieres que se exporten los elementos de la IU. puede elegir entre XML y JSON. El idioma seleccionado de forma predeterminada es XML.
• RutaDeExportación: la ruta donde quieres que se cree el archivo que contiene el Árbol de la IU extraído. Si este campo se deja en blanco, el archivo se exporta como argumento ExportedString Out. Este campo solo admite cadenas y variables String.
• Filtro: un filtro que permite exportar solo determinados tipos de selectores. El Árbol de la IU exportado solo contiene elementos de la IU que dependen de los tipos de selectores especificados en este campo.
• IncluirCapturasDePantalla: si se selecciona, guarda capturas de pantalla del Árbol de la IU junto con el archivo que contiene los selectores. De forma predeterminada, esta casilla de verificación está desactivada.
• TiempoDeEsperaDeOperación (milisegundos): especifica la cantidad de tiempo (en milisegundos) que se debe esperar para que la actividad genere el archivo que contiene el árbol de interfaz de usuario exportado.
• Sobrescribir: si se selecciona, la actividad sobrescribe cualquier archivo existente en la ruta especificada en el campo de propiedad ExportPath. De forma predeterminada, esta casilla de verificación está desactivada.
• MarcoDeIU: un menú desplegable que especifica el marco de la IU utilizado para detectar los elementos de la IU de nivel superior. Hay tres opciones posibles: Por defecto, Accesibilidad activa y UiAutomation. Por defecto, está seleccionado Predeterminado. Este campo de propiedad solo se utiliza cuando se exporta el contenido de todo el escritorio.

En el cuerpo de la actividad

El cuerpo de la actividad permite configurar varios parámetros de la actividad sin interactuar con el panel Propiedades, tales como:

El botón Indicar en pantalla permite seleccionar la aplicación de destino cuyo Árbol de la IU quieres exportar.

El menú desplegable Exportar formato permite seleccionar entre los formatos JSON o XML que pueden utilizarse para el archivo exportado.

El campo Archivo de destino permite especificar la ruta en la que quieres que se guarde el archivo o Buscar la carpeta.

La casilla de verificación Incluir capturas de pantalla especifica si las capturas de pantalla de los elementos reales de la IU deben guardarse junto con el archivo que contiene el Árbol de la IU o no. De forma predeterminada, la casilla de verificación está desactivada.