Outil de migration de navigateur UiPath

L'outil de migration du navigateur UiPath est un outil autonome qui convertit les workflows à l'aide d'un navigateur cible tel qu'Internet Explorer, Chrome, Edge ou Firefox, en les faisant cibler un autre navigateur, tel que Chrome, Edge ou Firefox. Cet outil peut être utile lors de la migration de workflows du navigateur Internet Explorer hérité vers des navigateurs plus récents, ou simplement lorsque vous souhaitez adapter votre workflow à l'utilisation d'un autre navigateur.

Cet outil est compatible avec tous les fichiers XAML générés avec n’importe quelle version de Studio ou UIAutomation.

Remarquer  Certains types de sélecteurs ne peuvent pas être automatiquement migrés à l’aide de cet outil. Par exemple, les sélecteurs commençant par <wnd…. Ceux-ci identifient les éléments d’IU rendus différemment par IE par rapport à Edge, Chrome ou Firefox. Ces sélecteurs doivent être mis à jour manuellement.

Fonctionnement de l'outil de migration UiPath Browser

Afin de migrer les workflows d’un navigateur à un autre, il existe une liste de choses à faire. Procédez comme suit :

• Les sélecteurs <html...> sont migrés en mettant à jour leur propriété app.
• La propriété TypeNavigateur des activités Open Browser et Attach Browser est modifiée en conséquence.
• Toute activité Kill Process ciblant le navigateur source est mise à jour pour cibler le navigateur cible.

• Les éléments du référentiel d’objets définis dans le navigateur source sont convertis pour utiliser le navigateur cible.

  Remarque : L'outil de migration n'a pas un taux de réussite de 100 %. Pour se rapprocher d'un tel taux, il est recommandé d'effectuer une validation sur les workflows migrés.

Installation de l'outil de migration UiPath Browser

Tout d'abord, téléchargez l'outil compressé à partir du centre de ressources sur le portail Automation Cloud (menu Aide > Téléchargements > UiPath Tools > Outil de migration du navigateur (Browser Migration Tool)).

Ensuite, décompressez l’archive dans le dossier de votre choix.

L’exécution du fichier exécutable UiPath.ConversionTool.exe ouvre l’outil de conversion UiPath.

Configuration de l'outil de migration UiPath Browser

L'outil de migration UiPath Browser peut être configuré en modifiant le fichier Settings.json présent dans le dossier d'installation.

Les paramètres suivants peuvent être modifiés :

• "Folder": "" : spécifie le dossier cible dans lequel vous souhaitez migrer les fichiers XAML.
• "SourceBrowser": "IE" : spécifie le navigateur source. Les options possibles sont IE, Chrome, Edge, Firefox.
• "DestinationBrowser": "Chrome" : spécifie le navigateur de destination. Les options possibles sont Chrome, Edge, Firefox.
• "PreviewChanges": false : si le paramètre est défini sur true, les fichiers d’origine ne sont pas modifiés. Seul un journal des modifications est généré. Si le paramètre est défini sur false, les mises à jour sont appliquées aux fichiers XAML source.
• "ReplaceNullBrowserType": true : si le paramètre est défini sur true et s’il est trouvé, le paramètre BrowserType = null est mis à jour et remplacé par BrowserType = targetBrowser. Si le paramètre est défini sur false, ces cas sont ignorés.
• "IncludeSubfolders": true : si le paramètre est défini sur true, il modifie tous les fichiers XAML du dossier spécifié et de ses sous-dossiers. S’il est défini sur false, il modifie uniquement les fichiers du dossier parent cible.
• "CreateBackupFiles": true : si le paramètre est défini sur true, il crée des fichiers de sauvegarde (.bak) avant de mettre à jour ceux d’origine. Les fichiers de sauvegarde se trouvent dans {SourceFolder}/.conversion_backup. S’il est défini sur false, les fichiers de sauvegarde ne sont pas créés.
• "EnableLogging": true : si le paramètre est défini sur true, il crée un fichier journal. S’il est défini sur false, aucun fichier journal n’est créé.

Utilisation de l'outil de migration UiPath Browser

Depuis l’interface utilisateur

Pour utiliser l’outil, vous devez d’abord fournir le chemin d’accès au workflow que vous souhaitez migrer dans la section Dossier de projet (Project Folder).

Ensuite, sélectionnez le navigateur avec lequel vous avez créé l’automatisation dans le menu déroulant Navigateur source (Source Browser) et le navigateur vers lequel vous souhaitez migrer dans le menu déroulant Navigateur de destination (Destination Browser).

Important : si vous avez une automatisation créée avec Internet Explorer et que vous souhaitez la migrer vers Firefox, sélectionnez IE dans la liste déroulante du navigateur source et Firefox dans la liste déroulante du navigateur de destination .

Le bouton Aperçu des modifications (Preview Changes) exécute l’outil en mode Aperçu des modifications. Il analyse tous les fichiers .xaml et affiche les modifications qui seraient appliquées dans le fichier journal UiPath.ConversionTool_log.json, généré dans le dossier cible. Aucune modification ne sera appliquée au workflow en cours et aucun fichier de sauvegarde ne sera créé.

Le bouton Démarrer effectue la migration sur le workflow spécifié, le rendant compatible avec le navigateur de votre choix.

À partir de la ligne de commande

Pour utiliser l’outil avec les paramètres configurés dans le fichier Settings.json, exécutez la commande {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json

Clés de vérification post-migration

Une fois utilisé, l'outil de migration UiPath Browser crée un fichier journal nommé UiPath.ConversionTool_log dans le dossier du projet. Le fichier fournit une vue d'ensemble du processus sous le paramètre "GlobalStatistics" et les détails complets de la mise à jour pour chaque fichier XAML sous le paramètre "FileChanges/FileName/Statistics" .

Autres aspects migratoires

Si vous envisagez de migrer les automatisations vers Edge (Chromium), vous pouvez le faire avec :

• Studio version v19.10.5 et UiPath.UIAutomation.Activities v19.11.3
• Studio version v20.4.1 et UiPath.UIAutomation.Activities v20.4.1

Si vous prévoyez d’exécuter le projet après la migration sous Edge Chromium avec le mode IE activé, vous pouvez le faire avec le package UiPath.UIAutomation.Activities v20.10 et les versions supérieures.

Veuillez noter que l’exécution des automatisations sur Chrome, Edge ou Firefox nécessite l’installation de l’extension UiPath appropriée.