Click

UiPath.UIAutomationNext.Activities.NClick

Description

Clica em um elemento de IU especificado, por exemplo, um botão ou link. Ele pode ser configurado para usar qualquer botão do mouse, usar um duplo clique e pode ser usado em combinação com um modificador de tecla.

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 - Legada | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• Trabalho no escopo - Escolha a guia do navegador que renderiza o aplicativo da Web para automatizar.

• Indicar destino na tela

  • Indica o elemento de interface gráfica a ser usado como destino. Depois de indicar o destino, selecione o botão de adição para acessar as seguintes opções:
  • Indicate target on screen - Indicate the target again.
  • Editar destino - Abra o modo de seleção para configurar o destino.

• Verificar - Defina a etapa de verificação da execução da atividade.

  • Nenhum - Indica que nenhuma verificação é executada no elemento de destino.
  • Elemento exibido - Verifica se o elemento aparece.
  • Elemento desapareceu - Verifica se o elemento desaparece.
  • Texto do elemento alterado - Verifica se há alterações no texto do elemento.

Painel de Propriedades

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.

Opções

• Tipo de clique — selecione no menu suspenso o tipo de clique a ser realizado: Único, Duplo, Pressionado ou Ao soltar. A opção padrão é Único.
• Botão do mouse - Selecione no menu suspenso o botão do mouse para clicar com: Esquerdo, Meio, ou Direita. A opção padrão é Esquerda.
• Modificadores de tecla — Adicione um ou mais modificadores de tecla a serem usados na combinação com o clique. As seguintes opções estão disponíveis: Alt, Ctrl, Shift e Win.
• Alterar elemento desabilitado - Se estiver selecionado, a atividade executa a ação mesmo se o elemento de interface gráfica especificado esteja desabilitado. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Essa propriedade não se aplica se a propriedade Modo de entrada estiver definida como Eventos de hardware.
• Ativar – Leva ao primeiro plano o elemento de interface gráfica e o ativa antes de clicar nele. Este campo só aceita valores booleanos (True, False). O valor padrão é True.
• Tipo de movimento do cursor - Especifica o tipo de movimento executado pelo cursor do mouse. Há duas opções disponíveis:
  • Instantâneo - O cursor salta para o destino. Esse é o valor padrão.
  • Suave - O cursor se move em incrementos. A configuração tem efeito apenas se o modo de entrada de eventos de hardware for usado.
• Entrada de desbloqueio - Deve ser usada quando a ação de clique disparar uma caixa de diálogo modal ou qualquer outro elemento de interface gráfica que bloqueia a interação adicional. Funciona apenas junto com o método de entrada Simular . Este campo só aceita valores booleanos (True, False).
• Input mode - Select which method the Robot should use to interact with the target application:
  • Igual ao navegador — use a configuração Modo de entrada da atividade pai Use Browser .
  • Eventos de hardware - Atua como um usuário real usando entradas de “hardware”, como movimentos do mouse ou pressionamentos de teclado, para interagir com os aplicativos. Esses são eventos acionados por hardware enviados diretamente ao sistema operacional. Embora esse método ofereça 100% de emulação comportamental, alguns eventos podem ocasionalmente ser perdidos. Como desenvolvedor, é sua responsabilidade garantir que todos os eventos alcancem de forma confiável o aplicativo de destino.
  • API do Chromium — executa ações usando APIs do depurador. Funciona apenas para elementos do Chrome e Edge. Envia todos os textos de uma vez. Funciona mesmo que o aplicativo de destino não esteja em foco.
  • Simular - Simula o clique usando APIs de acessibilidade. Funciona para navegadores. Envia todos os textos de uma vez. Esse método de entrada funciona em segundo plano (mesmo que o aplicativo de destino não esteja em foco).
