Find Text Position

UiPath.Core.Activities.FindText

Pesquisa uma determinada cadeia de caracteres em um elemento de interface gráfica e retorna outro elemento de interface gráfica que tem a região de recorte definida para a posição de tela dessa cadeia.

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

Entrada

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

  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.

Saída

• ElementoDaUI - O elemento da interface gráfica no qual a string procurada está localizada. Esse campo é compatível apenas com variáveis ElementoDaUI.

Opções

• TextoFormatado - Se esta caixa de seleção estiver marcada, o layout de tela do texto selecionado é 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 Find Text Position

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