Ação em Elementos

Permite ações isoladas nos elementos encontrados na página da internet

Visão Geral

O objeto Ação em Elementos permite executar ações isoladas nos elementos encontrados em uma página da internet por meio de uma automação WEB previamente configurada. Ele é útil para interagir com elementos mapeados por outro objeto como Buscar Elementos.

---

Funcionamento

Este objeto usa um elemento previamente encontrado e executa uma ação definida, como clicar, digitar ou enviar teclas de atalho, permitindo manipular elementos de páginas web de forma programática em um fluxo de automação.

Passos gerais de funcionamento:

1. O objeto Automação Web (como Abrir Navegador) é utilizado como contexto da automação.

2. O objeto Buscar Elementos deve ter sido utilizado antes para localizar o elemento desejado.

3. O elemento Web é selecionado neste objeto.

4. Opcionalmente são configurados tempos de espera antes e/ou depois da execução.

5. A ação escolhida é executada no elemento selecionado.

Quando usar

• Para clicar, digitar ou enviar teclas em um elemento específico da página web.

• Quando for necessário acionar elementos não diretamente acessíveis por simples cliques, como envio de ENTER em campo de texto.

Quando não usar

• Quando não houver um elemento retornado por um objeto de busca anterior.

• Quando a ação desejada não envolve interação com elementos da página web.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome que identifica o objeto no fluxo de automação.
Automação Web	Automação web que será utilizada como contexto (ex.: browseOpen1).
Elemento Web	Elemento retornado pelo objeto de busca (Buscar Elementos).
Tempo de espera antes de iniciar (em milissegundos)	Tempo de espera antes de iniciar a ação, quando habilitado.
Tempo de espera após finalizar (em milissegundos)	Tempo de espera após concluir a ação, quando habilitado.
Index do componente	Índice do elemento entre múltiplos retornados (quando houver mais de um).
Ação	A ação que será executada no elemento (ex.: Clicar, Digitar, etc.).
Clicar com Direito	Quando habilitado, executa a ação de clique com o botão direito do mouse.

---

Pré-requisitos

Para utilizar este objeto corretamente é necessário ter:

• Um objeto do tipo Abrir Navegador configurado como automação web.

• Um objeto do tipo Buscar Elementos que localize o elemento a ser manipulado.

---

Exemplos

Exemplo simples

Abrir um navegador, localizar um campo de pesquisa e clicar no botão de enviar.

1. Abrir Navegador

2. Buscar Elementos para localizar o campo de entrada e o botão correspondente.

3. Ação em Elementos configurado para clicar no botão.

---

Exemplo aplicado

Realizar uma busca de CEP em um site dos Correios:

1. Abrir o navegador no site dos Correios.

2. Buscar o elemento que representa o campo de CEP.

3. Digitar o CEP no elemento encontrado.

4. Buscar o botão de pesquisa.

5. Usar Ação em Elementos para enviar ENTER ou clicar no botão.

---

Erros Comuns e Como Evitar

• Elemento não encontrado: verifique se o objeto Buscar Elementos anterior retornou corretamente o elemento.

• Ação falhando: confira se a automação web foi iniciada antes da ação.

• Tempos de espera insuficientes: ajustar valores de espera pode ser necessário em páginas lentas.

---

Boas Práticas

• Sempre validar a existência do elemento antes de chamar este objeto.

• Usar o Index do componente quando há múltiplos elementos similares.

• Habilitar tempos de espera apenas se necessário para performance.

---

Robô Exemplo

13KB

Ação em Elementos - Robô Exemplo.roboteasy

Open