Solução de problemas da extensão do Edge

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:

• 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. Certifique-se de que a extensão esteja instalada e habilitada, conforme explicado aqui.
3. Se a extensão tiver sido instalada corretamente, mas não aparecer no Microsoft Edge, verifique se existem políticas de grupo que afetam a extensão, conforme explicado aqui.

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:

   • Verifique se a extensão está instalada. Para obter mais informações sobre como instalá-la, consulte a página de documentação.
   • Verifique se há Políticas de Grupo que afetam a ChromeNativeMessaging.exe. Consulte a página de documentação para obter mais informações.
   • Verifique se a variável de ambiente ComSpec está definida corretamente.

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. Certifique-se de que as opções Permitir em InPrivate e Permitir acesso a URLs de arquivo estejam selecionadas.
   
   

   

   
   

Multiple browser profiles

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

A extensão da UiPath para o Microsoft Edge não oferece suporte à automação de várias instâncias do navegador que executam vários perfis de usuário ao mesmo tempo. Portanto, a automação do navegador exige que você feche todas as instâncias ativas do Microsoft Edge e reinicie o navegador usando um único perfil de usuário.

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.

Recomendamos fechar o Microsoft Edge clicando com o botão direito do mouse no ícone do Microsoft Edge na bandeja do sistema e selecionando Fechar o Microsoft Edge. Isso garante que nenhum outro perfil de usuário permaneça em uso em segundo plano.

Conflito de políticas de grupo

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

Isso pode causar um conflito se o ExtensionInstallForcelist também estiver definido ao 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, consulte 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. Instale a extensão UiPath para Edge usando o método de instalação NativeHostOnly.

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.

Para usar esse método de instalação, adicione EDGE_INSTALL_TYPE=NativeHostOnly ao comando de instalação para o UiPathStudio.msi.

Exemplo:

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

2. Na política ExtensionInstallForcelist, adicione o valor:

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

3. Na política NativeMessagingAllowlist, adicione o valor:

com.uipath.chromenativemsg_v2

4. Defina a Política de Grupo DeveloperToolsAvailability com o valor 1 (permitir o uso das Ferramentas de Desenvolvedor).

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.

Isso foi relatado como um bug do Chromium aqui: https://bugs.chromium.org/p/chromium/issues/detail?id=1299742 Esse problema é bastante raro, pois poucos elementos de HTML têm manipuladores de clique com esta forma.

Soluções alternativas

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

1. Identifique a atividade Click com falha no seu fluxo de trabalho e altere o método de entrada de Simular para qualquer outro (API do Chromium, Eventos de Hardware, Mensagens em Janela).
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

Se a extensão da UiPath para o Edge for instalada usando a política de grupo, então a DeveloperToolsAvailability deve ser definida como 1 para habilitar a funcionalidade completa da extensão.

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 configurado para 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 configurado para 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:

Não é possível se comunicar com a plataforma UiPath A parte nativa da extensão não está configurada corretamente.

Reinstale a extensão a partir do UiPath Studio.

Consulte Verificar se o ChromeNativeMessaging.exe está em execução.

A atividade Inject Js Script não pode mais ser usada para acessar variáveis e código de página

Por padrão, a atividade Inject Js Script não pode mais ser usada para acessar variáveis de página, como jQuery $, ou para interagir com o código de páginas (por exemplo, window.alert). A atividade Inject Js Script não informará sobre nenhum erro, mas a execução do script falhará e o seguinte erro será gerado no navegador 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.

Seu código JavaScript existente não requer nenhuma alteração e, usando a opção Mundo de execução — Página, ele funcionará para extensões MV2 e MV3.

A atividade Open Browser tem um tempo limite insuficiente

Para extensões MV3, o navegador carrega a extensão mais tarde, após as páginas da Web terem sido carregadas. Isso significa que em máquinas mais lentas, a atividade Open Browser pode atingir o tempo limite interno de 60 segundos antes que a extensão seja iniciada.

Iniciando com o UiPath.UiAutomation.Activities v22.10.6, o tempo limite interno para a atividade Open Browser pode ser configurado por meio da variável de ambiente UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS . Por exemplo, defina UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120 para usar 120 segundos para o tempo limite da atividade.