Buscar Elementos

Visão Geral

O objeto Buscar Elementos é usado em automações WEB para localizar elementos na página aberta (como campos, botões, textos etc.), com base em critérios de busca como XPath, Id, Nome, Classe ou Seletor CSS. Ele também pode executar ações nesse elemento encontrado, como clicar ou digitar texto.

---

Funcionamento

O objeto localiza um ou mais elementos da página de acordo com a forma de busca e o valor de busca configurado. Após localizar, dependendo das configurações, ele pode:

• Retornar o valor de texto de um elemento (através de variável).

• Executar ações como Clicar ou Digitar em um elemento único.

A busca fica disponível durante um tempo máximo de espera definido, e a execução pode ser interrompida caso a busca não tenha sucesso.

Quando usar

• Quando for necessário localizar e interagir com elementos WEB, como campos de formulário, botões, links ou textos.

• Para extrair o conteúdo textual de um elemento e usar em outras partes do robô.

Quando não usar

• Não é recomendado quando você já souber que não há interação com elemento.

---

Configuração

Configuração

CAMPO	DESCRITIVO
Título	Nome identificador do objeto dentro do projeto.
Nome Identificador do Objeto	Identificador único utilizado internamente, sem espaços ou caracteres especiais.
Automação Web	Seleciona qual instância de navegador/web será usada.
Tempo de espera antes de iniciar (ms)	Adiciona delay antes do início da busca.
Tempo de espera após finalizar (ms)	Delay após a execução do objeto.
Buscar apenas um / Buscar uma lista	Escolhe entre localizar um elemento ou uma lista de elementos.
Forma de busca	Método de localização (XPath, Id, Nome, Classe, Seleto CSS, etc.).
Valor de Busca	Valor de referência da busca (ex: expressão XPath).
Variável do texto	Variável que recebe o valor textual encontrado (opcional).
Tempo máximo de espera (segundos)	Define quanto tempo o objeto tentará localizar antes de cancelar.
Parar execução caso algo der errado	Se habilitado, interrompe o robô em caso de erro na busca.
Tipo da ação	Tipo de ação a ser realizada após encontrar o elemento (Nenhuma/Clicar/Digitar).
Texto	Texto a ser digitado no elemento quando a ação é Digitar.
Campo Senha	Oculta o texto digitado (quando aplicável).
Limpar Campo	Limpa o campo antes de digitar (quando aplicável). (visível no print)

Forma de Busca

Ações no elemento

---

Retorno

---

Exemplo

Abrir Navegador na página do Google e com a Ação no Objeto digitar Roboteasy e dar Enter para completar a pesquisa.

PASSO 1: Configurar Abrir Navegador.

PASSO 2: Configurar Buscar Elemento com o XPATH correto e fazer a Ação de digitar.

PASSO 3: Configurar Ação em Elementos para ele completar a execução com a ação ENTER.

PASSO 4: Executar o robô e verificar as ações.

---

Erros comuns e como evitar

• Xpath incorreto ou inválido: Certifique-se de extrair corretamente o XPath do elemento DOM.

• Selecionar lista quando há apenas um elemento: Pode impactar performance se não for necessário.

• Não configurar tempo de espera suficiente em páginas com carregamento lento: Aumente o tempo máximo de espera.

---

Boas práticas

• Utilize XPath ou Seletores CSS robustos para reduzir falhas por mudanças na interface.

---

Robô Exemplo

13KB

Buscar Elemento - Robô Exemplo.roboteasy

Open