square-checkMarcar 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:

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

  2. O objeto Marcar Caixa de Seleção 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 (em segundos) configurado para localizar o elemento.

  5. 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:

  1. Abrir a aplicação.

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

  3. Utilizar Marcar Caixa de Seleção para localizar a opção desejada.

  4. Marcar a caixa de seleção configurada.

Exemplo aplicado

Automação de configuração de parâmetros em um sistema interno.

Fluxo do robô:

  1. Abrir o sistema.

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

  3. Localizar a opção Ativar notificações.

  4. 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?