Marcar Caixa de Seleção
Objeto que permite marcar um campo específico nos objetos encontrados na janela Windows.
Visão Geral
O objeto Marcar Caixa de Seleção permite marcar ou desmarcar uma caixa de seleção (checkbox) em 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 alterar o estado da caixa de seleção.
Este objeto depende de uma Automação Windows previamente configurada, que define a aplicação onde o elemento será localizado.
Funcionamento
O objeto Marcar Caixa de Seleção localiza uma caixa de seleção na interface da aplicação e altera seu estado conforme configurado.
Fluxo de funcionamento:
A aplicação é identificada por um objeto de Automação Windows.
O objeto Marcar Caixa de Seleção 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 a caixa de seleção, o robô executa a ação definida no campo Marcar caixa de seleção.
Quando usar
Quando for necessário marcar ou desmarcar caixas de seleção em aplicações Windows.
Para configurar opções ou parâmetros 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 alterado não é uma caixa de seleçã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 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 a caixa de seleção será localizada.
Forma de Busca
Define o método utilizado para localizar o elemento na interface da aplicação.
XPath
Caminho utilizado para identificar a caixa de seleção 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.
Marcar caixa de seleção
Define o estado que será aplicado à caixa de seleção localizada.
Exemplos
Exemplo simples
Um robô precisa marcar uma opção em um formulário de um sistema desktop.
Fluxo:
Abrir a aplicação.
Identificar a aplicação utilizando Automação Windows.
Utilizar Marcar Caixa de Seleção para localizar a opção desejada.
Marcar a caixa de seleção configurada.
Exemplo aplicado
Automação de configuração de parâmetros em um sistema interno.
Fluxo do robô:
Abrir o sistema.
Identificar a aplicação com Automação Windows.
Localizar a opção Ativar notificações.
Utilizar Marcar Caixa de Seleção para marcar a opção na interface.
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: a interface ainda não carregou o elemento quando o robô executa a busca.
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 a caixa de seleção pode ser localizada de forma consistente na interface.
Verificar o estado desejado da caixa de seleção antes de executar a automação.
Utilizar critérios de busca confiáveis para evitar falhas na identificação do elemento.
Last updated
Was this helpful?

