UI Explorer

UI Explorer é uma ferramenta avançada que permite a criação de um seletor personalizado para um Elemento de Interface gráfica específico. Ele está disponível como uma ferramenta independente que você pode baixar a partir do Centro de Recursos, em sua instância do Automation Cloud ou do Studio somente se o pacote UiPath.UIAutomation.Activities estiver instalado como uma dependência do projeto.

Usar o UI Explorer como uma ferramenta independente não exige que se instale o Studio. Isso é útil quando se deseja garantir que um aplicativo possa ser automatizado com os seletores. Permite que você simplesmente inspecione os elementos sem criar um processo. O pacote independente também contém o utilitário SetupExtensions, o que possibilita instalar extensões de navegador e o JavaBridge para inspecionar elementos de todas as suas necessidades de automação.

Para abrir a janela do Explorador de Interface Gráfica, clique no botão da seção de Seletores, na guia Design ou do editor avançado na tela de seleção de todos os seletores de atributos de destino e âncoras, após indicar o elemento Interface Gráfica de destino.

Observação: se você não tiver o pacote UiPath.UIAutomation.Activities instalado como uma dependência do projeto atual, o botão UI Explorer não aparece na Faixa de opções.

Como alternativa, o UI Explorer pode ser iniciado a partir da página Ferramentas na exibição em segundo plano do Studio. O UI Explorer do menu de contexto usiliza bibliotecas de automação de Interface Gráficas que são entregues com a versão atual do Studio.

Observação: a versão do pacote UI Automation que está sendo usado atualmente é exibida no canto inferior direito no UI Explorer que você abriu. Esta versão varia, uma vez que iniciar o UI Explorer a partir da página Ferramentas utiliza a versão padrão de Automação de Interface Gráfica que vem com a versão do Studio que você estiver usando, ao passo que abrir o UI Explorer a partir da Faixa de Opções usa a versão que estiver instalada como uma dependência do projeto atual.

Para ter certeza de escolher o melhor seletor, lembre-se de:

• Adicionar ou remover atributos
• Adicionar tags parent ou children

• Use caracteres coringas para substituir os valores de mudança

  
  

  

  
  

Descrições do campo na janela do UI Explorer

Campo	Description
Validar	O botão mostra o status do seletor, verificando a validade da definição do seletor e a visibilidade do elemento de destino na tela. O botão Validar possui três estados: O seletor está sendo validado Seletor válido Seletor inválido Seletor alterado, revalidar
Indicar Elemento	Indica um novo elemento de Interface Gráfica para substituir o anterior.
Indicar Âncora	Permite que você escolha uma âncora em relação ao elemento da Interface Gráfica de destino.
Reparar	Permite que você indique novamente o mesmo elemento de interface gráfica de destino e repare o seletor. Essa operação não substitui completamente o seletor anterior. O botão fica disponível apenas quando o seletor for inválido.
Highlight	Traz o elemento de destino para o primeiro plano. O realce permanecerá até que seja desligado. O botão será habilitado apenas se o seletor for válido.
Opções	Possui várias opções: UI Frameworks - Muda a tecnologia usada para determinar elementos de interface gráfica e respectivos seletores. As seguintes opções estão disponíveis: Padrão - Método proprietário da UiPath. Geralmente funciona bem com todos os tipos de interfaces do usuário. Primeiro, tente gerar um seletor usando as extensões ou conectores UiPath apropriados (por exemplo, navegador/remoto/extensão Java, conector SAP, etc.). Se isso não for possível, tente gerar um seletor usando Acessibilidade Ativa (preferido para a maioria dos aplicativos de área de trabalho) ou Automação de interface gráfica (preferido para aplicativos do Office). Acessibilidade Ativa – uma solução anterior da Microsoft para tornar os aplicativos acessíveis. É recomendável utilizar essa opção com software legado, quando o Padrão não funcionar. Tente gerar um seletor usando Acessibilidade Ativa e ignorar extensões ou conectores UiPath. Para descobrir se um seletor usa a tecnologia de Acessibilidade Ativa, você precisa procurar tags ctrl. Especificamente, a substring <ctrl. No XAML, você pode encontrá-la codificada como &lt;ctrl. Automação de Interface Gráfica – modelo de acessibilidade aprimorado da Microsoft. É recomendável usar essa opção com aplicativos mais recentes, quando o Padrão não funcionar. Tente gerar um seletor usando Automação de interface gráfica e ignorar extensões ou conectores UiPath. Observação: atualmente, essa estrutura não suporta páginas da Web Chrome ou Edge e, em vez disso, gera seletores wnd, em vez de recair na extensão. Clique aqui para ler mais sobre Active Accessibility e Automação de Interface Gráfica. Restauração atrasada - Atrase a restauração da janela do UI Explorer até que os dados do seletor sejam carregados. Use essa opção para indicar elementos de interface gráfica que fecham automaticamente quando o foco é perdido, como listas suspensas ou sobreposições. Seletor de acionador — garante a exclusividade de um elemento de interface gráfica dentro do elemento pai e aumenta a precisão de monitoramento. Use esta opção ao gerar seletores para atividades de disparo.

