Solução de problemas

Esta página apresenta os motivos mais frequentes pelos quais a extensão do Edge pode não funcionar corretamente e como resolver esses problemas.

Consulte as seguintes páginas:

• Não é possível se comunicar com o navegador
• A extensão Edge é removida automaticamente
• A extensão pode ter sido corrompida
• Check if the Extension for Microsoft Edge is installed and enabled
• Check if ChromeNativeMessaging.exe is running
• Check if ComSpec variable is defined correctly
• Enable access to file URLs and InPrivate mode
• Multiple browser profiles
• Conflito de políticas de grupo
• Problemas conhecidos para extensões MV3

Check if the Extension for Microsoft Edge is installed and enabled

1. No Microsoft Edge, navegue para edge://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 Microsoft Edge, check if there are Group Policies that affect the extension, as explained here.

Check if ChromeNativeMessaging.exe is running

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

1. Abra o Microsoft Edge.

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 on how to install it, check the docs page.
   • Check if there are Group Policies affecting ChromeNativeMessaging.exe. See the docs page for more information.
   • Check if the ComSpec environment 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 Microsoft Edge 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.

A partir do Chromium 120.0.6090+, uma NativeHostsExecutablesLaunchDirectly Política de Grupo permite que os administradores ativem essa opção para usuários em ambientes restritos (Cloud PCs que proíbem cmd.exe, por exemplo).

Enable access to file URLs and InPrivate mode

Por padrão, a extensão não tem acesso a URLs de arquivo ou ao modo InPrivate. Para habilitar esses acessos:

1. No Microsoft Edge, navegue para edge://extensions/. A página de extensões do Microsoft Edge é exibida.

2. Navegue até a extensão UiPath Browser Automation e clique no botão Detalhes.

3. Make sure the Allow in InPrivate and Allow access to file URLs options are selected.

   

Multiple browser profiles

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

UiPath Extension for Microsoft Edge does not support automating multiple browser instances running with multiple user profiles at the same time. Therefore, browser automation requires you to close all active instances of Microsoft Edge and restart the browser using a single user profile.

Parando todas as instâncias do Microsoft Edge

Em alguns casos, os processos em segundo plano do Microsoft Edge impedem que ele feche completamente, o que interfere nas automações mesmo que a instância do navegador não esteja visível.

We recommend closing Microsoft Edge by right-clicking the Microsoft Edge icon in the System Tray, and selecting Close Microsoft Edge. This ensures that no other user profiles remain in use in the background.

Conflito de políticas de grupo

Ao instalar a extensão UiPath para Edge usando a Política de Grupo, o ExtensionInstallForcelist é atualizado no nível da máquina.

Isso pode causar um conflito se o ExtensionInstallForcelist também estiver definido no nível do usuário.

Como o nível de máquina tem prioridade, as extensões definidas ao nível de usuário/nuvem serão desinstaladas.

Para confirmar isso, verifique em edge://policy se esse aviso é exibido em ExtensionInstallForcelist:

More than one source with conflicting values is present for this policy!

Para solucionar esse conflito, siga estas etapas:

1. Install the UiPath extension for Edge using theNativeHostOnly installation method.

Esse método de instalação permitirá a comunicação entre a extensão e o UiPath Studio/Robot.

Ele não fará nenhuma alteração nas Políticas de Grupo.

To use this installation method add EDGE_INSTALL_TYPE=NativeHostOnly to the installation command for UiPathStudio.msi.

Exemplo:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,EdgeExtension EDGE_INSTALL_TYPE=NativeHostOnly

2. In the ExtensionInstallForcelist policy, add the value:

kcgmcmhhfbcacnlnopghneecffhelmhe;https://edge.microsoft.com/extensionwebstorebase/v1/crx

3. In the NativeMessagingAllowlist policy, add the value:

com.uipath.chromenativemsg_v2

4. Set DeveloperToolsAvailability Group Policy to the value1 (Allow usage of the Developer Tools).

Essa configuração é necessária para habilitar a funcionalidade de extensão completa.

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ções alternativas

Duas soluções alternativas estão disponíveis para esse problema:

1. Identify the failing Click activity in your workflow and change the input method from Simulate to any other input method (Chromium API, Hardware Events, Window Messages).
2. Atualize o pacote UiPath.UIAutomation.Activities para a v22.12 ou mais recente e use a opção Habilitar solução alternativa para simular clique com extensão MV3 nas Configurações do Projeto.

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 Edge 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 Edge 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 Inject Js Script não pode mais ser usada para acessar variáveis e código de página

By default, the Inject Js Script activity can no longer be used to access page variables, such as jQuery $ , or to interact with page code (e.g., window.alert). The Inject Js Script activity won't report an error, but the script will fail to execute and the following error will be reported in the browser DevTools (F12): Refused to execute inline script because it violates the following Content Security Policy directive.

Essa é uma limitação introduzida pela plataforma MV3.

Para corrigir esse problema, selecione a opção Mundo de execução — Página na atividade Inject Js Script.

Your existing JavaScript code doesn't require any changes, and by using the Execution world - Page option it will work for both MV2 and MV3 extensions.

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.10.6, 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.