Extension for Edge

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

Importante:

A descontinuação das extensões Manifest V2 está agendada para começar em junho de 2024.

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.

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

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

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

• 2022.10
• 2022.4.4+
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

O download pode ser feito da Central de Recursos da UiPath Automation Cloud.

Essa extensão ajuda você a criar automações de navegador no Microsoft Edge. 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 Edge > 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 Edge e navegue até edge://extensions.
5. Habilite a extensão UiPath Web Automation se necessário.

Instalar a partir do Instalador do Studio

1. Executar o instalador UiPathStudio.msi.
2. Selecione um modo de instalação e selecione Configurações avançadas > Extensões > Extensão UiPath para Edge Chromium. Se o Edge estiver instalado em sua máquina, a opção será selecionada por padrão.
3. Clique em Instalar. A configuração do Studio continuará ao mesmo tempo em que instala a extensão para o Edge.

A extensão UiPath para Edge 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 Edge, 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 da 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 por política de grupo porque o ID da extensão não muda ao atualizar para versões mais recentes. Este método usa uma extensão que é assinada pela UiPath em vez da Edge Web Store. Isso significa que após a atualização da versão, não é necessário atualizar as Políticas de grupo internas (ou seja, a política ExtensionInstallForcelist ) com um novo ID de extensão.

Outra vantagem de reutilizar o mesmo ID de extensão é que as definições configuradas para a extensão (como Permitir InPrivate ou Permitir acesso a URLs de arquivo) não são redefinidas após uma atualização de versão.

Offline

Este método de instalação requer que a máquina de destino esteja associada a um domínio do Microsoft Active Directory ou Azure Active Directory.

Não requer acesso à Edge Web Store, portanto pode ser usada em ambientes controlados para 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" /edge-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/EdgeExtension_SelfHosted/extension_manifest_edge.xml

2. Na política NativeMessagingAllowlist, adicione o valor: com.uipath.chromenativemsg_v2.

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

C:\Arquivos de Programas\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_edge_self_hosted_mv3.crx

Online

Esse método de instalação requer que a máquina de destino tenha acesso à Edge Web Store (https://edge.microsoft.com/extensionwebstorebase/v1/crx e https://msedgeextensions.sf.tlu.dl.delivery.mp.microsoft.com).

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" /edge-chromium-policyglobal /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:

   cdfjcmjmgdnojgaojdnefhjjpaijapci;https://edge.microsoft.com/extensionwebstorebase/v1/crx

2. Na política NativeMessagingAllowlist, adicione o valor: com.uipath.chromenativemsg_v2.

Desinstalando

A extensão UiPath para Edge pode ser desinstalada executando a partir de um prompt de comando elevado:

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-cleanup /silent

Você também pode desinstalar abrindo o Studio, navegando até Ferramentas > UiPath Extensions e selecionando Edge > 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.

Edge version requirements

A extensão UiPath para Edge MV2 funciona com todas as versões existentes do Edge.

A Extensão UiPath para Edge MV3 requer o Edge 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

Suporte para o Modo IE

A partir do UiPathStudio.msi 2020.10, a extensão UiPath para Edge pode ser usada para automatizar páginas web em execução no modo Internet Explorer.

Páginas web contendo controles Java Applets, Silverlight e ActiveX podem ser automatizadas no modo Internet Explorer.

Automatizando apps do Edge

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

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

A partir da versão 2023.10 do UiPath, a extensão UiPath para Edge é 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 inferiores a 2023.10, a extensão UiPath para Edge 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 exigiu que você fechasse todas as instâncias ativas do Edge 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 Edge, 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%\Microsoft\Edge\User Data%. Para descobrir o caminho do perfil, navegue para edge://profile-internals/ e obtenha-o na entrada Caminho do perfil.

Solução de problemas

Seu administrador de sistemas pode ter configurado Políticas de Grupo que impedem que a Extensão para Edge funcione. Para habilitá-la, siga as instruções da página Políticas de Grupo.

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