# Configuração de Seletores Para que um robô de software imite ações específicas na interface do usuário (sistema operacional, programas, páginas da web), é necessário interagir com várias janelas, botões, listas suspensas, hyperlinks e assim por diante. Nas ações com formulários na tela, o Sherpa RPA realiza a busca (permutação) da posição dos elementos na tela. A escolha do elemento correto na tela é uma tarefa complexa, pois a busca pode ser feita entre milhares de elementos presentes na tela. Com bastante frequência, os identificadores dos elementos de controle, pelos quais podem ser encontrados na tela (nomes, rótulos, propriedades do sistema e descritores) estão sujeitos a mudanças dinâmicas; por exemplo, o título da página da web pode mudar durante o processo de automação. Para resolver esse problema, o Designer utiliza os chamados "Seletores". Seletores armazenam os atributos do elemento da interface gráfica do usuário na forma de um conjunto de instruções em formato XML, que orientam o robô sobre como encontrar determinado elemento de controle na tela. Na maioria dos casos, os seletores são gerados automaticamente pelo Designer durante a gravação das ações do usuário e não requerem entrada adicional do usuário, especialmente se os aplicativos a serem automatizados tiverem uma interface de usuário estática.

**Selector** – uma dica, um guia de ação para o robô sobre como encontrar na tela determinado elemento de controle. O robô grava esses seletores automaticamente ao registrar qualquer ação. No entanto, em alguns programas, são utilizados layouts mutáveis e atributos com valores variáveis, como em aplicativos da web. O Designer não pode prever essas mudanças, portanto, alguns seletores podem precisar ser criados ou editados manualmente.

## **Janela "Editar Seletor"** A janela "Editar Seletor" é chamada a partir do painel de propriedades do seletor à direita (apenas para aqueles blocos que possuem seletores) clicando no botão com reticências. Todos os blocos relacionados a elementos gráficos possuem essa propriedade. O seletor está disponível tanto quando os Blocos são adicionados ao Projeto usando a ferramenta "Gravação", quanto em blocos prontos para operações com formulários na tela (UI Automation) da paleta. A janela "Editar Seletor" permite visualizar o seletor gerado automaticamente e modificar o próprio seletor e seus atributos. Você pode incluir ou excluir determinados atributos ou adicionar curingas a valores que mudam dinamicamente. Ao clicar no botão com reticências à direita do campo "Seletor", a janela de edição do seletor aparecerá.


№ p/p	Elemento da Interface	Descrição
1.	botão “Conversor de seletores UiPath…”	Permite abrir a janela para inserir texto do campo Selector da atividade UIPath.
1.1.	botão	Permite abrir a opção de alternar o modo de operação do UIPath.
3.	botão “Adicionar nova linha”	Permite adicionar uma nova linha.
4.	botão “Remover linha”	Permite remover a linha selecionada.
5.	botão “Colar da área de transferência”	Permite colar informações da área de transferência.
6.	botão “Abrir Sherpa Explorer”	Permite abrir o Sherpa Explorer.
7.	botão “Inserir modificador”	Permite inserir um modificador que pode ser selecionado a partir de uma lista suspensa. Opções possíveis: ? (um qualquer símbolo); * (vários quaisquer símbolos); xpath: (processamento XPath); regex: (processamento Regex).
8.	botão “Inserir variável”	Permite inserir uma variável dentre as definidas no diagrama, que pode ser selecionada através de uma lista suspensa.
9.	botão “Gravar”	Permite iniciar o procedimento de gravação do seletor.
10.	botão “Verificar”	Permite verificar o posicionamento do elemento definido no seletor.
11.	botão “Destacar”	Permite “destacar” (indicar) o último elemento do seletor.
11.1.	botão	Permite destacar o caminho (ou seja, cada linha do seletor). Este botão permite ver como a busca do seletor ocorre na interface da janela.
12.	botão “Remover seletor”	Permite remover o seletor.

Nesta janela, você pode ver como o seletor se parece, verificar e corrigir se necessário, além de enriquecer o seletor com ferramentas auxiliares, como a inserção de curingas e a inserção de valores de variáveis. Também é possível remover linhas desnecessárias ou limpar valores indesejados nas células. Assim, o seletor é uma tabela composta por colunas e linhas, onde cada linha é um comando, um passo que o robô deve executar. Os comandos são lidos de cima para baixo. A linha superior é executada primeiro, a inferior é executada por último. O robô segue os passos de cima para baixo e executa cada linha como um comando. Ele procura na tela um elemento cujas propriedades sejam simultaneamente iguais às especificadas nas colunas da linha do seletor. Por exemplo, consideremos a primeira linha do seletor, onde: * Tipo – processo. Ou seja, esta linha busca o aplicativo necessário para iniciar. * O nome do processo aqui é – Calculator, escrito como aparece no gerenciador de tarefas.

