UiPath Documentation
activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Atividades do UIAutomation

Última atualização 14 de mai de 2026

CV Screen Scope

UiPath.CV.Activities.CVScope

Description

Inicializa a rede neural do Computer Vision do UiPath, realizando uma análise da janela indicada e fornecendo escopo para todas as atividades Computer Vision subsequentes. A atividade habilita você a selecionar qual mecanismo OCR você deseja usar para extrair o texto no aplicativo de destino. O mecanismo OCR padrão usado para essa atividade é o UiPath Screen OCR. O mecanismo pode ser alterado substituindo-se manualmente o mecanismo padrão por um de sua escolha.

Observação:

Se você estiver usando uma implantação do servidor Linux Computer Vision no local, você também pode usar o mecanismo UiPath Screen OCR com essa atividade.

Compatibilidade do projeto

Windows - Legacy | Windows

Configuração

Comum
  • 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.

  • AtrasoAntes - Tempo de atraso (em milissegundos) antes de a atividade começar a realizar qualquer operação. O valor padrão para esse campo é de 300 milissegundos.

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

Entrada
  • MétodoCV - Uma lista suspensa que especifica qual método de detecção você deseja usar com essa atividade. Por padrão, tanto a opção DetecçãoDoElemento quanto OCR estão selecionadas. As seguintes opções estão disponíveis:
    • Nenhum - Usa apenas automação de imagens.
    • Detecção do elemento - Usa o Computer Vision.
    • OCR - Usa OCR.
  • 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.
  • 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.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.TempoLimite (milissegundos) - 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. Por padrão, este campo é definido como Interativo. 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 — espera os elementos de interface gráfica com os quais você está trabalhando no aplicativo de destino existirem antes de executar a ação.
    • Concluído — espera todos os elementos da interface gráfica no aplicativo de destino existirem antes de executar 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:
        • 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 False.
        • 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, uma API específica da SAP é usada para detectar se a sessão está ocupada ou não.
Diversos
  • Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
Rolar
  • Deslocamento de rolagem — Deslocamento de rolagem usado na rolagem para encontrar o destino de cada uma das atividades do Computer Vision nesse escopo.
Servidor (sincronizado)
  • ChaveDaAPI - A chave de API usada para autenticação no servidor do Computer Vision. Esse campo é compatível apenas com strings ou variáveis String. Essa é uma propriedade global, compartilhada entre todas as atividades CV Screen Scope no fluxo de trabalho.

    Observação:

    Observe que a chave de API é necessária apenas ao se conectar ao servidor do UiPath Automation Cloud. Você pode encontrar mais informações sobre a aquisição de uma chave aqui.

    Observação:

    A edição da propriedade ChaveDaAPI para uma atividade de escopo altera o valor para todos os outros escopos no fluxo de trabalho atual; portanto, você não precisa fazer isso manualmente.

  • URL - A URL do servidor que executa o serviço Computer Vision. Por padrão, essa propriedade é definida como https://cv.uipath.com/. Essa é uma propriedade global, compartilhada entre todas as atividades CV Screen Scope no fluxo de trabalho.

  • UsarServidorLocal - Se estiver marcada, o servidor local será usado para a análise. Para usar o servidor local, o pacote UiPath.ComputerVision.LocalServer precisa estar instalado.

    Observação:

    Ao usar uma implantação de servidor local do modelo de rede neural, para se conectar a ele com as atividades Computer Vision, você deve alterar o valor da propriedade URL da atividade CV Screen Scope para a URL de seu servidor. Mais detalhes sobre a conexão ao servidor estão disponíveis aqui.

No corpo da atividade

O aplicativo que você deseja automatizar pode ser indicado para a atividade CV Screen Scope usando o botão Indicar na tela no corpo da atividade. Depois de fazer isso, uma captura da tela que você indicou é exibida no corpo da atividade.

If you indicate multiple screens when automating an application, you can cycle between the screens by using the directional buttons (<, >) to easily check what screens the activity is using.

Screens can also be renamed by selecting them from the Screen Name drop-down and clicking the docs image button.

  • Description
  • Compatibilidade do projeto
  • Configuração
  • No corpo da atividade

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades