Export UI Tree

UiPath.Core.Activities.ExportUiTree

Exporta todos os elementos da interface gráfica e seus respectivos atributos e valores localizados no elemento indicado como um arquivo XML ou JSON. Esta atividade ajuda a entender por que um seletor falhou durante a execução inspecionando a saída da atividade e comparando-a com a configuração do seletor.

Propriedades

Comum

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

  Observação:

  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.

• DisplayName - O nome de exibição da atividade.

Entrada

• Destino.RegiãoDeRecorte - Define o retângulo de clipagem, em pixels, em relação ao ElementoDaUi, conforme as seguintes direções: esquerda, superior, direita, inferior. Suporta números positivos e negativos.
• Target.Element - Use a variável ElementoDaUI retornada por outra atividade. Essa propriedade não pode ser usada com a propriedade Seletor. Esse campo é compatível apenas com variáveis ElementoDaUI.
• Destino.Seletor - Propriedade de texto usada para localizar um determinado elemento de interface gráfica quando a atividade é executada. Em realidade, é um fragmento XML especificando atributos do elemento GUI procurado e de alguns de seus pais.
• Destino.TempoLimiteEmMs - Especifica o período (em milissegundos) que se deve aguardar para a execução da atividade antes de gerar o erro SelectorNotFoundException. O valor padrão é de 30.000 milissegundos (30 segundos).
• Target.WaitForReady - Antes de executar as ações, aguarda o destino ficar pronto. As seguintes opções estão disponíveis:
  • Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.
  • Interativo/Completo - Espera que todos os elementos da interface gráfica no aplicativo de destino existam antes de executar, de fato, a ação.Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:
  • Aplicativos de área de trabalho — uma mensagem wm_null é enviada para verificar a existência das tags,<wnd> ,<ctrl> ,<java> ou. <uia>Se existirem, a atividade é executada.
  • Aplicativos web:
  1. Internet Explorer - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”.
  2. Outros - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está Concluído.
  • Aplicativos SAP — primeiro a presença da tag <wnd> é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• FormatoDeExportação - Uma lista suspensa que especifica o formato no qual você deseja que os elementos da interface gráfica sejam exportados. Você pode escolher entre XML e JSON. Por padrão, XML é selecionado.
• CaminhoDeExportação - O caminho no qual deseja que o arquivo que contém a Árvore de Interface Gráfica extraída seja criado. Se este campo for deixado em branco, o arquivo será exportado como um argumento de saída ExportedString.Este campo é compatível apenas com strings e variáveis String.
• Filtro - Um filtro que permite exportar apenas determinados tipos de seletores. A Árvore de Interface Gráfica exportada contém apenas elementos de Interface Gráfica, dependendo dos tipos de seletores especificados neste campo.
• IncluirCapturasDeTela - Se selecionado, salva capturas de tela da Árvore de Interface Gráfica ao lado do arquivo que contém os seletores. Por padrão, essa caixa de seleção está desmarcada.
• TempoLimiteDaOperação (milissegundos) - Especifica o período (em milissegundos) de espera para que a atividade gere o arquivo que contém a Árvore de Interface Gráfica exportada.
• Substituir - Se selecionado, a atividade substitui todos os arquivos existentes no caminho especificado no campo de propriedade CaminhoDeExportação. Por padrão, essa caixa de seleção está desmarcada.
• EstruturaDaUI - Um menu suspenso que especifica a estrutura de interface gráfica usada para detectar elementos de interface gráfica no nível superior. Há três opções possíveis: Default, Active Accessibility e UIAutomation. Por padrão, Default é selecionado. Este campo de propriedade é usado somente ao exportar o conteúdo de toda a área de trabalho.

No corpo da atividade

O corpo da atividade permite configurar vários parâmetros da atividade sem interagir com o painel Propriedades, como:

O botão Indicar na Tela permite selecionar o aplicativo de destino cuja Árvore de Interface Gráfica você deseja exportar.

O menu suspenso Formato de Exportação permite selecionar entre os formatos XML ou JSON que podem ser usados para o arquivo exportado.

O campo Arquivo de Destino permite que você especifique o caminho onde deseja que o arquivo seja salvo ou Navegar até a pasta.

A caixa de seleção Incluir Capturas de Tela especifica se as capturas de tela dos elementos da interface gráfica em si devem ser salvas junto com o arquivo que contém a Árvore da Interface Gráfica ou não. Por padrão, essa caixa de seleção está desmarcada.