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.

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:

• Verifique se a extensão está instalada. Para obter mais informações, consulte os métodos de instalação descritos na página Extensão para Chrome.
• Verifique se há Políticas de Grupo que afetam a ChromeNativeMessaging.exe. Consulte Políticas de grupo do Chrome para obter mais informações.
• Verifique se a variável 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 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 NativeHostsExecutablesLaunchDirectly Group 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. 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.

Group Policy conflict

Description

Ao instalar a extensão UiPath para Chrome 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 de usuário ou usando Políticas de Nuvem do Chrome.

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 chrome://policy se esse aviso é exibido em ExtensionInstallForcelist:

This policy is working as intended but a conflicting value is set elsewhere and is overridden by this policy.

Solução

Para solucionar esse conflito, siga estas etapas:

1. Instale a extensão UiPath para Chrome usando o método de instalação NativeHostOnly.

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

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

   Para usar esse método de instalação, adicione CHROME_INSTALL_TYPE=NativeHostOnly ao comando de instalação para o UiPathStudio.msi. Exemplo: UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,ChromeExtension CHROME_INSTALL_TYPE=NativeHostOnly.
2. Na política ExtensionInstallForcelist, adicione o valor:

   1. Para o método de instalação Política de grupo on-line (que instala a extensão Chrome Web Store):

      kmejkhcmhgilmppjodlgaklnmdmmhhcl;https://clients2.google.com/service/update2/crx

   2. Para o método de instalação Política de grupo offline (que instala a extensão auto-hospedada):

      ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml

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. Para obter mais informações sobre essa configuração, consulte esta seção de solução de problemas.

Known issues specific to MV3 extensions

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 entrada Simular não funciona mais em elementos HTML que têm um manipulador de cliques com URI javascript:.

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

Isso foi relatado como um bug do Chromium. 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 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: Cannot communicate with UiPath Platform The native part of the extension is not configured correctly.

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.

Essa propriedade está disponível a partir do UiPath.UIAutomation.Activities v22.12.0-preview.

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, depois que páginas Web tiverem carregado. Isso significa que em máquinas mais lentas, a atividade Open Browser do UiPath.UiAutomation.Activities versão 22.10 ou anterior pode atingir o tempo limite interno de 20 segundos antes de a extensão iniciar.

A partir da pré-visualização v22.12.0, o tempo limite interno para a atividade Open Browser foi aumentado de 20 segundo para 60 segundos.

Como você pode precisar definir um tempo limite mais longo para a inicialização do navegador, ele agora é configurável a partir das atividades Use Application/Browser e Open Browser. Foram adicionadas as seguintes configurações do projeto:

• Automação de Interface Gráfica → Navegador → Tempo limite de abertura do navegador (segundos)

• Automação de Interface Gráfica Moderna → Aplicativo/Navegador → Tempo limite de abertura do navegador (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.