O Painel de Árvore Visual

Exibe uma árvore da hierarquia da Interface Gráfica, permitindo navegar por ela ao se clicar nas setas diante de cada nó.

Por padrão, a primeira vez que você abre o UI Explorer, esse painel exibe todos os aplicativos abertos em ordem alfabética.

Clicar duas vezes em um elemento de Interface Gráfica (ou clicar com o botão direito do mouse e selecionar Definir como elemento de destino) a partir da árvore preencherá os painéis Edição do Seletor, Atributos do Seletor e Explorador de Propriedade.

Campo	Description
Highlight	Realça o elemento selecionado da Árvore Visual em tempo real. O realce permanece ligado, até que seja desligado.
Mostrar Opções de Pesquisa	Exibe a caixa de pesquisa e as opções de filtro de pesquisa.
Caixa de pesquisa	Permite que você procure uma string específica. Se uma correspondência exata não for encontrada, os nós que contêm a correspondência mais próxima serão exibidos. Caracteres coringa são compatíveis. Dependendo do atributo selecionado na lista suspensa Pesquisar por, a pesquisa pode diferenciar entre maiúsculas e minúsculas. Observação: a pesquisa somente procura correspondências na estrutura da árvore sob o objeto de Interface Gráfica selecionado.
Pesquisar por	Filtra sua pesquisa para um atributo ou um seletor selecionado. O conteúdo dessa lista suspensa muda de acordo com o elemento de Interface Gráfica selecionado. Observação: se a opção Pesquisar por estiver definida como Seletor, você somente poderá inserir um nó no formato <attribute name1='value1' ... />.
Aomente Children	Limite sua busca ao primeiro nível de children do nó selecionado. Por padrão, essa caixa de seleção fica desmarcada.

O Painel de Edição do Seletor

Exibe o seletor em relação a um objeto de Interface Gráfica especificado, permitindo sua personalização.

A parte inferior do painel exibe o fragmento de XML real que você tem que usar em um projeto. Assim que encontrar o seletor desejado, poderá copiá-lo daqui e colá-lo no painel Propriedades de uma atividade, no campo Seletor.

A parte superior desse painel permite visualizar todos os nós em um seletor, bem como eliminar os que não forem necessários, desmarcando-se a caixa de seleção diante deles. Um elemento na lista de nós do seletor se torna ativa quando você habilitar ou desabilitar um atributo ou ao editar um seletor no painel inferior. Somente um nó fica ativo a cada vez.

Selecionar um nó aqui, exibirá seus atributos nos painéis Atributos do Seletor e Explorador de Propriedade.

Com a ajuda das variáveis, também é possível editar os seletores, seja usando o CTRL+K atalho para criar uma variável no seletor, propriamente dito ou especificando uma variável já criada com a combinação de CTRL+Space. Usar a tecla de atalho CTRL+K permite que você especifique um valor e um nome para a variável. Observe que somente as variáveis string podem ser usadas.

O Painel de Atributos do Seletor

Exibe todos os atributos disponíveis de um nó selecionado (a partir do painel Edição do Seletor).

É possível adicionar ou eliminar alguns dos atributos do nó, selecionando ou desmarcando a caixa de seleção diante de cada atributo.

Além disso, é possível alterar o valor de cada atributo, embora essa alteração será mantida somente se o novo seletor apontar para o objeto da Interface Gráfica originalmente selecionado.

O Painel Explorador de Propriedade

Exibe todos os atributos que um objeto de Interface Gráfica especificado possa ter, inclusive os que não apareçam no seletor. Eles não podem ser alterados.