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 do Manifest V2 está programada 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 afetados pela implantação da descontinuação até lá. 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 robô antes que isso aconteça. Consulte 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 a partir das seguintes UiPathStudio.msi versões:

• 2022.10
• 2022.4.4+
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+ Elas podem ser baixadas da Central de Recursos do 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

Observação:

A funcionalidade Guias suspensas do Edge v134 afeta as extensões 22.10, 23.4 e 23.10 da UiPath. Esse problema foi corrigido na versão estável 136.0.3240.92 do Microsoft Edge (consulte Problemas conhecidos do Edge). Para obter mais detalhes e soluções alternativas, consulte este tópico do fórum.

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. Open Edge and navigate to edge://extensions.
5. Enable the UiPath Web Automation extension if needed.

Instalar a partir do Instalador do Studio

1. Executar o instalador UiPathStudio.msi.
2. Select an install mode, and then select Advanced Settings > Extensions > UiPath extension for Edge Chromium. If Edge is installed on your machine, the option is selected by default.
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 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 é conectada pela UiPath em vez da Edge 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 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.

  :::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_edge_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

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.

  :::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 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.

Web pages containing Java Applets, Silverlight and ActiveX controls can be automated in Internet Explorer mode.

Automatizando apps do Edge

A partir do UiPathStudio.msi 2022.4, a Extensão UiPath para Edge pode ser usada para automatizar Apps do 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 até edge://profile-internals/ e obtenha-o na entrada Caminho do perfil.

Solução de problemas

Your system administrator might have configured Group Policies that prevent the Extension for Edge from working. To enable it, please follow the instructions from the Group Policies page.

Para quaisquer outros problemas relacionados à extensão UiPath para Edge, consulte a página de solução de problemas detalhada.