UI Automation のアクティビティ

最終更新日時 2024年12月20日

UiPath ブラウザー移行ツール

UiPath ブラウザー移行ツールは、対象となる Internet Explorer、Chrome、Edge、Firefox などのブラウザーを使用するワークフローを、それとは別の Chrome、Edge、Firefox などのブラウザーを対象としたものに変更するスタンドアロンのツールです。ワークフローをレガシーの Internet Explorer ブラウザーから新しいブラウザーに移行したり、他のブラウザーで使用できるようにしたりする場合に便利です。

このツールは、Studio または UI Automation のすべてのバージョンで生成される、すべての XAML ファイルと互換性があります。

注: セレクターの種類によっては、このツールでは自動的に移行できないものがあります。たとえば、<wnd… で始まるセレクターです。これらは、IE と Edge/Chrome/Firefox とで表示が異なる UI 要素を識別するセレクターだからです。このようなセレクターは手動で更新する必要があります。

UiPath ブラウザー移行ツールの動作のしくみ

あるブラウザーを使用していたワークフローを移行して別のブラウザーを使用できるようにするには、以下の一連の作業を行う必要があります。

<html...> セレクターが app プロパティを更新することで移行されます。
[ブラウザーを開く] アクティビティと [ブラウザーにアタッチ] アクティビティの [ブラウザーの種類] プロパティが、適宜変更されます。
移行元ブラウザーを対象としたすべての [プロセスを強制終了] アクティビティが、移行先ブラウザーを対象としたものに更新されます。
ソースブラウザーで定義したオブジェクトリポジトリの項目は、対象のブラウザーを使用するように変換されます。

注: 移行ツールの成功率は 100% ではありません。100% に近づけるために、移行するワークフローに対して検証を実行することをお勧めします。

UiPath ブラウザー移行ツールをインストールする

まず、Automation Cloud ポータルのリソースセンターから圧縮されたツールをダウンロードします (ヘルプメニュー > [ダウンロード] > [UiPath ツール] > [ブラウザー移行ツール])。

次に、このアーカイブを任意のフォルダーに解凍します。

実行可能ファイル UiPath.ConversionTool.exe を実行すると、UiPath 変換ツールが開きます。

UiPath ブラウザー移行ツールを設定する

ブラウザー移行ツールは、インストールフォルダーに保存された Settings.json ファイルを編集することで設定できます。

編集できるのは、以下のパラメーターです。

"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 ブラウザー移行ツールを使用する

UI から

ツールを使用するには、まず [プロジェクトフォルダー] セクションで、移行するワークフローへのパスを指定する必要があります。

次に、[移行元ブラウザー] ドロップダウンメニューからオートメーションを作成したブラウザーを選択し、[移行先ブラウザー] ドロップダウンメニューから移行先のブラウザーを選択します。

重要: 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 ファイルごとに更新の詳細が表示されます。