Extensão para Chrome

Importante: a UiPath Inc. e suas afiliadas não processam, usam, acessam nem armazenam dados do cliente ao usar este produto.

Importante:

O Chrome está retomando a transição para extensões MV3. O Chrome começará a desabilitar as extensões do Manifest V2 em versões pré-estáveis do Chrome (Dev, Canary e Beta) já em junho de 2024, no Chrome 127 e posterior.

As empresas que usam a política da ExtensionManifestV2Availability para garantir o funcionamento contínuo das extensões do Manifest V2 em sua organização terão um ano adicional - até junho de 2025 - para migrar as extensões do Manifest V2 em sua organização. Os navegadores com a política habilitada não serão impactados pela implantação da descontinuação até esse momento.

Veja o cronograma completo para a migração do Chrome para extensões MV3 aqui.

A extensão UiPath para Chrome MV2 instalada por versões mais antigas do UiPathStudio.msi não funcionará mais no Chrome. É altamente recomendável atualizar suas instalações do UiPath Studio e do UiPath Robot antes que isso aconteça.

A extensão da UiPath para Chrome MV3 está disponível nas seguintes versões UiPathStudio.msi:

• 2022.10
• 2022.4
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

Essas versões podem ser baixadas a partir de:

• Downloads de produtos no UiPath Customer Portal.
• Central de Recursos na UiPath Automation Cloud. Para acessar o Resource Center, você precisa fazer login em sua Automation Cloud Organization e clicar no botão Ajuda na barra de navegação esquerda.

Essa extensão ajuda a criar automações do navegador no Google Chrome.

Você pode instalar essa extensão de várias maneiras, conforme mostrado abaixo:

Instalar a partir do UiPath Studio

1. Abra o Studio.
2. Navegue até Início > Ferramentas > Extensões da UiPath.

3. Selecione Chrome > Instalar. Escolha um dos métodos disponíveis no menu suspenso:

   • Política de grupo off-line
   • Política de grupo on-line
   • Todos os usuários
   • Usuário atual
   • Somente host nativo
4. Abra o Chrome e navegue até chrome://extensions.
5. Habilite a extensão UiPath Web Automation se necessário.

Instalar a partir do Instalador do Studio

1. Execute o instalador UiPathStudio.msi.
2. Selecione um modo de instalação e selecione Configurações avançadas > Extensões > Extensão UiPath para Chrome. Se o Chrome estiver instalado em sua máquina, a opção será selecionada por padrão.
3. Clique em Instalar. A configuração do Studio continua enquanto também se instala a extensão para o Chrome.

A extensão UiPath para Chrome também pode ser instalada a partir da linha de comando do UiPathStudio.msi.

Instalar a partir da Política de Grupo

Você também pode instalar a Extensão do UiPath para o Chrome usando as Políticas de Grupo. Esse método instala silenciosamente a extensão, habilitando-a sem exigir confirmação por parte do usuário.

Para ambos os métodos de instalação de Política de Grupo, o navegador não mostra o banner quando a extensão usa a API do depurador.

Recomendamos usar a instalação Offline de Política de Grupo porque o ID da extensão não muda ao atualizar para versões mais recentes. Esse método usa uma extensão que é assinada pela UiPath em vez da Chrome Web Store. Isso significa que, após atualizar a versão, não há necessidade de atualizar as Políticas de Grupo internas (ou seja, a política ExtensionInstallForceList) com um novo ID de extensão.

Outra vantagem da reutilização do mesmo ID de extensão é que as configurações definidas para a extensão (como Permitir no modo anônimo ou Permitir acesso a URLs de arquivo) não são redefinidas após uma atualização de versão.

Offline

O método de instalação offline da política de grupo requer que a máquina de destino esteja ingressada em um domínio do Microsoft Active Directory ou Azure Active Directory.

Não é necessário ter acesso à Chrome Web Store para que ele possa ser usado em máquinas com acesso restrito à Internet.

O UiPathStudio.msi usa esse método de instalação por padrão se seus requisitos forem atendidos.

Você também pode usar este método de instalação executando a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chrome-policy-offline /silent

Se sua organização usar Políticas de Grupo para gerenciamento de extensões de navegador, as seguintes alterações também terão que ser feitas na definição de políticas de grupo da sua organização:

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

   ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml .
