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 - Legado | Janelas

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 essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, 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.
• NomeDeExibição - 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.
• Target.ClippingRegion - Define o retângulo de recorte, em pixels, relativo ao UiElement, nas seguintes direções: esquerda, superior, direita, inferior. Ele 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.
• Target.Selector - Propriedade de texto usada para localizar um determinado elemento da interface do usuário quando a atividade é executada. Na verdade, é um fragmento XML especificando atributos do elemento GUI que você está procurando 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, esse 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 alvo 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 neste 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 chaves 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 com o 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.

Se você indicar várias telas ao automatizar um aplicativo, poderá alternar entre as telas usando os botões direcionais (<, >) para verificar facilmente quais telas a atividade está usando.

As telas também podem ser renomeadas selecionando-as no menu suspenso Nome de tela e clicando no botão .