For Each UI Element

UiPath.UIAutomationNext.Activities.NForEachUiElement

Description

Itera por uma lista de elementos de interface gráfica e executa uma ou várias Actions em cada um deles.

Esta atividade precisa ser adicionada a uma atividade Use Application/Browser.

Para usar esta atividade fora de uma atividade Use Application/Browser , você precisa fornecer um Elemento de entrada.

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

Compatibilidade do projeto

Windows - Legacy | Windows

Windows - Legada, Configuração do Windows

Painel do Designer

• Clique em Indicar no Aplicativo/Navegador para indicar o elemento de interface gráfica a ser usado como destino usando o assistente Para cada elemento de interface gráfica . Você pode saber mais sobre como usar essa atividade e seu assistente aqui.

Depois de indicar o destino, selecione o Menu botão para acessar as seguintes opções:

• Editar configuração - Abra o assistente Para cada elemento de interface gráfica para configurar o destino.
• Configurar novo destino — indique o destino novamente.
• Remover captura de tela informativa – Remove a captura de tela do aplicativo de destino ou página da Web.
• Adicionar ao Repositório de Objetos - Adicione o elemento de interface gráfica atual a um projeto de biblioteca, de onde ele pode ser reutilizado em todo o seu processo de automação. Para filtrar os itens que você extraiu com sua seleção, selecione Configurar filtro.

Painel de Propriedades

Comum

• 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.
• Delay after - Delay (in seconds) between the time this activity is completed and the time the next activity begins any operations. The default value is 0.3 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
• 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.
• Nome de exibição — o nome exibido da atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.
• 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

• Destino — o elemento de destino. Defina o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Depois que o destino for indicado, todas as propriedades relacionadas ao elemento que foi indicado são exibidas.

  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • CV Text - Indica o texto identificado usando o Computer Vision.
  • Fuzzy selector - The parameters for the fuzzy selector.
  • Texto nativo - O texto que é usado para identificar o elemento de interface gráfica.
  • Sites responsivos - Habilitar o layout de sites responsivos.
  • Seletor restrito - O seletor restrito gerado para o elemento de interface gráfica.
  • Métodos de segmentação - Os tipos de seletores que você deseja usar para identificar o elemento. Essa propriedade pode ser definida como qualquer combinação no menu suspenso:
    • Nenhum
    • Seletor restrito
    • Seletor difuso
    • Imagem
    • Texto nativo
    • Computer Vision - Para usar o Computer Vision como um método de segmentação, você precisa acessar Configurações do projeto > Computer Vision e certificar-se de definir o ponto de extremidade do servidor correto. Você pode deixar esse campo como está e usar o UiPath Cloud, que é preenchido por padrão, ou você pode inserir outro valor selecionando qualquer um dos outros pontos de extremidade públicos específicos de uma região do servidor ou seu próprio servidor no local. Outra maneira de usar o Computer Vision como um método de segmentação é definir Usar Servidor Local como True. Isso indica que o pacote UiPath.ComputerVision.LocalServer está instalado em seu projeto. Quando o Servidor local é habilitado, o valor do servidor é substituído. No entanto, o Servidor local não está disponível em projetos multiplataforma.
    • Seletor semântico – Aproveita modelos de linguagem grande (LLMs) para gerar descrições funcionais e semelhantes às humanas de elementos de interface gráfica. Essas descrições são altamente confiáveis, tornando-as adaptáveis a alterações de interface gráfica e melhorando significativamente a resiliência da automação quando os seletores tradicionais falham.
  • Verificação de visibilidade - Verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções no menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para Seletor difuso) - Opção padrão. Verifica se o elemento é potencialmente visível, ignorando a rolagem de página e obstruções por outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja visando elementos invisíveis que existem no DOM, mas que estão ocultos.
    • Totalmente visível
      • Verifica se o elemento de interface gráfica está visível ou não.
  • Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções no menu suspenso:
    • Nenhum - Não aguarda que o destino esteja pronto.
    • Interativo - Aguarda até que apenas uma parte do aplicativo seja carregada.
    • Completo - Aguarda até que todo o aplicativo seja carregado.
  • Seletor de janela (Instância do aplicativo) - O seletor que é usado para a janela do aplicativo. Aplicável apenas quando o modo de anexação de janela estiver definido como Instância do aplicativo.

• Destino (botão Avançar) - O próximo elemento de interface gráfica no qual você deseja realizar ações. Antes de indicar na tela o destino que você deseja usar, este campo é definido como (null). Depois que o destino for indicado, todas as propriedades relacionadas ao elemento que foi indicado são exibidas. Exceto para Click Offset, as propriedades filhas desse campo são idênticas àquelas específicas para a propriedade Destino .

  • Deslocamento de clique - Especifica um deslocamento para a atividade de clique, que pode ser configurado ainda mais.
    • Ponto de ancoragem - Descreve o ponto inicial do cursor ao qual ele se desloca das propriedades Deslocamento X e Deslocamento Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireita e Centro. Por padrão, o Centro é selecionado.
    • Deslocamento X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .
    • Deslocamento Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Este campo é compatível apenas com variáveis Int32 .

Elemento de 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.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse campo é compatível apenas com valores Boolean (True, False). O valor padrão é False.

Opções

• Delay between pages - The amount of time (in seconds) to wait until the next page is loaded if the data spans multiple pages.
• Input mode - Select which method the Robot should use to interact with the target application:
  • Igual ao aplicativo/navegador — use o mesmo modo de entrada da atividade Use Application/Browser . Essa é a seleção padrão.
  • Eventos de hardware - Usa o driver de hardware para executar a ação. Esse é o método mais lento e não pode funcionar em segundo plano, mas é compatível todos os aplicativos de desktop. Essa opção é selecionada por padrão se você alterar a configuração padrão para qualquer uma das seguintes propriedades TipoDeClique, BotãoDoMouse ou ModificadoresDeTecla.
  • Simular - Simula usando APIs de acessibilidade. Recomendado para navegadores, aplicativos baseados em Java e SAP. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única ação. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas com elementos do Chromium. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco. Para obter mais detalhes, consulte esta página.
  • Mensagens de janelas - Simule usando mensagens Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única ação. Funciona mesmo que o aplicativo de destino não esteja em foco. Teste se o elemento de interface gráfica de seu aplicativo de destino é compatível com isso.
• Limit extraction to - The type of limit you want to apply when extracting data. The following options are available:
  • Elementos de interface gráfica - Especifica o número máximo de elementos de interface gráfica que você deseja extrair. O valor padrão é 1000.
  • No limit - Extracts all elements that can be found, without any limit.
  • Máximo de páginas - Especifica o número máximo de páginas das quais você deseja extrair elementos de interface gráfica ao extrair dados de tabelas que abrangem várias páginas.
• Number of items - The maximum number of results that you want to extract. If the value is 0, all of the identified items are extracted.