Configurações de projeto de automação de interface gráfica

Essas configurações de projeto se aplicam a atividades modernas em projetos multiplataforma.

Use as Configurações do Projeto para configurar alterações no nível do projeto. Essas configurações globais afetam todas as atividades no pacote que têm as propriedades listadas abaixo. Para obter mais informações, consulte Definindo as configurações de projeto de atividades.

Importante:

As propriedades definidas nas Configurações do Projeto só terão efeito nas atividades do fluxo de trabalho caso suas propriedades não tenham sido editadas. A edição manual das propriedades não aplica mais as Configurações do Projeto a elas.

Para configurar as configurações do projeto de Automação de Interface Gráfica , siga estas etapas:

1. No painel Projeto, acesse Configurações do Projeto
2. Navegue até Configurações de Atividades > Automação de interface gráfica.
3. Modifique as configurações de acordo com o que você deseja alterar.
4. Clique em OK para salvar as alterações.

Você pode redefinir todas as configurações para seus valores padrão ou copiar todos os valores entre os campos de depuração e produção utilizando o menu suspenso Ação em Massa na parte superior da janela.

Genérico

As configurações abaixo se aplicam a atividades de Automação de Interface Gráfica Moderna em projetos multiplataforma que têm uma das seguintes propriedades.

Nome da propriedade	Description
Atraso após (segundos)	Tempo de espera entre a atividade atual e a atividade seguinte.
Atraso antes (segundos)	Tempo de espera entre a atividade anterior e a atividade atual.
Tempo Limite (segundos)	Período que se deve esperar pela execução da atividade antes de gerar um erro.
Aguardar carregamento da página	Antes de executar a ação, espere o aplicativo ficar pronto para aceitar a entrada. As seguintes opções estão disponíveis: 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.
Fazer captura de tela	Determina se as capturas de tela são capturadas por todas as atividades compatíveis com esse recurso. Se a configuração estiver definida como False, a opção Remover captura de tela informativa do menu de contexto estará desabilitada.
Alterar elemento desabilitado	Se definido como Verdadeiro, a ação Selecionar item é executada mesmo que o elemento de interface gráfica especificado esteja desabilitado.Essa propriedade não se aplica se a propriedade Modo de entrada estiver definida como Eventos de hardware.
Aguarde o método de segmentação principal até o tempo limite	Se a configuração é definida como True , essa configuração permitirá que o método de segmentação primário consuma todo o seu tempo limite até que qualquer método de segmentação de fallback possa ser usado.
Habilitar automação Java (prévia)	Se definido como True, você pode indicar aplicativos Java. Se definido como False, você pode indicar apenas janelas do navegador Chrome.
Adicionar automaticamente elementos de interface gráfica ao Repositório de Objetos	Se definido como True, todos os elementos de interface gráfica serão adicionados automaticamente ao Repositório de Objetos.

Métodos de segmentação - navegadores da Web

As configurações abaixo se aplicam às metas e âncoras indicadas para aplicativos da web.

Nome da propriedade	Description
Modo de entrada para Edge, Chrome	Selecione como executar a ação: Simular - Simula o clique usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware . 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. ChromiumAPI - Executa ações usando APIs do depurador. Funciona apenas para 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 a página da API do Chromium . Observação: quando o navegador é iniciado com o ChromiumAPI, aparece uma faixa informando que o navegador foi iniciado no modo de depuração. Esta mensagem não aparece se a extensão estiver instalada por meio da política.
Seletor - tipo de localização padrão	Selecione o tipo padrão de localização usado pelo seletor de elementos de interface gráfica. As seguintes opções estão disponíveis: Desabilitado - Não usa o método de segmentação Seletor para encontrar o elemento de interface gráfica. Uma correspondência - Usa uma abordagem de correspondência exata. Esse método garante a identificação precisa dos elementos, mas pode falhar se esses atributos forem alterados dinamicamente ou se a interface do usuário não tiver identificadores estáveis. Todas as correspondências - produz intencionalmente várias correspondências. Ele é projetado para ser sempre usado com âncoras para refinar a seleção, tornando-o mais resiliente a pequenas alterações na interface gráfica, garantindo a precisão contextual. Automático - Escolhe automaticamente o tipo de localização mais adequado do seletor de elementos de interface gráfica: Uma correspondência ou Todas as correspondências . O valor padrão é Todas as correspondências .
Computer Vision	Se definido como True, usa o método Computer Vision . O valor padrão é False. Observação: o valor padrão desta configuração do projeto era True nos projetos do Studio criados com versões de dependência do UiPath.UIAutomation.Activities anteriores a 25.10.27, 24.10.17 ou 23.10.20.
Ignorar seletores com IDX/tableRow/tableCol	Desabilite o seletor completo se o seletor de destino tiver um atributo tableRow , tableCol ou idx com um valor maior que 1 e houver âncoras.