• 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 valores booleanos (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.

Destino

• Expandir propriedades de destino - Exibe as propriedades de destino e de âncora. Isso ocultará as outras propriedades da atividade e exibirá apenas aquelas relacionadas ao destino.

• Recolher propriedades de destino — Oculta propriedades de destino e de âncora. Isso ocultará as propriedades relacionadas ao destino e exibirá as propriedades da atividade.

• 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 - O seletor restrito gerado para o elemento de interface gráfica de destino.
  • Seletor difuso - Os parâmetros do seletor difuso.
  • 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.
    • 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.
    • Ocorrência de CV Text - Indica uma ocorrência específica a ser usada quando várias correspondências são encontradas.
    • Precisão do texto CV - Indica o nível de precisão para correspondência de texto OCR.
  • 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.
  • Imagem (apenas Windows)
    • Precisão da imagem - Indica o nível de precisão para correspondência de imagens.
    • Ocorrência de imagem - Indica uma ocorrência específica a ser usada, quando várias correspondências são encontradas.
  • Texto nativo (apenas Windows)
    • Texto nativo - O texto a ser encontrado para identificar o elemento de interface gráfica.
    • Ocorrência de texto nativa - Indica uma ocorrência específica a ser usada quando várias correspondências forem encontradas.

• Seletor de janela (Instância do aplicativo) — Seletor da janela do aplicativo. Aplicável somente quando modo de anexação de janela estiver definido como instância do aplicativo.

• Aguardar carregamento da página — antes de executar a ação, aguarda o aplicativo ficar pronto para aceitar a entrada. As opções são:

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

• Verificação de visibilidade - Ao habilitada, a atividade também 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.

• Sites responsivos - Habilitar o layout de sites responsivos.

• Deslocamento de clique - Especifica um deslocamento para a atividade Click, 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 .

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

Windows - Configuração legada

• Selecione Indicar no aplicativo/navegador para indicar o elemento de interface gráfica a ser usado como destino.

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

• Indicate target on screen - Indicate the target again.
• Editar destino - Abra o modo de seleção para configurar o destino.
• Adicionar verificação / Remover verificação - Adiciona ou remove a funcionalidade Indicar destino de verificação na tela no cartão de atividade. Verifique se a execução está habilitada por padrão.
• 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 seu processo de automação.

• Tipo de clique — selecione no menu suspenso o tipo de clique a ser realizado: Único, Duplo, Pressionado ou Ao soltar. A opção padrão é Único.
• Botão do mouse - Selecione no menu suspenso o botão do mouse para clicar com: Esquerdo, Meio, ou Direita. A opção padrão é Esquerda.
• Indicar destino de verificação na tela — Indique o elemento de interface gráfica a ser usado como destino e que deve aparecer ou desaparecer após a ação ser executada. Use esse recurso quando você quiser garantir que uma ação específica realizada pela atividade tenha sido executada corretamente durante o runtime. Isso é especialmente útil em processos automatizados, nos quais você precisa confirmar se elementos de interface gráfica específicos aparecem ou desaparecem como resultado de uma ação. Ele adiciona uma camada extra de verificação para garantir que o processo esteja sendo executado conforme o esperado. Então, se seu processo de automação depende da execução correta de certas etapas, você provavelmente deseja verificar a execução. Essa funcionalidade pode ser habilitada nas Configurações do projeto ou no corpo da atividade, selecionando Adicionar verificação.

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.

• Tipo de clique — consulte Tipo de clique no painel Designer.

• Tipo de movimento do cursor - Especifica o tipo de movimento executado pelo cursor do mouse. Há duas opções disponíveis:

  • Instantâneo - O cursor salta para o destino. Esse é o valor padrão.
  • Suave - O cursor se move em incrementos. A configuração tem efeito apenas se o modo de entrada de eventos de hardware for usado.

• Botão do mouse - Consulte Botão do mouse no painel Designer.

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

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

• Verificar execução — No runtime, verifica se a ação executada pela atividade estava correta. Isso é feito indicando um elemento que deve aparecer ou desaparecer após a ação ser executada, o que é monitorado e verificado após a atividade ser executada. Essa funcionalidade pode ser habilitado nas Configurações do projeto ou no corpo da atividade, selecionando Adicionar verificação a partir do menu de contexto.

  • Nome de exibição - O nome de exibição da ação de verificação. Esse campo é preenchido automaticamente com base na ação de verificação e o elemento que você escolheu. Depois que a execução de Verificação estiver configurada, esse nome de exibição ficará visível no cartão da atividade.
  • Tentar novamente – Quando selecionada, a ação é repetida no tempo limite da atividade caso o resultado esperado não seja alcançado. Por padrão, essa caixa de seleção fica marcada.
  • Destino — esse destino é usado para indicar o elemento que você deseja verificar no runtime. Para obter mais informações sobre os campos de propriedades que podem ser expandidos sob essa propriedade, consulte a propriedade Destino acima, pois a funcionalidade das propriedades é a mesma.
  • Tempo limite - A quantidade de tempo (em segundos) de espera para que o elemento de verificação apareça, desapareça ou mude. Se a caixa de seleção Tentar novamente for selecionada, a ação será realizada novamente, assim como a verificação, na duração especificada na propriedade Timeout da atividade. O valor padrão é de 10 segundos.

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

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

• Ativar – Leva ao primeiro plano o elemento de interface gráfica e o ativa antes de clicar nele. Este campo só aceita valores booleanos (True, False). O valor padrão é True.

• Alterar elemento desabilitado - Se estiver selecionado, a atividade executa a ação mesmo se o elemento de interface gráfica especificado esteja desabilitado. Este campo aceita apenas valores Boolean (True, False). O valor padrão é False.

Essa propriedade não se aplica se a propriedade Modo de entrada estiver definida como Eventos de hardware.

• 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 .
• Entrada de desbloqueio - Deve ser usada quando a ação de clique disparar uma caixa de diálogo modal ou qualquer outro elemento de interface gráfica que bloqueia a interação adicional. Funciona apenas junto com o método de entrada Simular . Este campo aceita apenas valores Boolean (True, False).
• 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 .
  • 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. Simular só pode ser usado com o tipo de clique único e as opções do botão esquerdo do mouse.
  • 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. Quando o navegador é iniciado com ChromiumAPI, uma faixa aparece informando que o navegador foi iniciado no modo de depuração. Esta mensagem não aparece se a extensão for instalada por meio de política.
  • 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.
• Modificadores de tecla — Adicione um ou mais modificadores de tecla a serem usados na combinação com a ação da atividade. As seguintes opções estão disponíveis: None, Alt, Ctrl, Shift e Win. A opção padrão é None. Os modificadores de teclas não podem ser usados com o modo de entrada Simular .