Obter Texto Visível

UiPath.Core.Activities.GetVisibleText

Extrai uma cadeia de caracteres e suas informações de um elemento de interface gráfica indicado usando o método de extração da tela Native. Esta atividade também pode ser gerada automaticamente ao realizar a extração da tela com um contêiner.

Observação:

Essa atividade não funciona corretamente quando usada em navegadores que exigem que as extensões sejam automatizadas, como Chrome, Firefox e Edge.

Propriedades

Saída

• Texto - A string de caracteres extraída do elemento de interface gráfica indicado.
• InformaçõesSobrePalavras - As coordenadas de tela de cada palavra localizada no elemento de interface gráfica indicado. Este campo é compatível apenas com variáveis TextInfo.

Opções

• Separadores - Especifica os caracteres usados como separadores de string. Se o campo estiver vazio, todos os separadores de texto conhecidos serão usados (espaço, ponto final, vírgula etc.).
• TextoFormatado - Se esta caixa de seleção estiver marcada, o layout de tela do texto copiado é preservado.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
• 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.

Comum

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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

Exemplo de uso da atividade Get Visible Text

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