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

Janelas | Plataforma cruzada

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 de filtro utilizada desconsiderar 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 aceita apenas valores Boolean (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

• Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• Tempo limite — especifique a quantidade de tempo (em segundos) para esperar que a atividade seja executada antes de gerar um erro. O valor padrão é 30 segundos.

Entrada/Saída

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto UIElement . Este campo é compatível apenas com objetos UIElement . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.
• 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> .