Edge 向け拡張機能

重要: この製品の使用時に、UiPath Inc. およびその関連会社が顧客データを処理、使用、アクセス、または保存することはありません。

重要:

Manifest V2 拡張機能の非推奨化は、2024 年 6 月に開始される予定です。

組織内で Manifest V2 拡張機能が引き続き機能するように ExtensionManifestV2Availability ポリシーを使用している企業では、組織の Manifest V2 拡張機能の移行に、さらに 1 年間 (2025 年 6 月まで) の猶予があります。ポリシーが有効化されているブラウザーは、それまで非推奨化の影響を受けません。

古いバージョンの UiPathStudio.msi を使用してインストールした Edge MV2 に対応する拡張機能が Edge で動作しなくなります。このような問題が発生する前に、UiPath Studio と Robot のインストールをアップグレードすることを強くお勧めします。

MV3 に対応する拡張機能への Edge の移行のタイムラインの全容については、こちらをご覧ください。

Edge MV3 用の UiPath 拡張機能は、次のバージョンの UiPathStudio.msi から利用できます。

• 2022.10
• 2022.4.4+
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

これらのバージョンは UiPath Automation Cloud のリソース センターからダウンロードできます。

この拡張機能を使用すると、Microsoft Edge ブラウザーの操作を自動化できます。この拡張機能は、次に示すように、複数の方法でインストールできます。

UiPath Studio からインストールする

1. Studio を開きます。
2. [ホーム] > [ツール] > [UiPath 拡張機能] に移動します。
3. [Edge] > [インストール] を選択します。ドロップダウンから、利用可能なインストール方法のいずれかを選択します。
   • グループ ポリシー (オフライン)
   • グループ ポリシー (オンライン)
   • すべてのユーザー
   • 現在のユーザー
   • ネイティブ ホストのみ
4. Edge を開き、edge://extensions に移動します。
5. 必要に応じて、 UiPath Web Automation 拡張機能を有効化します。

Studio インストーラーからインストールする

1. UiPathStudio.msi インストーラーを実行します。
2. インストール モードを選択し、[詳細設定] > [拡張機能] > [UiPath Edge Chromium 拡張機能] を選択します。お使いのマシンに Edge がインストールされている場合は、既定でオプションが選択されます。
3. [インストール] をクリックします。Studio のセットアップが続行され、Edge 向け拡張機能もインストールされます。

UiPath Edge 拡張機能は、UiPathStudio.msi のコマンド ラインからインストールすることもできます。

グループ ポリシーからインストールする

グループ ポリシーを使用して UiPath Edge 拡張機能をインストールすることもできます。この方法では、拡張機能がサイレントにインストールされて有効化され、ユーザーによる確認は不要です。

どちらの方法でも、拡張機能がデバッガー API を使用している場合、ブラウザーにバナーが表示されません。

新しいバージョンにアップグレードしても拡張機能 ID は変更されないため、 グループ ポリシーのオフライン インストールを使用することをお勧めします。 この方法では、Edge ウェブ ストアではなく UiPath によって署名された拡張機能を使用します。 つまり、バージョンの更新後に、内部のグループ ポリシー ( つまり、ExtensionInstallForcelist ポリシー) を新しい拡張機能 ID で更新する必要はありません。

同じ拡張機能 ID を再利用するもう 1 つの利点は、拡張機能に設定された設定 ( [InPrivate を許可] や [ファイル URL へのアクセスを許可] など) がバージョンの更新後にリセットされないことです。

オフライン

インストールを実行するには、対象のマシンが Microsoft Active Directory ドメインまたは Azure Active Directory に参加している必要があります。

Edge ウェブ ストアにアクセスする必要がないため、制御された環境で、インターネット アクセスが制限されているマシンに使用できます。

要件が満たされている場合、UiPathStudio.msi は既定でこのインストール方法を使用します。

また、次のコマンドを管理者特権でのコマンド プロンプトから実行してインストールすることもできます。

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-policy-offline /silent

組織がグループ ポリシーを使用してブラウザー拡張機能を管理している場合は、組織のグループ ポリシーの定義にも次の変更を加える必要があります。

1. ExtensionInstallForceList ポリシーに次の値を追加します。

   ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/EdgeExtension_SelfHosted/extension_manifest_edge.xml

2. NativeMessagingAllowList ポリシーに値 com.uipath.chromenativemsg_v2 を追加します。

UiPath 拡張機能を社内用ウェブ ストアでホストする必要がある場合は、.crx ファイルは次の場所にあります。

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_edge_self_hosted_mv3.crx

オンライン

