Encontrar Campo
Permite a busca de elementos de programas Windows
Visão Geral
O objeto Encontrar Campo é utilizado para localizar elementos dentro de uma aplicação Windows durante a execução de uma automação.
Ele permite identificar componentes da interface utilizando critérios de busca configurados, como XPath, e criar uma referência para esse elemento dentro do fluxo da automação.
Após localizar o elemento, ele pode ser utilizado por outros objetos para executar ações ou capturar informações na interface da aplicação.
Funcionamento
O objeto Encontrar Campo realiza a busca de um elemento dentro de uma aplicação Windows utilizando critérios definidos na configuração.
Fluxo de funcionamento:
A aplicação é identificada previamente por um objeto de Automação Windows.
O objeto Encontrar Campo recebe essa referência da aplicação.
Um método de busca é configurado na seção Condições.
O robô executa a busca utilizando os critérios definidos.
Após localizar o elemento, o objeto cria um identificador que poderá ser utilizado por outras etapas da automação.
Quando usar
Quando for necessário localizar elementos dentro de uma aplicação Windows.
Para criar uma referência de um componente da interface que será utilizado posteriormente no fluxo.
Em automações que precisam interagir com elementos específicos da interface.
Quando não usar
Quando a automação não envolve aplicações Windows.
Quando o elemento 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 representará o elemento localizado na automação.
Selecionar objeto do tipo Automação Windows
Permite selecionar a aplicação Windows onde o elemento será localizado.
Declarar variável
Permite declarar uma variável associada ao elemento encontrado.
Adicionar tempo de espera para o início da execução
Permite configurar um tempo de espera antes do início da busca do elemento.
Forma de Busca
Define o método utilizado para localizar o elemento dentro da aplicação.
XPath
Caminho utilizado para identificar o elemento na interface da aplicação.
Buscar apenas um / Buscar uma lista
Define se a busca retornará um único elemento ou uma lista de elementos encontrados.
Ações no elemento
Permite configurar ações que podem ser executadas no elemento encontrado.
Tempo máximo de espera (em segundos)
Define o tempo máximo que o robô aguardará até localizar o elemento.
Adicionar tempo de espera para o fim da execução
Permite configurar um tempo de espera após a execução da busca.
Exemplos
Exemplo simples
Um robô precisa localizar um campo dentro de um sistema desktop.
Fluxo:
Abrir a aplicação.
Identificar a aplicação utilizando Automação Windows.
Utilizar Encontrar Campo para localizar o elemento desejado.
Exemplo aplicado
Automação de preenchimento de formulário em um sistema interno.
Fluxo do robô:
Abrir o sistema.
Identificar a aplicação com Automação Windows.
Utilizar Encontrar Campo para localizar o campo Nome.
Utilizar outro objeto para inserir informações nesse campo.
Retornos
Erros comuns e como evitar
Elemento não encontrado
Causa: o critério de busca configurado não corresponde ao elemento presente na interface.
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 no momento da busca.
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 critério de busca identifica corretamente o elemento desejado.
Configurar um tempo de espera adequado para evitar falhas na identificação do elemento.
Utilizar a opção Buscar uma lista quando houver múltiplos elementos semelhantes na interface.
Last updated
Was this helpful?