用户界面自动化活动

上次更新日期 2024年12月4日

UiPath 浏览器迁移工具

UiPath 浏览器迁移工具是一个独立的工具，可使用目标浏览器（例如 Internet Explorer、Chrome、Edge 或 Firefox）转换工作流，使其面向另一个浏览器，例如 Chrome、Edge 或 Firefox。将工作流从旧版 Internet Explorer 浏览器迁移到较新的浏览器时，或者只是在您希望调整工作流以使用其他浏览器时，此工具非常有用。

此工具与使用任何 Studio 或 UIAutomation 版本生成的任何 XAML 文件兼容。

无法使用此工具自动迁移某些类型的选取器。例如，以 <wnd… 开头的选取器，因为与 Edge/Chrome/Firefox 相比，这些选取器标识了 IE 呈现的不同用户界面元素。这些选取器必须手动更新。

UiPath 浏览器迁移工具的工作原理

为了将工作流从使用一个浏览器迁移到另一个浏览器，需要完成一系列工作，如下所示：

<html...> 选取器通过更新其 app 属性进行迁移。
打开浏览器和附加浏览器活动的浏览器类型属性会相应地进行修改。
任何以源浏览器为目标的终止流程活动都会更新为针对目标浏览器。
源代码浏览器中定义的对象存储库项目将转换为使用目标浏览器。

注意：迁移工具的成功率不是 100％。为了更接近此速率，建议对迁移的工作流执行验证。

安装 UiPath 浏览器迁移工具

首先，从 Automation Cloud Portal 的资源中心下载压缩后的工具（帮助菜单 >“下载” >“UiPath 工具” >“浏览器迁移工具”）。

接下来，将存档解压缩到您选择的文件夹中。

运行 UiPath.ConversionTool.exe 可执行文件将打开 UiPath 转换工具。

配置 UiPath 浏览器迁移工具

可以通过编辑安装文件夹中的 Settings.json 文件来配置 UiPath 浏览器迁移工具。

可以编辑以下参数：

"Folder": "" - 指定要将 XAML 文件迁移到的目标文件夹。
"SourceBrowser": "IE" - 指定源浏览器。可能的选项包括 IE、Chrome、Edge、Firefox。
"DestinationBrowser": "Chrome" - 指定目标浏览器，可能的选项包括 Chrome、Edge、Firefox。
"PreviewChanges": false - 如果设置为 true，则不修改原始文件，仅生成更改日志。如果设置为 false，则更新将应用于源 XAML 文件。
"ReplaceNullBrowserType": true - 如果设置为 true，则 BrowserType = null 将更新为 BrowserType = targetBrowser。如果设置为 false，则忽略这些大小写。
"IncludeSubfolders": true - 如果设置为 true，则修改指定文件夹及其子文件夹中的所有 XAML 文件。如果设置为 false，则仅修改目标父文件夹中的文件。
"CreateBackupFiles": true - 如果设置为 true，则在更新原始文件之前创建备份文件（.bak）。备份文件可在 {SourceFolder}/.conversion_backup 中找到。如果设置为 false，则不会创建备份文件。
"EnableLogging": true - 如果设置为 true，则创建一个日志文件。如果设置为 false，则不会创建任何日志文件。

使用 UiPath 浏览器迁移工具

来自用户界面

要使用该工具，您必须首先在项目文件夹部分中提供要迁移的工作流的路径。

接下来，在源浏览器下拉菜单中选择创建自动化所用的浏览器，并在目标浏览器下拉菜单中选择要迁移到的浏览器。

重要提示：如果您使用 Internet Explorer 创建了自动化，并且想要将其迁移到 Firefox ，请在“ 源浏览器 ” 下拉列表中选择 IE ，并在“ 目标浏览器” 下拉列表中选择Firefox 。

预览更改按钮以预览更改模式运行该工具。这将扫描所有 .xaml 文件，并输出将应用到目标文件夹中生成的 UiPath.ConversionTool_log.json 日志文件中的更改。系统不会对实际工作流应用任何更改，也不会创建任何备份文件。

开始按钮对指定的工作流执行迁移，使其与您选择的浏览器兼容。

使用命令行

要将工具与 Settings.json 文件中的配置一起使用，请运行命令 {ConversionToolInstallationFolder}/UiPath.ConversionTool.exe settings.json

迁移后验证密钥

使用后，UiPath 浏览器迁移工具会在项目文件夹中创建一个名为 UiPath.ConversionTool_log 的日志文件。该文件在 "GlobalStatistics" 参数下提供流程的概述，并在 "FileChanges/FileName/Statistics" 参数下提供每个 XAML 文件的完整更新详细信息。