Hover OCR Text

Atividade Hover OCR Text que pesquisa uma determinada string em um elemento ou imagem de interface gráfica indicada usando a tecnologia OCR e passa o mouse sobre ela.

UiPath.Core.Activities.HoverOCRText

Pesquisa uma determinada string em uma imagem ou elemento de interface gráfica indicada usando a tecnologia OCR e foca nela. Por padrão, o mecanismo Google OCR é usado.

Propriedades

Opções

• EnviarMensagensDaJanela - Se esta caixa de seleção estiver marcada, o foco é executado enviando uma mensagem específica para o aplicativo de destino. Este método de entrada é mais rápido e funciona em segundo plano. Por padrão, essa caixa de seleção não está marcada. Se a caixa de seleção não estiver selecionada, o método padrão executará o foco usando o driver de hardware. O método padrão é o mais lento e não funciona em segundo plano, porém é compatível com todos os aplicativos de desktop.
• PosiçãoDoCursor.DeslocamentoX - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Posição.
• PosiçãoDoCursor.DeslocamentoY - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Posição.
• PosiçãoDoCursor.Posição - Descreve o ponto inicial do cursor ao qual são adicionados os deslocamentos das propriedades DeslocamentoX e DeslocamentoY. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. A opção padrão é Centro.

Comum

• DisplayName - O nome de exibição da atividade.

• AtrasoEmMs - Tempo de espera (em milissegundos) após executar a atividade. O período padrão é 300 milissegundos.

• AtrasoAntes - Tempo de atraso (em milissegundos) antes de a atividade começar a realizar qualquer operação. O período padrão é 200 milissegundos.

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

Entrada

• Texto - O string de caracteres sobre o qual você deseja focar o mouse.

  Observação:

  Todas as strings têm que ser colocadas entre aspas.

• Ocorrência - Se a string no campo Texto aparecer mais de uma vez no elemento de interface gráfica indicado, especifique aqui o número de ocorrências em que deseja clicar. Por exemplo, se a string aparecer 4 vezes e você quiser clicar na primeira ocorrência, escreva 1 neste campo. O valor padrão é 1.

• Destino.Seletor - Propriedade de texto usada para localizar um determinado elemento de interface gráfica quando a atividade é executada. Em realidade, é um fragmento XML especificando atributos do elemento GUI procurado e de alguns de seus pais.

• Destino.TempoLimiteEmMs - Especifica o período (em milissegundos) que se deve aguardar para a execução da atividade antes de gerar o erro SelectorNotFoundException. O valor padrão é de 30.000 milissegundos (30 segundos).

• Target.WaitForReady - Antes de executar as ações, aguarda o destino ficar pronto. As seguintes opções estão disponíveis:

  • Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.
  • Interativo/Completo - Espera que todos os elementos da interface gráfica no aplicativo de destino existam antes de executar, de fato, a ação.Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:
  • Aplicativos de área de trabalho — uma mensagem wm_null é enviada para verificar a existência das tags,<wnd> ,<ctrl> ,<java> ou. <uia>Se existirem, a atividade é executada.
  • Aplicativos web:
  1. Internet Explorer - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”.
  2. Outros - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está Concluído.
  • Aplicativos SAP - Primeiro a presença da tag <wnd> é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.

• Target.Element - Use a variável ElementoDaUI retornada por outra atividade. Essa propriedade não pode ser usada com a propriedade Seletor. Esse campo é compatível apenas com variáveis ElementoDaUI.

• Destino.RegiãoDeRecorte - Define o retângulo de clipagem, em pixels, em relação ao ElementoDaUi, conforme as seguintes direções: esquerda, superior, direita, inferior. Suporta números positivos e negativos.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Exemplo de uso da atividade Hover OCR Text

Confira aqui como a atividade Hover OCR Text é usada em um exemplo que incorpora várias atividades.