Métodos de segmentação - SAP

As configurações abaixo se aplicam às metas e âncoras indicadas para o SAP.

Nome da propriedade	Description
Modo de entrada	Simular - Simula o clique usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware . 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.
Seletor - tipo de localização padrão	Selecione o tipo padrão de localização usado pelo seletor de elementos de interface gráfica. As seguintes opções estão disponíveis: Desabilitado - Não usa o método de segmentação Seletor para encontrar o elemento de interface gráfica. Uma correspondência - Usa uma abordagem de correspondência exata. Esse método garante a identificação precisa dos elementos, mas pode falhar se esses atributos forem alterados dinamicamente ou se a interface do usuário não tiver identificadores estáveis. Todas as correspondências - produz intencionalmente várias correspondências. Ele é projetado para ser sempre usado com âncoras para refinar a seleção, tornando-o mais resiliente a pequenas alterações na interface gráfica, garantindo a precisão contextual. Automático - Escolhe automaticamente o tipo de localização mais adequado do seletor de elementos de interface gráfica: Uma correspondência ou Todas as correspondências . O valor padrão é Uma correspondência .
Computer Vision	Se definido como True, usa o método Computer Vision . O valor padrão é False.
Ignorar seletores com IDX/tableRow/tableCol	Desabilite o seletor completo se o seletor de destino tiver um atributo tableRow , tableCol ou idx com um valor maior que 1 e houver âncoras.

Métodos de segmentação - Java

As configurações abaixo se aplicam às metas e âncoras indicadas para aplicativos Java.

Nome da propriedade	Description
Modo de entrada	Simular - Simula o clique usando APIs de acessibilidade. Recomendado na automação do navegador, aplicativos Java ou SAP. Mais confiável que Eventos de hardware . 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.
Seletor - tipo de localização padrão	Selecione o tipo padrão de localização usado pelo seletor de elementos de interface gráfica. As seguintes opções estão disponíveis: Desabilitado - Não usa o método de segmentação Seletor para encontrar o elemento de interface gráfica. Uma correspondência - Usa uma abordagem de correspondência exata. Esse método garante a identificação precisa dos elementos, mas pode falhar se esses atributos forem alterados dinamicamente ou se a interface do usuário não tiver identificadores estáveis. Todas as correspondências - produz intencionalmente várias correspondências. Ele é projetado para ser sempre usado com âncoras para refinar a seleção, tornando-o mais resiliente a pequenas alterações na interface gráfica, garantindo a precisão contextual. Automático - Escolhe automaticamente o tipo de localização mais adequado do seletor de elementos de interface gráfica: Uma correspondência ou Todas as correspondências . O valor padrão é Uma correspondência .
Computer Vision	Se definido como True, usa o método Computer Vision . O valor padrão é False. Observação: o valor padrão desta configuração do projeto era True nos projetos do Studio criados com versões de dependência do UiPath.UIAutomation.Activities anteriores a 25.10.27, 24.10.17 ou 23.10.20.
Ignorar seletores com IDX/tableRow/tableCol	Desabilite o seletor completo se o seletor de destino tiver um atributo tableRow , tableCol ou idx com um valor maior que 1 e houver âncoras.

Aplicativo/Navegador

As configurações abaixo se aplicam à atividade Use Application/Browser. As configurações alteradas aqui passarão a valer no Runtime se a Propriedade correspondente for deixada em branco na atividade.

