- Notas de Versão
- Introdução
- Configuração e Instalação
- Projetos de automação
- Sobre a publicação de projetos de automação
- Projetando automações
- Gerenciamento de pacotes de atividades
- Como definir as configurações do projeto de atividades
- Como assinar pacotes
- Governança
- Como importar entidades
- Experiência de Criação Moderna
- Vincular um projeto a uma ideia no Automation Hub
- Usando o Gerenciador de dados
- Dependências
- Tipos de fluxos de trabalho
- Comparação de arquivos
- Melhores Práticas de Automação
- Integração de controle de origem
- Depuração
- A ferramenta de diagnóstico
- Variáveis
- Argumentos
- Namespaces Importados
- Automação assistida baseada em gatilho
- Gravação
- Elementos de Interface Gráfica
- Fluxo de controle
- Seletores
- Repo. de Objetos
- Extração de Dados
- Automação de imagem e texto
- Automação de tecnologias Citrino
- Automação RDP
- Automação da Salesforce
- Automação SAP
- Automação do Varear Horizonte
- Geração de logs
- A ferramenta ScreenScrapeJavaSupport
- O protocolo Servodrive
- Test Suite — Studio
- Extensões
- Solução de problemas
- Sobre a solução de problemas
- Suporte e limitações do Microsoft Apo-V
- Solução de problemas do Internet Explorer x64
- Problemas do Microsoft Office
- Como identificar elementos de EU em PDF com opções de acessibilidade
- Reparando o suporte da Active Accessibility
- Automação de aplicativos em execução com um usuário diferente do Windows
- Validation of large Windows-legacy projects takes longer than expected
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.
- No Google Chrome, navegue até
chrome://extensions/
. - Certifique-se de que a extensão esteja instalada e habilitada, conforme explicado aqui.
- 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.
ChromeNativeMessaging.exe
habilita a comunicação entre a extensão UiPath para Chrome e o UiPath Studio/Robot.
- Abra o Chrome.
- Abra o Gerenciador de Tarefas.
- Verifique se o processo
ChromeNativeMessaging.exe
está em execução.
- 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.
ChromeNativeMessaging.exe
é executado no usuário atual e utiliza cmd.exe
para iniciar o navegador.
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.
ComSpec
. Essa variável é definida na instalação do Windows e deve ser definida como: %SystemRoot%\system32\cmd.exe
.
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.
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).
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:
- No Google Chrome, navegue até
chrome://extensions/
. A página de Extensões do Chrome será exibida. - Navegue até a extensão UiPath Web Automation e clique no botão Detalhes. A página de detalhes da UiPath Web Automation é exibida.
- Certifique-se de que as opções Permitir modo incógnito e Permitir o acesso aos URLs de arquivo estejam selecionadas.
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.
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.
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 da máquina tem prioridade, as extensões definidas no nível de usuário/nuvem são desinstaladas.
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.
- Instale a extensão UiPath para Chrome usando o método de instalação
NativeHostOnly
.Este método de instalação permite a comunicação entre a extensão e o Studio/Robot.
Ele não faz nenhuma alteração nas Políticas de Grupo.
Para usar esse método de instalação, adicioneCHROME_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
. - Na política ExtensionInstallForcelist, adicione o valor:
-
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
-
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
-
- Na política NativeMessagingAllowlist, adicione o valor:
com.uipath.chromenativemsg_v2
. - 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.
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:
- 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).
- 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 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
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.
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á.
2
, então:
- Todas as limitações de
DeveloperToolsAvailability=0
se aplicam - O método de entrada
ChromiumAPI
não funcionará.
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.
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.
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)
UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS
. Por exemplo, defina UIPATH_OPEN_BROWSER_TIMEOUT_SECONDS=120
para usar 120 segundos para o tempo limite da atividade.
- Check if the Extension for Chrome is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Description
- Solução
- Outras soluções alternativas
- Habilite o Acesso às URLs do arquivo e o Modo Anônimo
- Multiple browser profiles
- Várias instâncias do Chrome com vários perfis de usuário
- Como interromper todas as instâncias do Chrome
- Group Policy conflict
- Description
- Solução
- Problemas conhecidos para extensões MV3
- A atividade de clique com simulação falha em elementos específicos da página da web
- O valor da política de grupo DeveloperToolsAvailability deve ser definido como 1
- A janela do navegador UiPath Web Automation mostra um aviso
- A atividade Inject Js Script não pode mais ser usada para acessar variáveis e código de página
- A atividade Abrir Navegador tem tempo limite insuficiente