Digitar no Campo

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

Visão Geral

O objeto Digitar no Campo permite inserir texto em campos de entrada de uma aplicação Windows durante a execução de uma automação.

Ele localiza o elemento na interface da aplicação utilizando um método de busca configurado e executa a ação definida para inserir o texto informado no campo identificado.

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

---

Funcionamento

O objeto Digitar no Campo localiza um campo de entrada dentro de uma aplicação Windows e executa uma ação de escrita no elemento identificado.

Fluxo de funcionamento:

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

2. O objeto Digitar no Campo 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 campo.

5. Após localizar o elemento, o robô executa a ação configurada para inserir o texto.

Quando usar

• Quando for necessário preencher campos de entrada em aplicações Windows.

• Para inserir dados em inputs, caixas de texto ou campos de formulário em sistemas desktop.

• Quando o elemento pode ser localizado utilizando 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 a ser preenchido não pode ser localizado utilizando os métodos de busca disponíveis.

---

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 da automação.
Selecionar objeto do tipo Automação Windows	Permite selecionar a aplicação Windows onde o campo 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 campo na interface da aplicação.
Buscar apenas um / Buscar uma lista	Define se a busca deve localizar apenas um elemento ou uma lista de elementos.
Tempo máximo de espera (em segundos)	Define o tempo máximo que o robô aguardará até localizar o elemento na interface.
Campo Senha	Indica que o campo corresponde a um campo de senha.
Limpar Conteúdo	Define se o conteúdo existente no campo deve ser removido antes da inserção do novo texto.
Texto	Conteúdo que será inserido no campo identificado.
Ação	Define a ação que será executada no campo.

---

Estrutura de Bloco

O objeto Digitar no Campo atua como um componente de interação com campos de entrada de aplicações Windows.

Ele depende da identificação prévia da aplicação por meio de um objeto de Automação Windows, que define o contexto onde o elemento será localizado.

Após localizar o elemento utilizando o método configurado, o objeto executa a ação definida para inserir o conteúdo informado no campo.

---

Exemplos

Exemplo simples

Um robô precisa preencher um campo de texto em um sistema desktop.

Fluxo:

1. Abrir a aplicação.

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

3. Utilizar Digitar no Campo para localizar o campo de entrada.

4. Inserir o texto configurado no campo.

Exemplo aplicado

Automação de login em um sistema interno.

Fluxo do robô:

1. Abrir o sistema.

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

3. Utilizar Digitar no Campo para localizar o campo Usuário.

4. Inserir o login do usuário.

5. Utilizar Digitar no Campo novamente para preencher o campo Senha.

---

Retornos

---

Erros comuns e como evitar

Elemento não encontrado

Causa: o elemento não foi localizado utilizando o método de busca 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.

Campo não disponível no momento da execução

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

Como evitar:

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

---

Boas práticas

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

• Garantir que o elemento pode ser localizado de forma consistente antes de inserir o texto.

• Utilizar a opção Limpar Conteúdo quando for necessário substituir o valor existente no campo.

• Configurar corretamente o método de busca para evitar falhas na automação.