このインストール方法では、対象のマシンが Edge ウェブ ストア (https://edge.microsoft.com/extensionwebstorebase/v1/crx および https://msedgeextensions.sf.tlu.dl.delivery.mp.microsoft.com) にアクセスできるようになっている必要があります。

要件が満たされており、マシンが Microsoft Active Directory に参加していない場合、UiPathStudio.msi はこのインストール方法を使用します。

また、次のコマンドを管理者特権でのコマンド プロンプトから実行してインストールすることもできます。

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-policyglobal /silent

組織がグループ ポリシーを使用してブラウザー拡張機能を管理している場合は、組織のグループ ポリシーの定義にも次の変更を加える必要があります。

1. ExtensionInstallForceList ポリシーに次の値を追加します。

   cdfjcmjmgdnojgaojdnefhjjpaijapci;https://edge.microsoft.com/extensionwebstorebase/v1/crx

2. NativeMessagingAllowList ポリシーに値 com.uipath.chromenativemsg_v2 を追加します。

アンインストールする

UiPath Edge 拡張機能をアンインストールするには、次のコマンドを管理者権限でのコマンド プロンプトから実行します。

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-cleanup /silent

また、Studio の [ツール] > [UiPath 拡張機能] に移動し [Edge] > [アンインストール] を選択してアンインストールすることもできます。拡張機能は、インストールに使用された方法と同じ方法でアンインストールされます。この方法は、[アンインストール] ボタンの横にある無効なドロップダウンリストに表示されます。

Edge バージョンの要件

Edge MV2 に対応する UiPath 拡張機能は、Edge のすべての既存バージョンで利用できます。

Edge MV3 に対応する UiPath 拡張機能は、Edge バージョン 98 以降を必要とします。

上記のいずれかの方法でインストールを行うと、ブラウザーのバージョンが確認され、適切な形式の拡張機能 (MV2 または MV3) が自動的にインストールされます。

拡張機能の新機能

IE モードのサポート

UiPathStudio.msi 2020.10 以降は、UiPath Edge 拡張機能を使用して Internet Explorer モードで実行される Web ページを自動化できるようになりました。

Internet Explorer モードを使用して、Java Applets、Silverlight、ActiveX のコントロールを含む Web ページが自動化できます。

Edge アプリを自動化する

2022.4 以降の UiPathStudio.msi から、UiPath Edge 拡張機能を使用して Edge アプリを自動化できるようになりました。

複数のユーザー プロファイルを持つ複数の Edge インスタンス

バージョン 2023.10 以降の UiPath では、UiPath Edge 拡張機能は複数のユーザー プロファイルで同時に実行される複数のブラウザー インスタンスの自動化をサポートしています。

2023.10 より前のバージョンでは、UiPath Edge 拡張機能は、複数のユーザー プロファイルで同時に実行される複数のブラウザー インスタンスの自動化をサポートしていませんでした。そのため、ブラウザーを自動化する場合は、Edge のアクティブなインスタンスをすべて閉じてから、単一のユーザー プロファイルを使用してブラウザーを再起動する必要がありました。バージョン 2023.10 以降では、複数のブラウザー プロセスが異なるブラウザー プロファイルで実行される場合の自動化もサポートするようになりました。たとえば、特定のアプリケーションを専用のプロファイルで実行して、機密データを他のアプリケーションから分離する必要がある場合などです。

注: 複数のブラウザー プロファイルを自動化するには v2023.10 以降の UiPath.UIAutomation.Activities、および v23.10 以降の UiPathStudio.msi でインストールしたブラウザー拡張機能が必要です。

[アプリケーション/ブラウザーを使用] アクティビティの使用時に、特定のプロファイルでブラウザーを開けるようになりました。ブラウザーの起動時にプロファイルを指定するには、ブラウザーのコマンドラインに引数を追加する必要があります。それには、[統合アプリケーション ターゲット] 入力セクションの [引数] プロパティを使用します。

Edge の場合、必須の引数は --profile-directory="profile_path" です。

この profile_path は、[アプリケーション/ブラウザーを使用] アクティビティに指定した [ユーザー データ フォルダー パス] への相対パスです。[ユーザー データ フォルダー パス] が指定されていない場合、プロファイル パスは既定のユーザー データ ディレクトリ %LOCALAPPDATA%\Microsoft\Edge\User Data% に対する相対パスです。プロファイル パスを確認するには、edge://profile-internals/ に移動し、[Profile Path] エントリから取得します。

トラブルシューティング

システム管理者が設定したグループ ポリシーが原因で、Edge 拡張機能が機能しない場合があります。拡張機能を有効化するには、「Chrome グループ ポリシー」に記載されている手順を行ってください。

UiPath Edge 拡張機能に関するその他の問題については、「Microsoft Edge 拡張機能のトラブルシューティング」の詳しい記載をご覧ください。