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

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: você precisa usar pelo menos o Google Chrome versão 64 para realizar as automações do navegador.

Check if the Extension for Chrome is installed and enabled

1. No Google Chrome, navegue até chrome://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 Chrome, verifique se existem políticas de grupo que afetam a extensão, conforme explicado aqui.
   

   Observação: selecionando a caixa Modo de Desenvolvedor no topo da página chrome://extensions/ exibe o botão Atualizar na página de Detalhes da extensão.

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

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:

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

Caso as informações acima não resolvam seu problema, você pode tentar buscar informações adicionais visualizando traces e analisando os erros gerados pela extensão UiPath. A seguir estão os tipos de rastreamentos que você pode coletar e analisar: Habilitando rastreamentos.

Habilitação de Traces

Traces de Extensão Geral no Google Chrome

1. No Google Chrome, vá para chrome://extensions/.
2. Selecione a caixa de seleção Modo do Desenvolvedor na parte superior da página da Web.
3. Vá para a extensão da UiPath e clique na página de fundo. A página Ferramentas do Desenvolvedor é exibida.
4. Navegue até a aba Console. Todos os traces gerados pela extensão são exibidos aqui.
   Observação: erros são marcados em vermelho.

Traces Gerados pela Página Web que você Deseja Automatizar

1. Na página web que você deseja automatizar, vá para Barra de Navegação Lateral > Mais ferramentas > Ferramentas do desenvolvedor (ou pressione Ctrl+Shift+I). Os traces gerados pela extensão UiPath para a página atual são exibidos.
   Observação: erros são marcados em vermelho.

Traces completos

1. Abra o Editor do Registro.
2. Navegue até a chave HKEY_CURRENT_USER\SOFTWARE\UiPath.
3. Clique duas vezes no valor WebExtensionTrace DWORD. A janela Editar valor DWORD será exibida.
4. No campo Dados de Valor, altere o valor para 1, e clique em OK. O valor será salvo.
   Observação: se o valor DWORD WebExtensionTrace não existir, você deverá criá-lo clicando com o botão direito do mouse no painel direito, selecionando Novo > Valor DWORD (32-bit) e fornecendo os valores mencionados acima.

   Se a extensão para o Chrome ainda não estiver em funcionamento, remova a extensão a partir de chrome://extensions/ e reinstale-a.

Check if ComSpec variable is defined correctly

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.

A solução é adicionar manualmente o valor correto para a variável de ambiente ComSpec.

Essa variável é definida na instalação do Windows e deve ter o valor %SystemRoot%\system32\cmd.exe.

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. Navegue até a extensão UiPath Web Automation e clique no botão Detalhes. A página de detalhes da UiPath Web Automation é exibida.
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.

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çã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

Se a extensão UiPath para o Chrome 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 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 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 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 do UiPath.UiAutomation.Activities versão 20.10 ou anterior pode atingir o tempo limite interno de 20 segundos antes da extensão ser iniciada.

A partir da versão 20.10.13, o tempo limite interno para a atividade Open Browser foi aumentado de 20 segundo para 60 segundos.

Além disso, você pode configurar o tempo limite 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.