Nome da propriedade	Description
Abrir	Define se abre o aplicativo de destino antes de executar atividades nele. As seguintes opções estão disponíveis: Nunca — inicie/abra uma nova instância do aplicativo ou janela do navegador. Se não estiver aberto - Abre uma nova instância do aplicativo ou janela do navegador se o seletor não corresponder a nenhuma instância existente. Sempre – Sempre abra uma nova instância do aplicativo ou janela do navegador. Ao abrir uma nova instância, o caminho do arquivo e os argumentos são usados para iniciar o aplicativo.
Fechar	Em que casos fechar o aplicativo de destino depois de executar atividades nele. As seguintes opções estão disponíveis: Nunca - Não feche a instância do aplicativo ou a janela do navegador após executar as atividades no escopo, mesmo que tenha sido aberta pela atividade Use Application/Browser. Se aberta pelo aplicativo/navegador — feche a instância do aplicativo ou a janela do navegador apenas se ela tiver sido aberta pela atividade Use Application/Browser. Sempre — sempre feche a instância do aplicativo ou a janela do navegador após executar as atividades no escopo.
Modo de anexação de janela	Especifica o modo padrão de anexação de janela usado pelas atividades Use Application/Browser recém-adicionadas. As seguintes opções estão disponíveis: Instância do aplicativo — as atividades internas pesquisarão na instância do aplicativo indicada, incluindo todas as janelas pai e filho (alertas, pop-ups, etc.). Outras instâncias do aplicativo são excluídas. Janela única — as atividades internas pesquisarão apenas na janela indicada.
Modo da pasta de dados do usuário	O modo da pasta de dados do usuário que você deseja definir. É usado para iniciar o navegador com uma pasta de dados do usuário específica. Automático : o modo Picture In Picture usa uma pasta diferente do modo padrão, gerada automaticamente se o Caminho da pasta de dados do usuário não estiver definido. Pasta padrão - Usa a pasta do navegador padrão, independentemente de ser executada na sessão principal ou PIP. Pasta personalizada - Usa a pasta especificada no Caminho da pasta de dados do usuário ou um caminho gerado automaticamente se o Caminho da pasta de dados do usuário não estiver definido.
Caminho da pasta de dados do usuário	O caminho para a pasta de dados do usuário que o navegador usa.
Abrir tempo limite do navegador (segundos)	Configure o tempo limite de inicialização do navegador.
Ignorar alertas	Habilite o encerramento automático de caixas de diálogo de alerta do JavaScript.
Ignorar Confirmações	Habilite o encerramento automático de caixas de diálogo de confirmação do JavaScript.
Ignorar Prompts	Habilite o encerramento automático de caixas de diálogo de prompt do JavaScript.
Confirmar resposta da caixa de diálogo	Defina a resposta como caixa de diálogo de confirmação do JavaScript: Cancelar ou OK .
Solicitar resposta da caixa de diálogo	Defina a resposta às caixas de diálogo de prompt do JavaScript: Cancelar ou OK .
Texto de resposta do prompt Habilitar encerramento automático de caixas de diálogo de alerta do JavaScript.	Define a resposta de texto para caixas de diálogo de solicitação de JavaScript.

Eventos do Teclado

As configurações abaixo se aplicam às atividades Type Into e Keyboard Shortcuts .

Nome da propriedade	Description
Type Into - Clique antes de digitar	Se deve clicar no elemento de interface do usuário especificado antes de digitar o texto e o tipo de clique a ser executado. As seguintes opções estão disponíveis: Nenhum Único Double
Type Into - Campo vazio	Se o conteúdo existente deve ser excluído antes de digitar o texto e como limpar o campo. As seguintes opções estão disponíveis: Nenhum Linha única [End, Shift+Home, Del] Linha múltipla [Ctrl+A, Del]
Type Into – área de transferência	Indica se a área de transferência é usada para digitar o texto fornecido. As seguintes opções estão disponíveis: Nunca – Nunca usar a área de transferência. Sempre – Sempre usar a área de transferência. Sempre que possível – Use a área de transferência quando possível. Isso depende do sistema operacional e do texto a ser digitado (por exemplo, se qualquer tecla especial for usada, a área de transferência não será usada).
Atalhos do teclado - Atraso entre atalhos (segundos)	Tempo de espera entre pressionamentos consecutivos de teclas especiais.

SAP

Aplica-se a qualquer atividade de Automação de Interface Gráfica durante a automação do SAP.

Nome da propriedade	Description
Aplique o limite de tempo do hardware (apenas para SAP WinGUI e GUI para Java)	Aplica um tempo limite rígido para todas as atividades que realizam o SAP WinGUI ou o SAP GUI para automação Java.

ScreenPlay

As configurações abaixo se aplicam à atividade Screenplay . As configurações alteradas aqui passarão a valer no Runtime se a propriedade correspondente for deixada em branco na atividade.

