Clicar em Elemento

Permite clicar em um campo específico nos Objetos encontrados em programas Windows

Visão Geral

O objeto Clicar em Elemento permite executar um clique do mouse em um elemento de uma aplicação Windows durante a execução de uma automação.

Ele identifica o elemento na interface da aplicação utilizando um método de busca configurado e executa o tipo de clique definido no componente localizado.

Esse objeto depende de uma Automação Windows previamente configurada, que define a aplicação onde o elemento será localizado.

---

Funcionamento

O objeto Clicar em Elemento localiza um componente dentro da aplicação e executa uma ação de clique sobre ele.

Fluxo de funcionamento:

1. A aplicação é identificada por um objeto de Automação Windows.

2. O objeto Clicar em Elemento recebe essa referência da aplicação.

3. O elemento é localizado utilizando o método configurado em Forma de Busca.

4. O robô aguarda até o tempo máximo de espera configurado para localizar o elemento.

5. Após localizar o elemento, o robô executa o tipo de clique configurado.

Quando usar

• Quando for necessário executar um clique em um elemento de uma aplicação Windows.

• Para interagir com botões, links ou componentes clicáveis em sistemas desktop.

• Quando o elemento pode ser identificado por um método de busca configurado na automação.

Quando não usar

• Quando a automação não envolve aplicações Windows.

• Quando o elemento não pode ser localizado utilizando um método de busca suportado.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo da automação. Utilizado para facilitar a identificação da etapa no robô.
Nome Identificador do Objeto	Identificador único que representa a execução da ação dentro do fluxo.
Selecionar objeto do tipo Automação Windows	Permite selecionar a aplicação Windows onde o elemento será localizado.
Forma de Busca	Define o método utilizado para localizar o elemento na interface da aplicação.
XPath	Caminho utilizado para identificar o elemento na interface da aplicação.
Tempo máximo de espera (em segundos)	Define o tempo máximo que o robô aguardará até localizar o elemento.
Tipo de clique do mouse	Define o tipo de clique que será executado no elemento localizado.
Invocar	Executa o clique diretamente no elemento identificado.
Clique Global	Executa o clique considerando a posição global do elemento na tela.

---

Exemplos

Exemplo simples

Um robô precisa clicar em um botão dentro de um sistema desktop.

Fluxo:

1. Abrir a aplicação.

2. Identificar a aplicação utilizando Automação Windows.

3. Utilizar Clicar em Elemento para localizar o botão.

4. Executar o clique no componente.

Exemplo aplicado

Automação de navegação em um sistema interno.

Fluxo do robô:

1. Abrir o sistema.

2. Identificar a aplicação com Automação Windows.

3. Utilizar Clicar em Elemento para localizar o botão Pesquisar.

4. Executar o clique para iniciar a busca de registros.

---

Retornos

---

Erros comuns e como evitar

Elemento não encontrado

Causa: o elemento não foi localizado utilizando o método configurado.

Como evitar:

• Verificar se o XPath está correto.

Aplicação não configurada

Causa: o objeto de Automação Windows não foi definido.

Como evitar:

• Garantir que a aplicação foi identificada antes da execução deste objeto.

Tempo de espera insuficiente

Causa: o elemento ainda não foi carregado na interface.

Como evitar:

• Ajustar o Tempo máximo de espera (em segundos).

---

Boas práticas

• Utilizar nomes descritivos no campo Título para facilitar a manutenção da automação.

• Garantir que o elemento pode ser localizado com segurança antes de executar o clique.

• Configurar corretamente o método de busca utilizado para identificar o elemento.

• Definir um tempo de espera adequado para evitar falhas na automação.