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.

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

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.

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

  • Indicar destino na tela — indique o destino novamente.
  • 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.
  • 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.

• Tipo de clique - Selecione no menu suspenso o tipo de clique a ser executado: Único, Duplo, Baixoou Cima. O padrão é Single.

• Botão do mouse - Selecione no menu suspenso o botão do mouse com o qual clicar: Esquerdo, Meioou Direito. A opção padrão é Esquerdo.
• 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. Esse recurso pode ser habilitado 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 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

• Tipo de clique - Consulte Tipo de clique no painel do Designer.

• Tipo de movimento do cursor — Especifica o tipo de movimento realizado 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 só funciona se o modo de entrada Eventos de hardware for usado.
• Botão do mouse - Consulte Botão do mouse no painel do Designer.
• 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.
  • 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 .
  • 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.

• 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 daexibição — o nome da exibição das Actionsde verificação Esse campo é preenchido automaticamente com base nas Actions de verificação e no elemento que você escolheu. Após a verificação de execução ser configurada, esse nome de exibição ficará visível no cartão de atividades.
  • Tentar novamente - Quando selecionada, as Actions são repetidas 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 propriedade que podem ser expandidos nesta propriedade, consulte a propriedade Destino acima, pois a funcionalidade das propriedades é a mesma.
  • Tempo limite — 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, as Actions realizadas novamente, seguidas pela verificação, na duração especificada na propriedade Tempo limite da atividade. O valor padrão é de 10 segundos.

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

• Ativar - Traz o elemento de interface gráfica para o primeiro plano 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 selecionada, a atividade executa as Actions mesmo se o elemento de interface gráfica especificado estiver desabilitado. Este campo só aceita Boolean valores (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 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 .

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

    Simular só pode ser usado com o tipo 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 via política.

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

• Modificadores de tecla — adicione um ou mais modificadores de teclas a serem usados em combinação com as Actions da atividade. As seguintes opções estão disponíveis: Nenhum, Alt, Ctrl, Shifte Win. A opção padrão é Nenhum.

  Os modificadores de tecla não podem ser usados com o modo de entrada Simular .

Configuração multiplataforma

• Trabalho em escopo — escolha a guia do navegador renderizando o aplicativo da Web para automatizar.

• Indicar destino na tela — indique o elemento de interface gráfica a ser usado como destino.

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

  • Indicar destino na tela — indique o destino novamente.
  • Editar destino – Abra o modo de seleção para configurar o destino.

Opções adicionais

Horários

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

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

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

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

Opções

• Tipo de clique - Selecione no menu suspenso o tipo de clique a ser executado: Único, Duplo, Baixoou Cima. O padrão é Single.
• Botão do mouse - Selecione no menu suspenso o botão do mouse com o qual clicar: Esquerdo, Meioou Direito. A opção padrão é Esquerdo.
• Modificadores de tecla - Adicione um ou mais modificadores de teclas a serem usados em combinação com o clique. As seguintes opções estão disponíveis: Alt, Ctrl, Shifte Win.

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

  • Igual ao Navegador — use a configuração do modo de entrada da atividade pai Use Browser .
  • 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.
  • Simulate - Simulates the click using accessibility APIs. Works for browsers. Sends all text in one go. This input method works in the background (even if the target app is not in focus).

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.