Assim, na primeira etapa, o robô encontrará o processo chamado Calculator entre os processos em execução na memória do computador. A próxima linha é identificada como UIElement, que já é uma janela ou um elemento de controle específico desse seletor. Para encontrar o elemento de controle necessário, o robô buscará simultaneamente um elemento com o nome Calculator, o nome da classe e o elemento de controle Window, daí fica claro que se trata de uma janela. Esta linha permite encontrar a janela específica da calculadora. Descendo para a linha abaixo. Agora, na janela encontrada, é necessário encontrar sequencialmente todos os contêineres que levarão ao botão desejado. Existem três contêineres aqui. Esses contêineres podem não ser visualmente exibidos no aplicativo, pois foram criados para desenvolvedores. No entanto, pelo nome "Painel Numérico", pode-se deduzir que é um contêiner que contém todos os botões da calculadora. E então vemos que o último elemento é o número 6, no qual o usuário clicou. O botão "**Verificar**" verifica o posicionamento do elemento definido no seletor, ou seja, como resultado da Verificação, podem ser apresentados dois estados: * Erro na verificação

\* A verificação foi bem-sucedida, o elemento com a posição especificada no Seletor foi encontrado na tela.

O botão "**Destacar**" — indica o elemento da interface do usuário, destacando o próprio elemento e os elementos de nível superior no caminho até ele com bordas vermelhas. O destaque desaparece automaticamente após alguns segundos. O botão "**Gravar**" – inicia o procedimento de gravação do Seletor clicando no elemento de controle desejado na tela. Acesse o Seletor e clique em "Gravar". A janela **SherpaDesigner** (com a janela "Editar seletor" aberta) será minimizada. No topo da tela, aparecerá uma dica para trabalhar no modo Gravação. Escolha a ação necessária para o seu processo de negócios, ou seja, o elemento desejado na tela e clique nele. Observe que os elementos devem ser destacados antes do clique (ou seja, uma borda vermelha deve aparecer).

Se o destaque não aparecer automaticamente ou desaparecer, para destacar o elemento desejado, é necessário pressionar a tecla Shift no teclado. O destaque é necessário para selecionar com precisão o elemento sob o mouse. Opções de gravação do clique: * clicar com o botão esquerdo do mouse; * pressionar Ctrl esquerdo, que emula o clique com o botão esquerdo do mouse; * pressionar Ctrl direito, que emula o clique com o botão direito do mouse, ou seja, em muitos aplicativos, chama o menu de contexto; * a emulação da pausa do cursor do mouse sobre o elemento é gravada com a tecla Shift. **Nota:** *da janela “Editar seletor” é gravada apenas uma ação (clique, inserção, pausa sobre o botão etc.), ao contrário do uso da ferramenta de gravação através do menu principal, onde você pode gravar várias ações de uma vez. Ou seja, após realizar a ação (clique), o usuário retorna automaticamente à janela “Editar seletor”.* Após retornar à janela de edição do Seletor, recomendamos usar os botões "Destacar" ou "Verificar" para verificar se o elemento foi selecionado corretamente. Se o elemento foi selecionado incorretamente, você pode tentar novamente pressionando o botão Gravar ou encontrar e corrigir o erro nas linhas do Seletor manualmente. ## **Configuração do seletor**

Cada linha do seletor possui um ou mais atributos que ajudam a identificar corretamente a localização exata da área selecionada na tela. Os atributos mostram em qual programa a gravação está ocorrendo, em qual janela e elemento, bem como o nível específico do elemento selecionado, utilizando atributos como Type, Name, ClassName, ControlType, Index, Id, Text. Cada atributo pode ter um valor atribuído, pelo qual a busca será realizada. É importante escolher atributos com valores constantes. Se o valor do atributo mudar a cada execução do aplicativo, o seletor não conseguirá identificar corretamente o elemento. Nesse caso, recomendamos não usar esse atributo (deixar seu valor vazio).


Nº	Atributo	Descrição do atributo
1.	Type	Tipo de elemento.
2.	Name	Nome do elemento.
3.	ClassName	Nome da classe do elemento.
4.	ControlType	Tipo de elemento de controle (por exemplo, botão, campo de texto etc.).
5.	Id	Identificador do elemento (geralmente único para cada elemento).
6.	Index	Índice do elemento na lista de elementos correspondentes.
7.	Text	Texto dentro do elemento.

Além disso, em casos complexos, você pode usar caracteres curinga ou substituição do valor do atributo ou parte do atributo a partir de uma variável: * Asterisco (\*) substitui qualquer número de caracteres no valor do atributo; * Interrogação (?) substitui um único caractere no valor do atributo; * $NomeDaVariável – o uso do nome da variável que começa com o símbolo $, permite inserir o valor dessa variável em vez do valor do atributo ou parte dele. ## Vídeo demonstrativo de trabalho com seletores * Gravação de seletores: elementos sobrepostos ou invisíveis usando a janela de login do Chrome {% embed url="" %} * Trabalho com seletores da janela "Downloads" do Chrome {% embed url="" %} * Gravação de seletores da janela pop-up no Internet Explorer {% embed url="" %} * Conversão de seletores UIPath > Sherpa RPA na janela "Editar seletor" {% embed url="" %} * Funcionamento da função "Destacar caminho" na janela "Editar seletor" {% embed url="" %} Um guia completo sobre o trabalho com seletores da web pode ser encontrado [aqui](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/rukovodstvo-po-veb-selektoram). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/paneli-svoistv-i-peremennykh-i-rabota-s-nimi/panel-svoistv/nastroika-selektorov.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.