Solução de problemas

Esta página traz os motivos mais frequentes para que a extensão do UiPath para o Chrome não poderia funcionar devidamente e como solucionar esses problemas.

Observe que as automações de navegador com a extensão para o Chrome atualmente são possíveis em uma única janela do Chrome.

Observação:

Para executar as automações do navegador você precisa usar pelo menos a versão do Google Chrome 64.

Check if the Extension for Chrome is installed and enabled

1. No Google Chrome, navegue até chrome://extensions/.

2. Make sure the extension is installed and enabled, as explained here.

3. If the extension was installed correctly but does not appear in Chrome, check if there are Group Policies that affect the extension, as explained here.

   

   Observação:

   Selecting the Developer mode check box at the top of the chrome://extensions/ page displays the Update button on the extension Details page.

Check if ChromeNativeMessaging.exe is running

O ChromeNativeMessaging.exe habilita a comunicação entre a extensão UiPath para Chrome e o UiPath Studio/Robot.

1. Abra o Chrome.

2. Abra o Gerenciador de Tarefas.

3. Verifique se o processo ChromeNativeMessaging.exe está em execução.

   

4. Se o processo não estiver em execução:

• Make sure the extension is installed. For more information, check the installation methods described in the Extension for Chrome page.
• Check if there are Group Policies affecting ChromeNativeMessaging.exe. See Group Policies for more information.
• Check if ComSpec variable is defined correctly.

Check if ComSpec variable is defined correctly

Description

O processo ChromeNativeMessaging.exe é executado no usuário atual e utiliza cmd.exe para iniciar o navegador.

Se a variável de ambiente ComSpec estiver ausente ou tiver um valor inválido, o Google Chrome não poderá iniciar o ChromeNativeMessaging.exe.

Além disso, o administrador pode desabilitar o prompt de comando para alguns usuários ou configurá-lo para sempre ser executado com privilégios elevados.

Solução

Adicione manualmente o valor correto para a variável de ambiente ComSpec. Essa variável é definida na instalação do Windows e deve ser definida como: %SystemRoot%\system32\cmd.exe.

Outras soluções alternativas

Se a variável de ambiente ComSpec for definida corretamente, mas o problema persistir, é possível que o usuário não tenha permissão para executar o prompt de comando. Nesse caso, o processo ChromeNativeMessaging.exe não pode ser iniciado com cmd.exe sendo executado sob o usuário atual.

Starting with Chromium 120.0.6090+, a NativeHostsExecutablesLaunchDirectlyGroup Policy allows admins to turn this on for users in restricted environments (Cloud PCs that forbid cmd.exe, for example).

Habilite o Acesso às URLs do arquivo e o Modo Anônimo

Por padrão, a extensão não tem permissão de acesso aos URLs do arquivo ou ao Modo Anônimo. Para habilitar esses acessos:

1. No Google Chrome, navegue até chrome://extensions/. A página de Extensões do Chrome será exibida.

2. Navigate to the UiPath Web Automation extension and click the Details button. The UiPath Web Automation details page is displayed.

3. Certifique-se de que as opções Permitir modo incógnito e Permitir o acesso aos URLs de arquivo estejam selecionadas.

   

Multiple browser profiles

Várias instâncias do Chrome com vários perfis de usuário

A extensão do UiPath para o Chrome não é oferece suporte à automação de várias instâncias do navegador que executam vários perfis de usuário ao mesmo tempo. Desse modo, a automação do navegador precisa que você feche todas as instâncias ativa do Chrome e o reinicie usando um único perfil de usuário.

Como interromper todas as instâncias do Chrome

Em alguns casos, os processos em segundo plano do Chrome impedem que ele seja totalmente encerrado. Isso interfere nas automações, ainda que a instância do navegador não estiver visível.

Recomendamos o encerramento do Chrome, clicando-se com o botão direito do mouse no ícone do Chrome que fica na Bandeja do Sistema e selecionando Sair. Isso garante que nenhum outro perfil de usuário permaneça em uso em segundo plano.

Problemas conhecidos para extensões MV3

A atividade de clique com simulação falha em elementos específicos da página da web

A atividade Click com o método de Simulateentrada não funciona mais em elementos HTML que possuem um manipulador de clique com javascript:URI.

Neste caso, o clique simulado não terá efeito e nenhum erro será reportado.

This was reported as a Chromium bug here: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 This issue is quite rare as very few HTML elements have click handlers in this form.

Solução alternativa

Altere o método de entrada para a atividade Click com falha de Simulatepara qualquer outro método de entrada:

• API do Chromium
• Eventos de Hardware
• Mensagens na Janela

O valor da política de grupo DeveloperToolsAvailability deve ser definido como 1

O DeveloperToolsAvailability tem os seguintes valores possíveis:

• 0 = Proibir o uso das Ferramentas do Desenvolvedor em extensões instaladas pela política corporativa, permitir o uso das Ferramentas do Desenvolvedor em outros contextos
• 1 = Permitir o uso das Ferramentas do Desenvolvedor
• 2 = Proibir o uso das ferramentas do desenvolvedor

If the UiPath Extension for Chrome is installed using Group Policy, then the DeveloperToolsAvailability must be set to 1 to enable the full functionality of the extension.

Este valor é definido corretamente automaticamente quando a extensão é instalada, mas ele será substituído se o administrador do sistema tiver definido outro valor para esta política.

Os outros valores para DeveloperToolsAvailability causam os problemas listados abaixo.

Se DeveloperToolsAvailability estiver definido como 0 então:

• A extensão UiPath para Chrome v22.4 não funcionará com essa restrição. Considere atualizar para a v22.10 da extensão disponível com UiPathStudio.msi 2022.4.4.
• A extensão UiPath para Chrome v22.10 estará restrita a trabalhar com versões LTS do UiAutomation (19.10.x,20.10.x, 21.10.x, 22.4.x)
• A atividade InjectJS não funcionará.

Se DeveloperToolsAvailability estiver definido como 2 então:

• Todas as limitações de DeveloperToolsAvailability=0 se aplicam
• O método de entrada ChromiumAPI não funcionará.

A janela do navegador UiPath Web Automation mostra um aviso

Se ChromeNativeMessaging.exe não puder ser iniciado, a janela do navegador UiPath Web Automation mostra o seguinte aviso:

Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

Reinstale a extensão a partir do UiPath Studio.

See Check if ChromeNativeMessaging.exe is running.

A atividade Open Browser tem um tempo limite insuficiente

For MV3 extensions, the browser loads the extension later, after the web pages have loaded. This means that on slower machines, the Open Browser activity can reach the internal timeout of 60 seconds before the extension has started.

Starting with UiPath.UiAutomation.Activities v22.4.10, the internal timeout for the Open Browser activity can be configured through the UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS environment variable. For example, set UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 to use 120 seconds for the activity's timeout.