2. Na política NativeMessagingAllowList, adicione o valor: com.uipath.chromenativemsg_v2.
   Observação: você só precisa definir o valor da política NativeMessagingAllowlist quando a política NativeMessagingBlockList for definida com o valor de *.

Se você precisa hospedar a extensão da UiPath na sua loja virtual interna você pode encontrar o arquivo .crx neste local:

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_chrome_self_hosted_mv3.crx .

Importante: se essas alterações não forem feitas após a instalação, as configurações da extensão do UiPath podem ser substituídas durante as atualizações periódicas da Política de grupo.

Online

O método de instalação da política de grupo online requer que a máquina de destino tenha acesso à Chrome Web Store (https://clients2.google.com/service/update2/crx e https://clients2.googleusercontent.com/crx).

O UiPathStudio.msi usa esse método de instalação se seus requisitos forem atendidos e a máquina não estiver associada a um Microsoft Active Directory.

Você também pode usar este método de instalação executando a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromepolicyglobal /silent

Se sua organização usar Políticas de Grupo para gerenciamento de extensões de navegador, as seguintes alterações também terão que ser feitas na definição de políticas de grupo da sua organização:

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

   pgbnimfaaifjpebleldfhgcjdnaeafdi;https://clients2.google.com/service/update2/crx.
2. Na política NativeMessagingAllowList, adicione o valor: com.uipath.chromenativemsg_v2.
   Observação: você só precisa definir o valor da política NativeMessagingAllowlist quando a política NativeMessagingBlockList for definida com o valor de *.

Importante: se essas alterações não forem feitas após a instalação, as configurações da extensão do UiPath podem ser substituídas durante as atualizações periódicas da Política de grupo.

Desinstalando

A extensão UiPath para Chrome pode ser desinstalada executando uma solicitação a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromecleanup /silent

Você também pode desinstalar abrindo o Studio, navegando até Página inicial > Ferramentas > UiPath Extensions e selecionando Chrome > Desinstalar. A extensão será desinstalada com o mesmo método usado para a instalação. Esse método é exibido no menu suspenso desabilitado ao lado do botão Desinstalar.

Chrome version requirements

A extensão UiPath para Chrome MV2 requer o Chrome versão 64 ou superior.

A extensão UiPath para Chrome MV3 requer o Chrome versão 98 ou superior.

Ao usar um dos métodos de instalação descritos acima, a versão do navegador será verificada e a extensão com o formato apropriado (MV2 ou MV3) será instalada automaticamente.

New extension features

Automatizando apps do Chrome

A partir do UiPathStudio.msi 2022.4, a extensão UiPath para Chrome pode ser usada para automatizar Aplicativos do Chrome.

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

A partir da versão 2023.10 do UiPath, a extensão UiPath para Chrome é 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.

Para versões anteriores à versão 2023.10, a extensão UiPath para Chrome não era 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. Dessa forma, a automação do navegador exigia que você fechasse todas as instâncias ativas do Chrome e reiniciasse o navegador usando um único perfil do usuário. A partir da versão 2023.10, é possñivel acomodar cenários de vários processos de navegador em execução sob diferentes perfis de navegador, como o caso em que um aplicativo específico deve ser executado em um perfil dedicado para isolar dados confidenciais de outros aplicativos.

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 v2023.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 Chrome, o argumento necessário é: --profile-directory="profile_path".

O profile_path é o caminho relativo para o caminho da pasta de dados do usuário especificado para essa atividade Use Application/Browser. Se o caminho da pasta de dados do usuário não for especificado, o caminho do perfil será relativo ao diretório de dados do usuário padrão %LOCALAPPDATA%\Google\Chrome\User Data%. Para descobrir o caminho do perfil, navegue para chrome://profile-internals/ e obtenha-o na entrada Caminho do perfil.

Solução de problemas

O administrador do seu sistema pode ter configurado Políticas de Grupo que que impedem que a Extensão do UiPath para o Chrome funcione. Para habilitá-la, siga as instruções da página Políticas de Grupo.

Para qualquer outro problema relacionado à extensão do UiPath para o Chrome, consulte a página detalhada de solução de problemas.