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

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - o nome de exibição da atividade.

Entrada

• Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele suporta números positivos e negativos.
• Target.Element - Use a variável UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
• Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando e de alguns de seus pais.
• Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro SelectorNotFoundException seja lançado. O valor padrão é 30000 milissegundos (30 segundos).

• Target.WaitForReady - Antes de executar as ações, aguarde 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 do usuário no aplicativo de destino existam antes de executar 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.