Nome da propriedade	Description
Modelo	Indica o LLM subjacente usado pelo ScreenPlay para planejamento e raciocínio de execução de tarefas. As seguintes opções estão disponíveis: UiPath Screen Agent (com Gemini 2.5 Flash) Modelo básico Funciona melhor em navegadores Usa uma implementação proprietária baseada no DOM da página, usando o Gemini Flash para o raciocínio e compreensão de imagens É moderadamente rápido UiPath Screen Agent (com GPT-4.1) Modelo padrão - para tarefas complexas Funciona melhor em navegadores Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-4.1 para o raciocínio Não é muito rápido UiPath Screen Agent (com GPT-4.1 mini) Modelo básico - mais rápido, mais barato Funciona melhor em navegadores Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-4.1 mini para o raciocínio É moderadamente rápido UiPath Screen Agent (com GPT-5) Modelo padrão - para tarefas complexas Funciona melhor em navegadores Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando GPT-5 para raciocínio Lenta UiPath Screen Agent (com GPT-5 mini) Modelo básico - mais rápido, mais barato Funciona melhor em navegadores Usa uma implementação proprietária baseada no DOM da página e na compreensão de imagens, usando o GPT-5 mini para o raciocínio É moderadamente rápido OpenAI - Operator Modelo padrão - para tarefas complexas Funciona em qualquer tipo de aplicativo, incluindo interfaces baseadas em imagens Usa o OpenAI Operator, um modelo de raciocínio baseado em imagens. Deve ser a melhor do grupo Lenta Anthropic - Computer Use Modelo padrão - para tarefas complexas Funciona em qualquer tipo de aplicativo, incluindo interfaces baseadas em imagens Usa Anthropic Computer Use, um modelo de raciocínio baseado em imagens Lenta
Digitar pela área de transferência	Indica se a área de transferência é usada para digitar o texto fornecido. As seguintes opções estão disponíveis: Nunca - usar a área de transferência Sempre - Sempre usar a área de transferência Sempre que possível — use a área de transferência quando possível. Isso depende do sistema operacional e do texto a ser digitado (por exemplo Se alguma tecla especial for usada, a área de transferência não será usada)
Número máximo de etapas	O número máximo de etapas que o Screenplay pode seguir para atingir o objetivo dele.
Usar DOM quando disponível	Indica se os dados do DOM serão usados/enviados para o modelo LLM de aplicativos em que o DOM pode ser extraído. O DOM pode ser usado somente por implementações LAM da UiPath. Desabilite se a segmentação baseada em DOM levar a coordenadas de elemento incorretas.
Geração de logs	Especifica em qual nível os logs gerados pela atividade do ScreenPlay são armazenados. As seguintes opções estão disponíveis: Desativado Informações Trace
Habilitar arquivos de trace	Especifica o tipo de arquivos de trace gerados pela atividade ScreenPlay. As seguintes opções estão disponíveis: Desabilitado – Nenhum arquivo de rastreamento será salvo/armazenado. Html – Arquivos de rastreamento HTML serão salvos/armazenados. Html e json - Os arquivos de rastreamento HTML e json principal serão salvos armazenados. Completo - Os arquivos de rastreamento HTML, json principal e json de iteração serão salvos/armazenados.
Retenção de arquivos de trace (dias)	Número de dias para reter os traces antes da exclusão. Defina como 0 para manter os traces indefinidamente.

Outras Atividades

As configurações abaixo se aplicam às atividades Check App State, Extract Table Data, Highlight, Hover, Inject Js Script, Close Popup e SAP Logon.

Nome da propriedade	Description
Verifique o estado do aplicativo - Tempo limite (segundos)	Quanto tempo esperar para que o elemento de destino apareça ou desapareça.
Extrair dados da tabela - Atraso entre as páginas (segundos)	Se os dados abrangerem várias páginas, quanto tempo esperar para que cada página seja carregada.
Destaque - Duração (segundos)	Quanto tempo para destacar o elemento de destino.
Passe o mouse - Duração (segundos)	Por quanto tempo passar o mouse sobre o elemento de destino.
Injetar script Js - mundo de execução	Aplica a configuração InjectJs.ExecutionWorld globalmente. Para obter detalhes, consulte a atividade Inject Js Script .
Fechar Pop-up - Tempo Limite de Aparecimento do Pop-up	O tempo (em segundos) de espera para que um pop-up apareça.

Registro em Log do Robot

Informações sobre os métodos usados para identificar destinos e âncoras e o desempenho de cada método em tempo de execução podem ser salvos nos logs de execução do robô. As opções se aplicam a todas as atividades suportadas.

Nome da propriedade	Descrição da Propriedade	Atividades impactadas
Registrar em log etapas de pesquisa de âncora e destino	Especifica em que nível armazenamos os logs para os métodos usados para identificar destinos e âncoras. As seguintes opções estão disponíveis: Desativado Informações Trace	Check/Uncheck Check App State Click Extract Table Data Get Text Highlight Hover Keyboard Shortcuts Select Item Type Into
Registre os tempos dos métodos de segmentação	Especifica em que nível armazenamos os logs para o desempenho de cada método de segmentação. As seguintes opções estão disponíveis: Desativado Informações Trace	Check/Uncheck Check App State Click Extract Table Data Get Text Highlight Hover Keyboard Shortcuts Select Item Type Into
Registrar informações de auditoria	Especifica em que nível os logs gerados pela atividade Use Application/Browser são armazenados. As seguintes opções estão disponíveis: Desativado Informações Trace	Use Application/Browser