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.

To use this activity outside a Use Application/Browser activity, you need to provide an Input element.

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

Compatibilidade do projeto

Windows - Legado | Janelas

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 de For each UI element . Para saber mais sobre como usar essa atividade e seu assistente aqui.

  Após indicar o destino, selecione o Menu para acessar as seguintes opções:

  • Editar configuração — abra o assistente de For each UI element para configurar o destino.
  • Configurar novo destino — indique o destino novamente.
  • Remover captura de tela informativa - Remova 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 processo de automação.

  Para filtrar os itens extraídos 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 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.

• Atraso após - Atraso (em segundos) entre o momento em que esta atividade é concluída e o momento em que a próxima atividade inicia qualquer operação. O valor padrão é 0,3 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.

• 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.

• Nome daexibição - O nome exibido para a atividade no painel do Designer. Um nome de exibição é gerado automaticamente quando você indica um destino.

• 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

• Destino - O elemento de destino. É necessário definir o elemento de destino. Antes de indicar na tela, esse campo é definido como (null). Assim que o destino for indicado, todas as propriedades relacionadas ao elemento indicado serão exibidas.
  • Tipo de controle de CV - Indica o tipo de controle identificado usando o Computer Vision.
  • Texto do CV - Indica o texto identificado usando o Computer Vision.
  • Seletor difuso - Os parâmetros para o seletor difuso.
  • Texto nativo - O texto usado para identificar o elemento de interface gráfica.
  • Sites responsivos — habilita 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 seletor 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
  • Verificação devisibilidade — verifica se o elemento de interface gráfica está visível ou não. Você pode escolher uma das três opções do menu suspenso:
    • Nenhum - Não verifica a visibilidade.
    • Interativo (para seletor Difuso) - opção padrão. Verifica se o elemento está potencialmente visível, ignorando a rolagem da página, as obstruções de outros aplicativos ou o fato de o aplicativo estar minimizado. Essa verificação é útil ao tentar garantir que você não esteja segmentando 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 as Actions, aguarde o aplicativo ficar pronto para aceitar a entrada. Você pode escolher uma das três opções do 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 somente quando o modo de anexação de janela estiver definido como Instância do aplicativo.
• Destino (botão Avançar) - O próximo Elemento da Interface Gráfica no qual você deseja executar as Actions . Antes de indicar na tela o destino que você deseja usar, esse campo é definido como (null). Assim que o destino for indicado, todas as propriedades relacionadas ao elemento indicado serão exibidas. Exceto para Deslocamento de clique, as propriedades filhos desse campo são idênticas àquelas específicas da propriedade Destino .
  • Deslocamento de clique - Especifica um deslocamento para a atividade do clique, que pode ser configurado ainda mais.
    • Ponto de ancoragem - Descreve o ponto inicial do cursor para o qual ele se desloca das propriedades Deslocamento de X e Deslocamento de Y. As seguintes opções estão disponíveis: SuperiorEsquerda, SuperiorDireita, InferiorEsquerda, InferiorDireitae Centro. Por padrão, o Centro é selecionado.
    • Deslocamento de X - Deslocamento horizontal da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .
    • Deslocamento de Y - Deslocamento vertical da posição do cursor de acordo com a opção selecionada no campo Ponto de ancoragem . Esse campo é compatível apenas com variáveis Int32 .

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

Diversos

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

Opções

• Atraso entre páginas - A quantidade de tempo (em segundos) para aguardar até que a próxima página seja carregada se os dados abrangerem várias páginas.

• Modo de entrada - Selecione qual método o Robô deve usar para interagir com o aplicativo de destino:

  • O mesmo que App/Browser — usa 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. Este é o método mais lento, não pode funcionar em segundo plano, mas é compatível com 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ãoDoMouseou 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 Actions. 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 do Windows - Simule usando mensagens Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware. Envia todo o texto em uma única Actions. 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.

• Limitar extração a - O tipo de limite que você deseja aplicar ao extrair dados. As seguintes opções estão disponíveis:
  • Máx. de 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 - Extrai todos os elementos que podem ser encontrados, sem nenhum limite.
  • Máx. de páginas - Especifica o número máximo de páginas das quais você deseja extrair elementos da interface gráfica, ao extrair dados de tabelas que abrangem várias páginas.
• Número de itens - O número máximo de resultados que você deseja extrair. Se o valor for 0, todos os itens identificados serão extraídos.