Clicar Texto (OCR)
Buscar conteúdo em tela e clicar
Visão Geral
O objeto Clicar Texto (OCR) permite localizar um texto específico exibido na tela por meio de OCR (Optical Character Recognition) e realizar uma ação de clique sobre ele.
Esse objeto é utilizado em automações onde elementos da interface não podem ser identificados por seletores tradicionais, como XPath ou identificadores de elementos, sendo necessário reconhecer o texto visualmente na tela.
A identificação do texto é realizada por um provedor OCR, que analisa a imagem da tela e retorna a posição onde o texto informado foi encontrado, permitindo que o robô execute a ação de clique sobre ele.
Funcionamento
O objeto funciona a partir do reconhecimento de texto presente na tela.
O processo ocorre da seguinte forma:
O robô captura a tela atual do ambiente.
O provedor de OCR processa a imagem e identifica os textos presentes.
O sistema busca o texto informado no campo Texto.
Caso o texto seja encontrado, o robô identifica sua posição na tela.
O robô executa a ação definida no campo Ação do Mouse sobre o texto localizado.
Caso o texto apareça mais de uma vez na tela, é possível definir qual ocorrência será utilizada através do campo Índice do Texto.
Também é possível definir em qual monitor a busca será realizada utilizando o campo Índice da Tela, ou habilitar a opção Buscar em todas as telas.
Quando usar
Quando o elemento na tela não possui identificadores estruturais (XPath, ID, etc.).
Quando a automação precisa interagir com textos visuais exibidos em sistemas.
Quando a interface é baseada em imagem ou renderização gráfica, dificultando a captura de elementos.
Para clicar em botões, menus ou links que podem ser identificados pelo texto exibido.
Configuração

Título
Nome do objeto no fluxo do robô. Pode ser alterado para facilitar a identificação da ação no projeto.
Nome Identificador do Objeto
Nome único que identifica o objeto dentro do robô. Pode ser utilizado posteriormente em outras ações ou validações.
Provedor OCR
Define o mecanismo de OCR responsável por realizar a leitura do texto na tela.
Idioma
Define o idioma utilizado no reconhecimento do texto pelo OCR.
Texto
Texto que será procurado na tela para realizar a ação de clique.
Índice do Texto
Define qual ocorrência do texto será utilizada quando ele aparecer mais de uma vez na tela.
Índice da Tela
Define em qual monitor a busca do texto será realizada.
Buscar em todas as telas
Permite que a busca do texto seja feita em todos os monitores disponíveis.
Ação do Mouse
Define qual ação do mouse será executada sobre o texto localizado.
Diferenciar Maiúsculas e Minúsculas
Quando habilitado, o OCR considerará diferença entre letras maiúsculas e minúsculas ao buscar o texto.
Duplo clique?
Define se a ação executada será um duplo clique sobre o texto identificado.
Exemplos
Exemplo simples
Um robô precisa clicar no botão "Confirmar" exibido em um sistema que não possui identificadores acessíveis.
Configuração do objeto:
Texto:
ConfirmarÍndice do Texto:
0Ação do Mouse:
Clique com o esquerdo
Ao executar o robô, o sistema localizará o texto Confirmar na tela e realizará o clique sobre ele.
Exemplo aplicado
Um processo automatizado precisa acessar uma opção chamada "Relatórios" em um sistema desktop onde os menus são renderizados como imagem.
Fluxo do robô:
Abrir o sistema.
Aguardar o carregamento da tela principal.
Utilizar o objeto Clicar Texto (OCR) com o texto
Relatórios.Executar o clique no menu identificado.
O robô localizará o texto na interface e executará o clique automaticamente.
Retornos

Erros comuns e como evitar
Texto não encontrado na tela
Pode ocorrer quando o texto informado no campo Texto não corresponde exatamente ao que aparece na tela.
Como evitar:
Verificar se o texto está escrito corretamente.
Ajustar o campo Idioma para o idioma correto da interface.
Múltiplas ocorrências do texto
Se o mesmo texto aparecer mais de uma vez na tela, o robô pode clicar no local incorreto.
Como evitar:
Ajustar o Índice do Texto para selecionar a ocorrência correta.
Texto localizado em monitor diferente
Quando existem múltiplos monitores, o texto pode estar em outra tela.
Como evitar:
Ajustar o Índice da Tela ou habilitar Buscar em todas as telas.
Boas práticas
Utilizar textos claros e exclusivos para evitar ambiguidades no reconhecimento.
Configurar corretamente o Idioma para melhorar a precisão do OCR.
Ajustar o Índice do Texto quando houver múltiplas ocorrências do mesmo texto.
Evitar textos muito pequenos ou com baixa qualidade visual na tela.
Last updated
Was this helpful?

