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.
Inspecionar Eventos	Abre a Ferramenta de inspeção de eventos.
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: Default – UiPath® proprietary method. Usually works fine with all types of user interfaces. 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.

Ferramenta de Inspeção de Eventos

No contexto da automação attended baseada em gatilhos, a Ferramenta de inspeção de eventos pode ser usada para identificar os tipos de eventos nativos disparados quando você interage com determinados elementos de interface gráfica em um aplicativo e, em seguida, pode ser usada para configurar a atividade Application Event Trigger. A ferramenta captura e monitora todos os tipos de eventos selecionados, como Clique, Tecla pressionada, Foco ganho, Foco perdido e outras interações relevantes, permitindo analisar as ações realizadas e, se aplicável, diagnosticar problemas.

A Ferramenta de inspeção de eventos pode ser aberta a partir do UI Explorer, depois que um elemento de interface gráfica válido for selecionado, clicando no botão Inspecionar eventos.

A barra de ferramentas consiste nas seguintes opções:

• Registro - Os eventos gerados pela interação com o elemento de interface gráfica são registrados e adicionados à lista de eventos.
• Pausa - Os eventos gerados pelo elemento de interface gráfica quando você interage com ele não são mais registrados.
• Realçar — Mostra o contorno do elemento de destino e o coloca em primeiro plano por alguns segundos. O destaque permanece até que seja desabilitado.
• Abrir no UI Explorer — O elemento monitorado é aberto no UI Explorer, permitindo observar o seletor desse elemento.

Depois de iniciar o registro de eventos, mais duas opções ficam disponíveis:

• Limpar - Exclui todos os eventos registrados.
• CSV - Os eventos capturados podem ser exportados para um arquivo .csv para uma análise posterior.

A janela Ferramenta de inspeção de eventos apresenta duas seções principais:

• Filtro de eventos — Permite selecionar os tipos de eventos que você deseja monitorar para o elemento de destino.
• Lista de eventos — Exibe informações sobre eventos capturados.

Você pode filtrar os tipos de eventos para serem capturados habilitando ou desabilitando as caixas de seleção na lista de tipos de eventos. A lista pode variar com base na tecnologia do elemento selecionado.

Todos os tipos de eventos de mouse (Movimento do mouse, mouse pressionado, mouse liberado, mouse inserido, mouse retirado), específicos para elementos de interface gráfica Web ou Java, são desabilitados por padrão porque a lista de eventos, nesses casos, pode se tornar muito grande. Nossa recomendação é habilitar os tipos de eventos de mouse apenas se você tiver uma necessidade específica de monitorá-los.

Vale ressaltar também que os tipos de eventos podem ser habilitados ou desabilitados mesmo após o início da gravação do evento.

A lista de eventos possui três colunas:

• Nome do evento - O tipo de evento.
• Carimbo de tempo - A data e a hora em que o evento foi realizado.
• Dados do evento - Os dados e parâmetros associados a um determinado evento.

Cada coluna pode ser classificada em ordem crescente ou descendente. Os eventos são exibidos por padrão na ordem em que foram realizados.

Quando o tipo de evento Desaparecido for encontrado, não será mais possível continuar o monitoramento e uma mensagem de erro será exibida na tela. Ao clicar em qualquer opção da barra de ferramentas, a mesma mensagem de erro é exibida na tela. As únicas opções disponíveis são limpar os dados ou exportá-los para um arquivo .csv. Para iniciar o monitoramento novamente, feche a janela e abra outra instância da Ferramenta de inspeção de eventos.