Ferramenta de Migração de Navegador do UiPath

A UiPath Browser Migration Tool é uma ferramenta autônoma que converte os fluxos de trabalho usando um navegador de destino, como o Internet Explorer, Chrome, Edge ou Firefox, fazendo-os direcionar outro navegador, como o Chrome, Edge ou Firefox. Essa ferramenta pode ser útil ao migrar fluxos de trabalho do navegador Internet Explorer legado para navegadores mais recentes ou simplesmente quando você deseja adaptar seu fluxo de trabalho para usar outro navegador.

Essa ferramenta é compatível com quaisquer arquivos XAML gerados com qualquer versão do Studio ou do UIAutomation.

Observação: Existem certos tipos de seletores que não podem ser migrados automaticamente com o uso dessa ferramenta. Por exemplo, seletores que começam com <wnd…, já que eles identificam elementos de interface gráfica renderizados de forma diferente pelo IE em comparação com o Edge/Chrome/Firefox. Esses seletores têm que ser atualizados manualmente.

Como funciona a Ferramenta de Migração de Navegador da UiPath

Para migrar os fluxos de trabalho do uso de um navegador para outro, há uma lista de coisas que devem ser feitas:

• Os seletores <html...> são migrados atualizando sua propriedade app.
• A propriedade TipoDeNavegador das atividades Open Browser e Attach Browser é devidamente modificada.
• Qualquer atividade Kill Process que segmente o navegador de origem é atualizada para segmentar o navegador de destino.

• Os itens do repositório de objetos definidos no navegador de origem são convertidos para usar o navegador de destino.

  Observação: A ferramenta de migração não tem uma taxa de sucesso de 100%. Para se aproximar dessa taxa, é recomendado realizar a validação nos fluxos de trabalho migrados.

Instalando a Ferramenta de Migração de Navegador da UiPath

Primeiro, baixe a ferramenta compactada do Centro de Recursos no portal do Automation Cloud (o menu de ajuda > Downloads > UiPath Ferramentas > Ferramenta de Migração do Navegador).

Em seguida, descompacte o arquivo em uma pasta de sua escolha.

Executar o executável UiPath.ConversionTool.exe abre a UiPath Conversion Tool.

Configurando a ferramenta de migração de navegador da UiPath

A Ferramenta de Migração de Navegador da UiPath pode ser configurada editando o arquivo Settings.json presente na pasta de instalação.

Os seguintes parâmetros podem ser editados:

• "Folder": "" - Especifica a pasta de destino para a qual você deseja migrar os arquivos XAML.
• "SourceBrowser": "IE"- Especifica o navegador de origem. As opções possíveis são IE, Chrome, Edge, Firefox.
• "DestinationBrowser": "Chrome" - Especifica o navegador de destino. As opções possíveis são Chrome, Edge, Firefox.
• "PreviewChanges": false - Se estiver definido como true, os arquivos originais não são modificados; apenas um log de mudança é gerado. Se estiver definido como false, as atualizações são aplicadas nos arquivos XAML de origem.
• "ReplaceNullBrowserType": true- Se estiver definido como true, se encontrado, o BrowserType = null é atualizado para BrowserType = targetBrowser. Se estiver definido como false, esses casos são ignorados.
• "IncludeSubfolders": true - Se estiver definido como true, modifica todos os arquivos XAML da pasta especificada e suas subpastas. Se estiver definido como false, modifica apenas os arquivos na pasta pai de destino.
• "CreateBackupFiles": true- Se estiver definido como true, cria arquivos de backup (.bak) antes de atualizar os originais. Os arquivos de backup podem encontrados em {SourceFolder}/.conversion_backup. Se estiver definido como false, os arquivos de backup não são criados.
• "EnableLogging": true - Se estiver definido como true, cria um arquivo de log. Se estiver definido como false, nenhum arquivo de log é criado.

Usando a Ferramenta de Migração de Navegador da UiPath

Da interface do usuário

Para usar a ferramenta, primeiramente você deve fornecer o caminho para o fluxo de trabalho que você deseja migrar na seção Pasta do Projeto.

Em seguida, selecione o navegador com o qual você criou a automação no menu suspenso Navegador de origem e o navegador para o qual você deseja migrar no menu suspenso Navegador de destino.

Importante: Se você tiver uma automação criada com o Internet Explorer e quiser migrá-la para o Firefox, selecione IE no menu suspenso Navegador de origem e Firefox no menu suspenso Navegador de destino .

O botão Mudanças de visualização executa a ferramenta no modo de mudanças de visualização. Isso verifica todos os arquivos .xaml e produz as alterações que seriam aplicadas no arquivo de log UiPath.ConversionTool_log.json que é gerado na pasta de destino. Nenhuma alteração é aplicada no fluxo de trabalho real e nenhum arquivo de backup é criado.

O Botão Iniciar executa a migração no fluxo de trabalho especificado, tornando-a compatível com o navegador de sua escolha.

A partir da Linha de comando

Para usar a ferramenta com as definições configuradas no arquivo Settings.json, execute o comando {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json

Chaves de verificação pós-migração

Após ter sido usada, a Ferramenta de Migração de Navegador do UiPath cria um arquivo de log chamado UiPath.ConversionTool_log na pasta do projeto. O arquivo fornece uma visão geral do processo sob o parâmetro "GlobalStatistics" e detalhes completos da atualização por cada arquivo XAML sob o parâmetro "FileChanges/FileName/Statistics" .

Outros aspectos da migração

Se você planeja migrar as automações para o Edge (Chromium), isso pode ser feito a partir de:

• Studio versão v19.10.5 e UiPath.UIAutomation.Activities v19.11.3
• Studio versão v20.4.1 e UiPath.UIAutomation.Activities v20.4.1

Se você planeja executar após a migração no Edge Chromium com Modo IE ativado, isso está disponível a partir do UiPath.UIAutomation.Activities v20.10 e superior.

Observe que executar automações no Chrome, Edge ou Firefox requer que a devida Extensão UiPath esteja instalada.