UiPath-Browsermigrationstool

Das UiPath Browsermigrationstool ist ein eigenständiges Tool, das Workflows mit einem Zielbrowser wie Internet Explorer, Chrome, Edge oder Firefox konvertiert, sodass sie einen anderen Zielbrowser verwenden, z. B. Chrome, Edge oder Firefox. Dieses Tool kann hilfreich sein, wenn Sie Workflows vom veralteten Internet Explorer zu neueren Browsern migrieren oder wenn Sie Ihren Workflow einfach zur Verwendung eines anderen Browsers anpassen möchten.

Dieses Tool ist mit allen XAML-Dateien kompatibel, die mit einer beliebigen Studio- oder UIAutomation-Version erzeugt wurden.

Hinweis: Es gibt bestimmte Selektortypen, die nicht automatisch mithilfe dieses Tools migriert werden können. Zum Beispiel Selektoren, die mit <wnd… beginnen, da diese UI-Elemente identifizieren, die von IE anders als von Edge/Chrome/Firefox angezeigt werden. Diese Selektoren müssen manuell aktualisiert werden.

Funktionsweise des UiPath-Browsermigrationstools

Um die Workflows von der Verwendung eines Browsers zu einem anderen zu migrieren, müssen die folgenden Schritte ausgeführt werden:

• Die <html...>-Selektoren werden migriert, indem ihre app-Eigenschaft aktualisiert wird.
• Die Browsertyp-Eigenschaft der Open Browser- und Attach Browser-Aktivitäten wird entsprechend geändert.
• Jede Kill Process-Aktivität, die auf den Quellbrowser ausgerichtet ist, wird aktualisiert, damit sie auf den Zielbrowser ausgerichtet ist.

• Die im Quellbrowser definierten Object Repository-Elemente werden zur Verwendung des Zielbrowsers konvertiert.

  Hinweis: Das Migrationstool hat keine Erfolgsquote von 100 %. Um die Quote zu erreichen, wird empfohlen, eine Validierung für die migrierten Workflows durchzuführen.

Installieren des UiPath-Browsermigrationstools

Laden Sie zuerst das gezippte Tool aus dem Ressourcenzentrum im Automation Cloud -Portal herunter (das Hilfemenü > Downloads > UiPath Tools > Browsermigrationstool).

Dann entpacken Sie das Archiv in einen beliebigen Ordner.

Wenn Sie die ausführbare Datei UiPath.ConversionTool.exe ausführen, wird das UiPath Conversion Tool geöffnet.

Konfigurieren des UiPath-Browsermigrationstools

Das UiPath-Browsermigrationstool kann durch Bearbeiten der Settings.json -Datei im Installationsordner konfiguriert werden.

Die folgenden Parameter können bearbeitet werden:

• "Folder": "" – Gibt den Zielordner an, in den Sie die XAML-Dateien migrieren möchten.
• "SourceBrowser": "IE" – Gibt den Quellbrowser an. Die möglichen Optionen sind IE, Chrome, Edge, Firefox.
• "DestinationBrowser": "Chrome" – Gibt den Zielbrowser an. Die möglichen Optionen sind Chrome, Edge, Firefox.
• "PreviewChanges": false – Wenn dieser Parameter auf true festgelegt wird, werden die ursprünglichen Dateien nicht verändert, und es wird nur ein Änderungsprotokoll generiert. Wenn er auf false festgelegt wird, werden die Aktualisierungen auf die XAML-Quelldateien angewendet.
• "ReplaceNullBrowserType": true – Wenn dieser Parameter auf true festgelegt wird und BrowserType = null gefunden wird, wird die Einstellung zu BrowserType = targetBrowser geändert. Wenn er auf false festgelegt wird, werden diese Fälle ignoriert.
• "IncludeSubfolders": true – Wenn dieser Parameter auf true festgelegt wird, werden alle XAML-Dateien aus dem angegebenen Ordner und seinen Unterordnern verändert. Wenn er auf false festgelegt ist, werden nur die Dateien im übergeordneten Zielordner verändert.
• "CreateBackupFiles": true – Wenn dieser Parameter auf true festgelegt wird, werden Sicherungsdateien (.bak) erstellt, bevor die ursprünglichen aktualisiert werden. Die Sicherungsdateien finden Sie unter {SourceFolder}/.conversion_backup. Wenn er auf false festgelegt wird, werden keine Sicherungsdateien erstellt.
• "EnableLogging": true – Wenn dieser Parameter auf true festlegt wird, wird eine Protokolldatei erstellt. Wenn er auf false festgelegt wird, wird keine Protokolldatei erstellt.

Verwenden des UiPath-Browsermigrationstools

Über die Benutzeroberfläche

Um das Tool zu verwenden, müssen Sie zuerst den Pfad zum Workflow, den Sie migrieren möchten, im Abschnitt Projektordner angeben.

Dann wählen Sie den Browser, mit dem Sie die Automatisierung erstellt haben, im Dropdownmenü Quellbrowser aus. Den Browser, zu dem Sie migrieren möchten, wählen Sie im Dropdownmenü Zielbrowser aus.

Wichtig: Wenn Sie eine mit Internet Explorer erstellte Automatisierung haben und diese zu Firefoxmigrieren möchten, wählen Sie IE in der Dropdownliste Quellbrowser und Firefox in der Dropdownliste Zielbrowser aus.

Über die Schaltfläche Vorschau der Änderungen wird das Tool im Vorschaumodus für die Änderungen ausgeführt. Dadurch werden alle .xaml-Dateien gescannt und die anwendbaren Änderungen in der UiPath.ConversionTool_log.json-Protokolldatei ausgegeben, die im Zielordner generiert wird. Der Workflow selbst bleibt unverändert und es werden keine Sicherungsdateien erstellt.

Über die Schaltfläche Start wird die Migration für den angegebenen Workflow ausgeführt, wodurch er mit dem Browser Ihrer Wahl kompatibel wird.

Von der Kommandozeile aus

Um das Tool mit den Einstellungen zu verwenden, die in der Settings.json-Datei konfiguriert sind, führen Sie den Befehl {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json aus.

Verifizierungsschlüssel nach der Migration

Nach der Verwendung erstellt das UiPath Browser-Migrationstool eine Protokolldatei mit dem Namen UiPath.ConversionTool_log im Projektordner. Die Datei bietet einen Überblick über den Prozess unter dem Parameter "GlobalStatistics" und vollständige Aktualisierungsdetails für jede XAML-Datei unter dem Parameter "FileChanges/FileName/Statistics" .

Andere Aspekte der Migration

Wenn Sie die Automatisierungen zu Edge (Chromium) migrieren möchten, ist dies möglich ab:

• Studio-Version v19.10.5 und UiPath.UIAutomation.Activities v19.11.3
• Studio-Version v20.4.1 und UiPath.UIAutomation.Activities v20.4.1

Wenn Sie sie nach der Migration unter Edge Chromium mit aktiviertem IE-Modus ausführen möchten, ist dies ab UiPath.UIAutomation.Activities v20.10 verfügbar.

Bitte beachten Sie, dass zum Ausführen von Automatisierungen mit Chrome, Edge oder Firefox die richtige UiPath-Erweiterung installiert werden muss.