UI Automation のアクティビティ

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

ブラウザーを開く

UiPath.Core.Activities.OpenBrowser

指定した URL でブラウザーを開き、その中で複数のアクティビティを実行できるコンテナーです。

注意:

ブラウザーが内部 URL をコマンドライン引数として直接受け入れない場合は、このアクティビティを使用して内部 URL を開くことができません。

Chrome (chrome://) または Edge (edge://) の内部ページを開くことはできません。ただし、Firefox (about:) の内部ページを開くことはできます。

アクティビティの本体

デザイナーパネルでは、アクティビティはコンテナーとして表示され、指定したブラウザーと対話するためのアクティビティを追加できます。

URL フィールドでは、ブラウザーが開くリンクを指定できます。

URL フィールドの横にあるボタンをクリックすると、現在の設定で新しいブラウザーセッションが開きます。これにより、既存の設定を維持したまま、新しいブラウザーのユーザーデータセットを使用できるようになります。この機能は、ピクチャインピクチャでブラウザーを自動化する場合に特に便利です。

シーケンスも存在します。これは、ブラウザーで実行されたアクションが追加される場所です。

プロパティ

共通

エラー発生時に実行を継続 - アクティビティが例外をスローした場合でも、ワークフローを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白で例外がスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

注: このアクティビティが [トライキャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
表示名 - アクティビティの表示名です。

入力

ブラウザーの種類 - ドロップダウンボタンを使用して、使用するブラウザーの種類を選択します。使用できるオプションは、IE、Firefox、Chrome、Edge、カスタムです。カスタムは、その他の Chromium ベースのブラウザー (JxBrowser) に適しています。ブラウザーの種類にカスタムを使用する場合、[非表示] プロパティはサポートされません。カスタムブラウザーの構成に関する詳細は、「カスタムブラウザー」のセクションをご覧ください。

注: [ブラウザーの種類] プロパティを [カスタム] に設定している場合、適切な動作にするには [通信方法] プロパティを WebDriver に設定する必要があります。
Url - 指定したブラウザーで開く URL です。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

WebDriver を自動ダウンロード - オンにすると、必要な WebDriver 実行可能ファイルをインターネットから %localappdata%\UiPath\WebdriverExe フォルダーに自動的にダウンロードします。既定では、このチェックボックスはオフになっています。
通信方法 - 通信方法を選択してください。使用できるオプションは、ネイティブ、WebDriver です。
Hidden - 隠しブラウザーを開きます。
新しいセッション - 選択したブラウザーの新しいセッションを開始します。このオプションは Internet Explorer に固有です。
Private - プライベートセッションまたはシークレットセッションを開きます。
ユーザーデータフォルダーモード - 設定するユーザーデータフォルダーモードです。特定のユーザーデータフォルダーでブラウザーを開始するために使用します。
- UserDataFolderMode.Automatic - ピクチャインピクチャ (PIP) モードでは既定のモードと異なるフォルダーを使用します。[ユーザーデータフォルダーパス] が設定されていない場合はフォルダーが自動で生成されます。
- UserDataFolderMode.DefaultFolder - メインまたは PIP セッションのどちらで実行されても、既定のブラウザーフォルダーを使用します。
- UserDataFolderMode.CustomFolder - [ユーザーデータフォルダーパス] で指定したフォルダー、またはパスが設定されていない場合は自動生成したパスを使用します。
ユーザーデータフォルダーパス - ブラウザーが使用するユーザーデータフォルダーです。設定されていない場合、既定で %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType になります。

ユーザーデータフォルダーモードとユーザーデータフォルダーパスについて詳しくは、こちらをご覧ください。

出力

UI ブラウザー - アクティビティの結果 (UiBrowser オブジェクト) です。ブラウザーセッションに関するすべての情報を格納します。Browser 変数のみサポートされています。

カスタムブラウザー

カスタム ブラウザーとは、広く使用されているブラウザー (Chrome、Chromium Edge、Firefox、IE など) 以外の、Chromium プロジェクトを基盤として構築されたブラウザーを指します。UiPath では、このようなブラウザーとして、Chromium Embedded Framework (CEF) によって構築されたブラウザーと、JxBrowser フレームワークを使用したブラウザーをサポートしています。

これらのカスタムブラウザーは、WebDriver による通信方法を使用することで自動化できます。

これを実現するには、Chromium ベースのあらゆるブラウザーと同様の方法で、カスタムブラウザーがコマンドラインパラメーター --remote-debugging-port をサポートしている必要があります。

カスタムブラウザーを設定する

使用するカスタムブラウザーでは、その構築基盤となった Chromium のバージョンに適した chromedriver.exe 実行可能ファイルが PATH に配置されている必要があります。

レジストリキー Software\UiPath\UiPath Platform\CustomBrowser の HKEY_CURRENT_USER または HKEY_LOCAL_MACHINE の Command の値には、カスタムブラウザーの実行可能ファイルへのパス、またはカスタムブラウザーを起動するコマンドを設定する必要があります。

カスタムブラウザーの実行インスタンスを 1 つのみに制限し、セキュリティ上の理由から、カスタムブラウザーとの通信に使用する remote-debugging-port を指定する必要がある場合は、Command を指定したときと同じレジストリキーにレジストリ値 RemoteDebuggingPort を追加する必要があります。

このようなカスタムブラウザーのページで使用するセレクターでは、ブラウザーアプリの名前が custom_browser になります。