Texto Existe

UiPath.Core.Activities.TextExists

Verifica se um texto é encontrado em um determinado elemento de interface gráfica.

Observação: essa atividade não funciona corretamente quando usada em navegadores que requerem automatização de extensões, como Chrome, Firefox e Edge.

Propriedades

Entrada

• Texto - A string que você está procurando.

  Nota: Todas as strings devem 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 localizar. Por exemplo, se a string aparecer 4 vezes e você quiser localizar a primeira ocorrência, escreva 1 neste campo. O valor padrão é 1.

Opções

• 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.
• 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.
• Target.TimeoutMS - Especifica a quantidade de tempo (em milissegundos) para aguardar a execução da atividade antes que o erro SelectorNotFoundException seja lançado. O valor padrão é 30000 milissegundos (30 segundos).

• Target.WaitForReady - Antes de executar as ações, aguarde 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 do usuário no aplicativo de destino existam 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:
  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 UiElement retornada por outra atividade. Esta propriedade não pode ser usada junto com a propriedade Selector. Este campo suporta apenas variáveis UiElement.
• Destino.RegiãoDeRecorte - Define o retângulo de recorte relativo ao ElementoDaUi.

Saída

• Existe - Indica se o texto existe ou não. O campo suporta apenas variáveis booleanas.

Comum

• NomeDeExibição - o nome de exibição da atividade.