Extensão para Chrome

Importante:

UiPath Inc. and its affiliates do not process, use, access, or store any customer data when using this product.

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 afetados pela implantação da descontinuação até lá. 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 robô antes que isso aconteça. A extensão da UiPath para Chrome MV3 está disponível a partir das 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.
• Resource Center 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. Open Chrome and navigate to chrome://extensions.
5. Enable the UiPath Web Automation extension if needed.

Instalar a partir do Instalador do Studio

1. Execute o instalador UiPathStudio.msi.
2. Select an install mode, and then select Advanced Settings > Extensions > UiPath extension for Chrome. If Chrome is installed on your machine, the option is selected by default.
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 Política de grupo off-line porque o ID da extensão não muda ao ser atualizado 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.

  :::note
  You only need to set the `NativeMessagingAllowlist` policy value when the `NativeMessagingBlockList` policy is defined with the value of **`*`**.
  :::

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 UiPath poderão 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.

  :::note
  You only need to set the `NativeMessagingAllowlist` policy value when the `NativeMessagingBlockList` policy is defined with the value of **`*`**.
  :::

Importante:

Se essas alterações não forem feitas após a instalação, as configurações da extensão UiPath poderão 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 da versão UiPathStudio.msi2022.4, a extensão UiPath para Chrome pode ser usada para automatizar Apps 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 até 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 quaisquer outros problemas relacionados à Extensão do UiPath para o Chrome, consulte a página detalhada de solução de problemas.