Pegar Valor do Campo
Objeto que permite pegar o valor de um campo específico nos objetos encontrados na janela Windows.
Visão Geral
O objeto Pegar Valor do Campo é utilizado para capturar o valor presente em um elemento de uma aplicação Windows durante a execução de uma automação.
Ele permite que o robô localize um elemento da interface e obtenha o valor exibido nesse campo, possibilitando que essa informação seja utilizada posteriormente no fluxo da automação.
Este objeto depende de uma Automação Windows previamente configurada, que define a aplicação onde o elemento será localizado.
Funcionamento
O objeto Pegar Valor do Campo localiza um elemento na interface da aplicação e captura o valor presente nesse componente.
Fluxo de funcionamento:
A aplicação é identificada previamente por um objeto de Automação Windows.
O objeto Pegar Valor do Campo recebe essa referência da aplicação.
O elemento é localizado utilizando o método configurado em Forma de Busca.
O robô aguarda até o Tempo máximo de espera (em segundos) configurado para localizar o elemento.
Após localizar o elemento, o robô captura o valor presente no campo.
Quando usar
Quando for necessário capturar valores exibidos em elementos de uma aplicação Windows.
Para obter informações de campos, textos ou componentes da interface.
Quando o valor capturado será utilizado em etapas posteriores da automação.
Quando não usar
Quando a automação não envolve aplicações Windows.
Quando o elemento não possui um valor que possa ser capturado pela automação.
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 valor capturado durante a execução da automação.
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.
Buscar apenas um / Buscar uma lista
Define se a busca deve localizar apenas um elemento ou uma lista de elementos encontrados.
Tempo máximo de espera (em segundos)
Define o tempo máximo que o robô aguardará até localizar o elemento na interface.
Exemplos
Exemplo simples
Um robô precisa capturar o valor exibido em um campo de um sistema desktop.
Fluxo:
Abrir a aplicação.
Identificar a aplicação utilizando Automação Windows.
Utilizar Pegar Valor do Campo para localizar o campo desejado.
Capturar o valor exibido no elemento.
Exemplo aplicado
Automação de consulta de dados em um sistema interno.
Fluxo do robô:
Abrir o sistema.
Identificar a aplicação com Automação Windows.
Localizar o campo Número do Pedido.
Utilizar Pegar Valor do Campo para capturar o valor exibido.
Utilizar esse valor em etapas posteriores da automação.
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.
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 claros no campo Título para facilitar a manutenção da automação.
Garantir que o elemento pode ser localizado de forma consistente na interface.
Utilizar critérios de busca confiáveis para evitar falhas na identificação do elemento.
Validar o valor capturado antes de utilizá-lo em outras etapas da automação.
Last updated
Was this helpful?