UiPath Documentation
activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Atividades do UIAutomation

Última atualização 16 de abr de 2026

Ajudante de seleção

As atividades de Automação de Interface Gráfica permitem trabalhar com elementos de interface gráfica que simulam a interação humana. Para fazer isso, é possível identificar os elementos da IU indicando-os em sua tela. Normalmente, um par de elementos é indicado para essa finalidade: um destino e uma âncora. Esse par é conhecido como um descritor.

Ao indicar, o Auxiliar de Seleção é usado para ajudar a realizar tarefas mais avançadas, como pausar a execução, alterar a estrutura que está sendo usada para detecção de elementos de IU, selecionar uma âncora ou editar o seletor que você está usando, para citar alguns .

Para obter mais informações, confira o vídeo Uso da tela de seleção .

Como indicar um elemento

Para indicar um elemento de interface gráfica, você deve primeiro arrastar e soltar uma atividade Use Application/Browser no Workflow Designer no Studio e, em seguida, indicar o aplicativo ou o navegador que você deseja automatizar.

docs image

Depois que o aplicativo ou o navegador for indicado, você pode arrastar qualquer atividade Modern UI Automation dentro da atividade Use Application/Browser e escolher Indicar aplicativo para automatizar no cartão de aplicativo para selecionar um aplicativo ou um navegador.

Em seguida, clique no elemento de interface gráfica com o qual você quer interagir. O elemento fica realçado em verde.

docs image

Ajudante de Opções de Seleção

Neste estágio do auxiliar Opções de seleção , você pode usar certas funcionalidades, da seguinte forma:

  • Pausar seleção - Você pode pausar a configuração por um período especificado de tempo ou pausar a configuração sem tempo limite e retomá-la quando quiser. No menu suspenso, você pode escolher uma destas opções:

    • 1 segundo
    • 3 segundos
    • 5 segundos - Este é o valor padrão.
    • 7 segundos
    • 9 segundos
    • Sem limite de tempo - A configuração é pausada até que Retomar seja selecionado.Essa opção interrompe o processo de indicação e permite que você interaja com sua máquina da maneira que quiser, sendo especialmente útil se o aplicativo estiver minimizado, fora da visualização ou por outros motivos, como trazer o aplicativo no estado correto. Você pode usar F2 como uma tecla de atalho.
    Observação:

    You can scroll in applications that are scrollable without having to pause the Selection Screen.

  • Seleção de itens focalizáveis — você pode indicar itens que só ficam visíveis ao passar o mouse sobre eles. Você pode usar F6 como uma tecla de atalho.

  • Seleção de região de imagem - Você pode mudar da indicação direta do elemento que você deseja usar para a seleção de uma área de forma livre que contém o elemento de destino e que é posteriormente processada por meio de reconhecimento de imagem. Você também pode arrastar uma seleção na tela para indicar uma área que você deseja usar como seu destino. Fazer isso desabilita os métodos de pesquisa Seletor restrito e Seletor difuso . Você pode usar F3 como uma tecla de atalho.

  • Habilitar texto nativo — você pode identificar todos os rótulos de texto no aplicativo de destino que podem ser visualizados por meio do método Nativo. Ao clicar no botão Mostrar todos os elementos nativos , os rótulos de texto são destacados no aplicativo de destino.

    docs image

  • Habilitar a Computer Vision - Você pode habilitar a Computer Vision para automatizar certas áreas ou elementos, especialmente quando os seletores não estiverem disponíveis, por exemplo, ao automatizar em uma área de trabalho remota. Você pode usar F8 como uma tecla de atalho. Ao clicar no botão Mostrar todos os elementos de CV , todos os elementos encontrados pelo Computer Vision são destacados no aplicativo de destino.

    docs image

  • Alterar estrutura da interface gráfica — você pode alterar a tecnologia usada para determinar os elementos da interface gráfica e seus seletores. Você pode usar o menu suspenso ou a tecla de atalho F4 . Os tipos de estrutura disponíveis para projetos do Windows são:

    • Auto - Escolhe automaticamente a estrutura que é considerada mais adequada para o elemento indicado. Esta opção é selecionada por padrão. Geralmente funcionam bem com todos os tipos de interfaces do usuário.
    • Active Accessibility - Usa a estrutura Active Accessibility, que é específica do Windows. É recomendável usar essa opção com software legado quando a opção padrão não funcionar.
    • Automação de Interface Gráfica - Usa a estrutura proprietária da UiPath. É recomendável usar essa opção com aplicativos mais recentes quando a opção padrão não funcionar. As estruturas de Interface Gráfica disponíveis para o macOS são:
    • Padrão - escolhe automaticamente a estrutura mais adequada para o elemento indicado, priorizando esta ordem: Sap, Java, Ax.
    • Java — prioriza tecnologias como essa Java, Ax.
  • padrão que prioriza nesta ordem: Sap, Java, Ax. E temos um Java que prioriza tecnologias como esta Java, Ax.

  • Validar - Validar a seleção que você fez. Mais detalhes no capítulo Validação do descritor abaixo.

  • Confirmar - Confirme as alterações e feche o assistente de seleção.

  • Cancelar - Descartar todas as alterações e fechar o assistente de seleção.

Após um destino ser selecionado, isso abre a próxima etapa da janela Opções de Seleção, que permite configurar o descritor para o elemento indicado, adicionando uma âncora e definindo configurações mais avançadas.

Observação:

Ao usar o StudioX, as Configurações nesta tela não são exibidas por padrão. Para editá-los, você deve usar o docs image enquanto passa o mouse sobre o destino ou a âncora.

docs image

Depois de terminar de configurar as Opções de seleção, para retornar ao UiPath Studio e manter todas as alterações feitas, você pode selecionar Confirmar, pressionar Enter ou selecionar a marca de verificação azul no menu de suspensão.

O processo inteiro se parece com isto: docs image

Você pode ler mais sobre os recursos avançados da Tela de Seleção na página Configuração do descritor avançada .

Restrições conhecidas

No Studio Web, o Auxiliar de seleção não pode ser exibido em páginas do navegador sem corpo.

Ao tentar indicar um elemento de interface gráfica em uma página de navegador que usa um <frameset> ao invés de <body>, o Auxiliar de seleção de automação de interface gráfica não é iniciado.

Como o elemento <frameset> está obsoleto nos padrões HTML modernos, ele não é compatível com o Studio Web.

Exemplo: no site https://www.1link.co.uk, o Auxiliar de seleção não abre ao automatizar a partir do Studio Web.

docs image

Solução alternativa: abra o projeto no Studio Desktop e execute a automação de lá.

docs image

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades