file-linesClicar 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:

  1. O robô captura a tela atual do ambiente.

  2. O provedor de OCR processa a imagem e identifica os textos presentes.

  3. O sistema busca o texto informado no campo Texto.

  4. Caso o texto seja encontrado, o robô identifica sua posição na tela.

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

CAMPO
DESCRITIVO

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: 0

  • Açã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ô:

  1. Abrir o sistema.

  2. Aguardar o carregamento da tela principal.

  3. Utilizar o objeto Clicar Texto (OCR) com o texto Relatórios.

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