Localizar elementos

UiPath.UIAutomationNext.Activities.NFindElements

Description

Recupera uma coleção de elementos de interface gráfica, sejam filhos, descendentes ou níveis superiores, de acordo com um escopo especificado e critérios de filtro.

Esta atividade é compatível com o Repositório de Objetos.

Compatibilidade do projeto

Windows | Multiplataforma

Configuração

• Modo - Permite definir o modo de localização dos elementos de interface gráfica na coleção. As seguintes opções estão disponíveis:
  • Encontrar filhos - Localiza elementos de primeiro nível que correspondem ao filtro do destino/elemento/Escopo indicado.
  • Localizar descendentes — Localiza todos os elementos que correspondem ao filtro do destino/elemento/Escopo indicado.
  • Localizar níveis superiores - Localizar todos os elementos que correspondem ao filtro de todos os aplicativos abertos.

• Filtro - String XML especificando as condições que todos os elementos na coleção devem atender. O filtro é um seletor. A atividade pesquisa todos os filhos ou descendentes do elemento de destino, correspondendo ao seletor.

  Por exemplo, o uso de <webctrl tag='UL' /> iniciaria uma pesquisa por elementos de lista não ordenados dentro de uma determinada página da Web.
  Observação: Se a condição do filtro que você estiver utilizando deixar todos os elementos possíveis, uma lista vazia de elementos será retornada.

Painel de Propriedades

Opções

• Modo do Healing Agent - configura o comportamento do Healing Agent para esta atividade, com base nas configurações de Governança ou do Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Apenas recomendação — permite que o Healing Agent forneça recomendações sobre como corrigir problemas de automação de interface gráfica na execução de trabalhos, mas somente se permitido pela governança ou pelas configurações do Orchestrator.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita Boolean valores (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.

Horários

• Atraso antes — atraso (em segundos) entre o momento em que a atividade anterior é concluída e o momento em que esta atividade começa a realizar alguma operação. O valor padrão é de 0,2 segundos. Adicionar um atraso entre as atividades garante que uma atividade tenha tempo suficiente para ser concluída antes do início da próxima atividade.

• Tempo limite — especifique o período (em segundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

Entrada/Saída

• Elemento deentrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Esse campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de Saída de outras atividades do UIAutomation.
• Elemento de saída - Gera um Elemento de Interface Gráfica de destino e o armazena em um objeto UIElement , que pode ser usado para direcionar o mesmo elemento com outras atividades.

Saída

Filhos - Todos os filhos da interface gráfica encontrados de acordo com o conjunto de filtro e escopo. O campo é compatível apenas com variáveis IEnumerable<UiElement> .