Buscar Grid
Sua função é buscar um elemento de Grid e converter para Tabela de dados
Visão Geral
O objeto Buscar Grid é utilizado para localizar e identificar uma estrutura de grid (tabela) dentro de uma aplicação Windows durante a execução de uma automação.
Esse objeto permite que o robô encontre uma grid presente na interface da aplicação para que seus dados possam ser utilizados posteriormente no fluxo da automação.
Para realizar a busca, o objeto utiliza a referência da aplicação Windows e um XPath do componente da grid, permitindo localizar o elemento específico dentro da interface.
Funcionamento
O objeto Buscar Grid realiza a identificação de uma grid presente na interface de uma aplicação Windows.
Fluxo de funcionamento:
A automação define previamente a aplicação utilizando um objeto de Automação Windows.
O objeto Buscar Grid recebe essa referência da aplicação.
Um XPath do Grid é informado para localizar a tabela dentro da interface.
O robô executa a busca na aplicação dentro do tempo máximo configurado.
Após localizado, o objeto passa a representar a grid identificada na aplicação, podendo ser utilizada por outros objetos da automação.
Quando usar
Quando for necessário localizar uma tabela (grid) em uma aplicação Windows.
Para capturar ou manipular informações presentes em estruturas de dados tabulares.
Quando a automação precisa interagir com listas ou tabelas exibidas na interface do sistema.
Quando não usar
Quando a automação não envolve aplicações Windows.
Quando o elemento a ser localizado não é uma grid ou tabela.
Configuração
CAMPO
DESCRITIVO
Título
Nome do objeto dentro do fluxo do robô. Utilizado para facilitar a identificação da etapa na automação.
Nome Identificador do Objeto
Identificador único que representará a grid localizada durante a execução do robô.
Selecionar objeto do tipo Automação Windows
Permite selecionar a aplicação Windows onde a grid será localizada.
Xpath do Grid
Caminho XPath utilizado para identificar a grid dentro da interface da aplicação.
Tempo máximo de espera (em segundos)
Define o tempo máximo que o robô aguardará até que a grid seja localizada na aplicação.
Exemplos
Exemplo simples
Um robô precisa localizar uma tabela exibida em um sistema desktop.
Fluxo:
Abrir a aplicação.
Identificar a aplicação utilizando Automação Windows.
Utilizar Buscar Grid para localizar a tabela na interface.
Exemplo aplicado
Automação de leitura de registros em um sistema interno.
Fluxo do robô:
Abrir o sistema desktop.
Identificar a aplicação com Automação Windows.
Utilizar Buscar Grid para localizar a tabela de registros.
Utilizar outros objetos da automação para processar os dados exibidos na grid.
Retornos
Erros comuns e como evitar
Grid não encontrada
Causa: o XPath configurado não corresponde ao elemento da interface.
Como evitar:
Verificar se o XPath do Grid 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: a grid ainda não foi carregada quando o robô executa a busca.
Como evitar:
Ajustar o campo 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 a aplicação foi corretamente identificada antes da busca da grid.
Utilizar um XPath confiável para evitar falhas na identificação da tabela.
Configurar um tempo de espera adequado para garantir que a interface esteja carregada.
Last updated
Was this helpful?