Element Scope

Atividade Element Scope que se anexa a um elemento de interface gráfica existente e o expõe como o escopo para várias atividades filho.

Importante:

A atividade moderna Element Scope está disponível apenas em Visualização.

UiPath.UIAutomationNext.Activities.NElementScope

Description

A atividade Element Scope identifica um único elemento de interface gráfica uma vez e, em seguida, o expõe como o escopo para cada atividade colocada em seu corpo. Todas as atividades filho (por exemplo, Click, Type Into, Get Text, Get Attribute) têm elementos de destino relativos ao elemento que você indicou, em vez de pesquisar toda a tela novamente.

Use-o quando quiser executar várias ações dentro do mesmo contêiner — uma linha de tabela, uma seção de formulário, um cartão ou um painel — enquanto mantém os seletores curtos, estáveis e rápidos.

O corpo da atividade é um contêiner. As atividades filho que devem ter como alvo o elemento indicado (ou seus descendentes) são colocadas dentro do corpo. Cada atividade filho é executada em relação ao elemento capturado pelo escopo, então você só indica o elemento pai uma vez.

Observação:

O Element Scope pode ser colocado dentro de uma atividade Use Application/Browser para que o elemento seja resolvido dentro desse escopo de aplicativo/navegador e as atividades filhas possam herdar suas configurações. Também pode ser usada sozinho, indicando um elemento diretamente.

Compatibilidade do projeto

Janelas | Plataforma cruzada

Configuração

• Indicar na tela – Indica o elemento de interface gráfica ao qual você deseja anexar. Após indicado, o cartão de atividade exibe uma visualização do elemento de destino e suas âncoras.
  Depois de indicar o destino, gerencie o destino selecionando o botão de opções de menu e escolhendo uma das seguintes opções:
  • Indicar destino - Indica o destino novamente. Se o Descritor for definido no Repositório de Objetos, você terá que desvinculá-lo antes de poder indicar um Descritor apenas para a atividade atual.
  • Editar destino - Abra o Auxiliar de seleção para configurar o elemento de destino.
  • Remover captura de tela informativa – Remove a captura de tela do elemento de destino.
  • Alterar captura de tela – Altera a captura de tela do elemento de destino.
  • Mostrar no Repositório de Objetos - Abre o painel Repositório de Objetos com o Descritor selecionado.
  • Desvincular do Repositório de Objetos - Desvincula o Descritor do Repositório de Objetos.
  • Adicionar ao Repositório de Objetos - Adiciona 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.

Painel de Propriedades

Destino

O elemento de interface gráfica ao qual o escopo se anexa. O destino é configurado quando você indica o elemento na tela e pode ser refinado usando as seguintes opções:

• Seletor de janela (Instância do aplicativo) - O seletor para a janela do aplicativo (aplicativo/navegador).
• Seletor restrito - O seletor gerado para o elemento indicado. Um seletor é um fragmento XML que identifica o elemento por seus atributos.

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.
  • Igual ao Aplicativo/Navegador — herda a configuração da atividade pai Use Application/Browser .
  • Herdar configurações do trabalho — aplica as configurações definidas na governança ou no Orchestrator no nível do processo ou trabalho.
  • Desabilitado - Desativa o Healing Agent para essa atividade.
  • 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.
• 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 continua independentemente de qualquer erro.
• Modo de entrada - Especifica qual tecnologia é usada para interagir com o elemento de destino. As atividades filho dentro do escopo podem herdar esse modo. As opções disponíveis são:
  • Eventos de hardware - age como um usuário real, usando o mouse e o teclado por meio do sistema operacional. Emula totalmente o comportamento humano, mas alguns eventos podem ser perdidos, e o aplicativo de destino deve estar em foco.
  • Simular — simula a ação 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 e funciona mesmo quando o aplicativo de destino não está em foco. Verifique se o elemento de destino é compatível com ele.
  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas para elementos do Chromium. Envia todos os textos de uma vez e funciona quando o aplicativo de destino não está em foco.
  • Mensagens do Windows - Usa mensagens Win32. Recomendado para aplicativos de desktop. Geralmente mais confiável que Eventos de hardware, envia todos os textos de uma vez e funciona mesmo quando o aplicativo de destino não está em foco. Verifique se o elemento de destino é compatível com ele.
  • Segundo plano — Executa em segundo plano. Usa Simular quando possível; atividades complexas (imagem, texto nativo) ainda são executadas em primeiro plano.

Horários

• Tempo limite — especifica a quantidade de tempo (em segundos) para aguardar que o elemento de destino seja encontrado antes de gerar um erro. O valor padrão é 30 segundos.

Observação:

As propriedades Atraso antes e Atraso após não são usadas pelo Escopo do Elemento e estão ocultas no Designer. As configurações de atraso no nível do projeto não são aplicadas intencionalmente a esta atividade.

Entrada/Saída

• Elemento de entrada - O elemento de interface gráfica no qual a atividade é executada, armazenada 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 - O elemento de interface gráfica resolvido, armazenado em um objeto UiElement . Essa variável pode ser passada para outras atividades que aceitam UiElement como entrada.