Click Toolbar Button

UiPath.UIAutomationNext.Activities.NSAPClickToolbarButton

Description

Clica em um botão das barras de ferramenta SAP do sistema ou aplicativo. Depois de indicar uma Barra de Ferramentas SAP na tela, a lista com todos os botões disponíveis é exibida na atividade.

Compatibilidade do projeto

Windows - Legacy | Windows | Multiplataforma

Configuração do Windows e multiplataforma

• Selecione 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.
  • 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.
• Botão da barra de ferramentas – Especifica o botão das barras de ferramentas SAP do sistema ou aplicativo. Após indicar a barra de ferramentas do SAP na tela, a lista com todos os botões disponíveis é apresentada na atividade.

Painel de Propriedades

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 seletor 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.
    • Texto do CV - 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 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.
• Sites responsivos — habilita o layout de sites responsivos.

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.

Opções

• Alterar elemento desabilitado - Quando selecionada, a atividade executa a ação mesmo se o elemento de destino estiver desabilitado. O valor padrão é False.
• Modo do Healing Agent (apenas multiplataforma) - configura o comportamento do Healing Agent para essa 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 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.

Entrada/Saída

• Elemento de entrada — o elemento de interface gráfica no qual a atividade é executada, armazenado em um objeto ElementoDaUI . Esse campo é compatível apenas com objetos ElementoDaUI . Esse objeto pode ser obtido do campo de propriedade Elemento de saída de outras atividades de Automação de interface gráfica.

Windows - Configuração legada

• Selecione 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.
  • 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.
• Botão da Barra de Ferramentas – Especifica o botão das barras de ferramentas SAP do sistema ou aplicativo. Após indicar a barra de ferramentas do SAP na tela, a lista com todos os botões disponíveis é apresentada na atividade.

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.
  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• 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 de exibição da 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.

• 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 - 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 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.
• Botão da Barra de Ferramentas – Especifica o botão das barras de ferramentas SAP do sistema ou aplicativo. Após indicar a barra de ferramentas do SAP na tela, a lista com todos os botões disponíveis é apresentada na atividade.

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

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

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