Solução de problemas

Solução de problemas da extensão UiPath para Firefox: causas comuns de falhas e correções passo a passo para problemas de automação do navegador.

Observação:

Você precisa usar pelo menos a versão 52.0 do Firefox para executar automações de navegador.

Este tópico apresenta os motivos mais frequentes pelos quais a Extensão UiPath^® para Firefox pode não funcionar corretamente e como resolver esses problemas.

Extensão em versões mais antigas do Firefox

Description

A Mozilla introduziu um algoritmo de verificação de assinatura de extensões no Firefox, que desabilita complementos para o Firefox nas versões 65.0 e inferiores. Dessa forma, se você instalar a extensão da UiPath para o Firefox na versão 65.0 do navegador ou inferior, a seguinte mensagem de erro é exibida:

This add-on could not be installed because it appears to be corrupt.

Solução 1

Atualize o Firefox para a versão v66.0.4 ou posterior.

Solução 2

A partir do Studio 2020.8, a extensão do Firefox foi assinada recentemente e precisa ser devidamente instalada em versões mais antigas do navegador Firefox.

Verificando a Extensão

Verifique se a extensão do UiPath para o Firefox está instalada e habilitada

1. No Mozilla Firefox, acesse about:addons > Extensões.
2. Se a extensão não estiver presente, instale a extensão conforme explicado aqui.
3. Certifique-se de que a extensão da UiPath esteja atualizada na versão mais recente.

Para evitar possíveis problemas

1. No Mozilla Firefox, acesse about:addons > Extensões.

2. Abra o Gerenciador de Tarefas ou o Explorador de Processos.

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

   Observação:

   Uma instância separada ChromeNativeMessaging está em execução para a extensão do Chrome, de forma que é preciso fechar o Google Chrome

   Se ChromeNativeMessaging não estiver em execução:

4. No Mozilla Firefox, acesse about:addons > Extensões.

5. Remova a extensão da UiPath manualmente clicando no botão Remover.

6. Reinstale dessa maneira.

Caso as informações acima não resolvam seu problema, você pode tentar buscar informações adicionais visualizando rastreamentos e analisando os erros gerados pela extensão da UiPath. Os tipos de rastreamento a seguir são aqueles que você pode coletar e analisar:

Para os rastreamentos de extensão gerais no Mozilla Firefox

Acesse Abrir menu > Desenvolvedor Web > Console do Navegador (Ctrl+Shift+J). O Console do navegador será exibido. Todos os erros gerados pela extensão são exibidos aqui.

Para traces gerados pela página da web que você deseja automatizar

Acesse Abrir menu> Desenvolvedor Web > Console Web (Ctrl+Shift+K). O Console do navegador será exibido. Todos os erros para a página Web atual são exibidos aqui.

Para traces completos, (não apenas erros) faça o seguinte

1. Abra o Editor do Registro.

2. Navegue até a chave HKEY_CURRENT_USER\SOFTWARE\UiPath.

3. Abra o valor WebExtensionTrace REG_DWORD. A janela Editar valor DWORD será exibida.

4. No campo Dados de valor , altere o valor para 1 e selecione OK. O valor será salvo.

   Observação:

   Se o valor REG_DWORD WebExtensionTrace não existir, você precisa criá-lo clicando com o botão direito do mouse no painel à direita, selecionando Novo > Valor DWORD (32-bit), e fornecendo os valores mencionados acima.

   Verifique se há alguns dados ausentes no Editor do Registro:

5. Abra o Editor do Registro.

6. Navegue até a chave HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg.

7. Abra o valor REG_SZ (Default). A janela Editar String é exibida e deve conter um caminho semelhante a C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json.

8. Abra o arquivo .json no caminho encontrado acima com um editor de texto, como o Notepad++.

9. Verifique se a propriedade path aponta corretamente para onde ChromeNativeMessaging.exe está localizado, de maneira semelhante a C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe.

Multiple browser profiles

A partir da versão 2023.10 do UiPath, a extensão UiPath para Firefox é compatível com a automação de várias instâncias de navegador em execução com vários perfis de usuário ao mesmo tempo.

Observação:

A automação de vários perfis de navegador requer UiPath.UIAutomation.Activities v23.10 ou mais recente e a extensão de navegador instalada com UiPathStudio.msi v23.10 ou mais recente.

Agora é possível abrir o navegador com um perfil específico ao usar a atividade Use Application/Browser. Para especificar um perfil na inicialização do navegador, é necessário anexar um argumento à linha de comando do navegador. Para isso, use a propriedade Argumentos no campo de entrada Destino do Aplicativo Unificado.

Para Firefox, o argumento necessário é: -profile "full_profile_path". Para descobrir o caminho do perfil completo, navegue até about:profiles e obtenha o Diretório Raiz desse perfil.