Safari 向けの拡張機能

UiPath Safari 拡張機能をインストールして設定し、Studio Web およびローカルの macOS ロボットを使用して macOS 上の Safari で UI オートメーションを自動化できるようにします。

Starting with UiPath.UIAutomation.Activities version 24.10.0, Safari UI Automation support is available in preview. The extension for Safari lets you:

• macOS 上の Safari ブラウザー内の Studio Web で UI オートメーションをデザインする。
• インストール済みで Orchestrator に接続されたローカルの macOS ロボットを使用して、Safari でブラウザー オートメーション実行する。
• macOS 用の Assistant を使用して、Safari でブラウザーの有人オートメーションを開始する。

To create and run such automations, you must install the UiPath Browser Automation extension for Safari.

Studio Web から操作を開始するには、任意の UI Automation アクティビティを追加します。Safari から Studio Web にアクセスすると、App Store から UiPath Safari 拡張機能をインストールするよう求められます。セットアップ ガイドに従って拡張機能を構成してから、Safari でブラウザー オートメーション用のワークフローのデザインを開始します。

注:

macOS を実行しているマシン上の Safari でブラウザー オートメーションを作成する場合、サポートされる最小バージョンは macOS 12 です。

インストール

Installing the Safari extension also installs the Native Host component. This means that you can run automations from UiPath Assistant without the need for additional installation.

App Store からインストールする

インストール手順

1. Access the UiPath extension for Safari directly in the App Store

2. [入手] を選択して拡張機能をインストールし、[開く] を選択します。

   

3. [開く] を選択すると、設定ウィンドウが表示されます。

   

4. [Open Safari settings] を選択して [機能拡張] ウィンドウにアクセスします。ここで、新しくインストールした拡張機能に適切な権限を設定できます。

   1. 左側のパネルで UiPath Browser Automation 機能拡張を有効化します。

   2. [すべての Web サイトで常に許可 ] を選択し、この選択を確定します。

   3. プライベート ブラウズを使用する場合は、[ プライベートブラウズで許可 ] 設定を有効化します。

結果： 機能拡張が利用可能になったことを通知するメッセージが表示されます。

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

インストール手順

1. UiPath Automation Cloud™ で Studio Web にアクセスします。

2. プロジェクトに [ブラウザーを使用] アクティビティを追加します。UiPath Safari 拡張機能をインストールするよう求められます。

   

3. [拡張機能をインストール] ボタンを選択します。

4. App Store が開き、 UiPath Browser Automation 拡張機能が表示されます。

5. Continue the installation process from step 2 of the Install from App Store section.

結果： 機能拡張が利用可能になったことを通知するメッセージが表示されます。

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

Installation using UiPath Assistant requires no additional configuration, as long as UiPath Assistant is already installed. This method installs the latest extension version published to the Web Store for the current user only.

インストール手順

1. UiPath Assistant にアクセスします。

2. アカウント アイコンを選択します。

3. [ 設定] を選択します。

4. [UiPath 拡張機能] に移動します。

5. Select Install for Safari.

   

注:

Alternatively, select View on App Store to get the extension from the App Store, and then continue from step 2 of the Install from App Store section.

結果： 拡張機能が Safari にインストールされ、有効化されている。

ターミナルからインストールする

ターミナルからのインストールは UiPath.ExtensionControl.Portable.dll経由で行います。

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant, which also includes the latest extension application packaged as an archive.

このメソッドは、Safari の設定を更新して、拡張機能がインストールされていると認識されるようにします。この拡張機能は、現在のユーザーに対してのみインストールされます。

警告:

この方法は、Apple が将来のアップデートで変更する可能性のあるメカニズムに依存しているため、運用環境向けではありません。他に利用できない場合にのみ使用してください。

前提条件

• Safari のすべてのインスタンスが閉じられます。

インストール手順

1. ターミナルを開いて、次のコマンドを実行します。

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll install safari
   

2. Safari を起動してオートメーションを設計および実行します。

結果： 拡張機能が Safari にインストールされ、有効化されている。

MDM を使用してインストールする

MDM (モバイル デバイス管理) アプリケーションを使用してインストールするには、マシンを登録して管理する必要があります。Appleマシンでのデバイス管理の仕組みの詳細については、次のページをご覧ください。 デバイス 管理 |Apple 開発者向けドキュメント。

MDM の例は次のとおりです。

• Jamf(ジャム)
• Microsoft Intune
• カンジ
• MicroMDM (オープンソース)

このメソッドは、新しい 宣言型管理モデル を利用して、構成の変更をマネージド マシンにプッシュします。Safari 拡張機能の構成について詳しくは、 SafariExtensionSettings |Apple 開発者向けドキュメント。

アンインストール

UiPath Assistant からアンインストールする

Uninstall Steps

1. UiPath Assistant にアクセスします。

2. アカウント アイコンを選択します。

3. [ 設定] を選択します。

4. [UiPath 拡張機能] に移動します。

5. Select Uninstall for Safari.

   

Result: The extension is uninstalled and removed from the Applications folder.

ターミナルからアンインストールする

The uninstallation from Terminal is performed via UiPath.ExtensionControl.Portable.dll.

UiPath provides a tool for managing extension installation: UiPath.ExtensionControl.Portable.dll. This tool is distributed with UiPath Assistant.

This method updates the Safari configuration so that the extension is uninstalled. The extension is uninstalled for the current user only.

警告:

この方法は、Apple が将来のアップデートで変更する可能性のあるメカニズムに依存しているため、運用環境向けではありません。他に利用できない場合にのみ使用してください。

前提条件

• Safari のすべてのインスタンスが閉じられます。

Uninstall Steps

1. ターミナルを開いて、次のコマンドを実行します。

    dotnet /Applications/UiPath\ Assistant.app/Contents/Extensions/UiPath.ExtensionControl.Portable.dll uninstall safari
   

Result: The extension is uninstalled and removed from the Applications folder.

Safari の設定からアンインストールする

Uninstall Steps

1. Safari の設定にアクセスします。

2. [機能拡張] タブに移動します。

3. [アンインストール] ボタンを選択します。

   

4. [ Finder で表示 ] ボタンを選択します。これにより、アプリケーションを選択した状態で Finder が開きます。

   

5. UiPath for Safari アプリケーションのコンテキスト メニューを開き、[ごみ箱に入れる] を選択します。

   

   ポップアップ メッセージに、アプリケーションが使用中のため削除できないと示される場合は、次のようにします。

   

   1. アクティビティ モニタを開いて「UiPath Native Host for Safari」を探します。

      

   2. アプリケーションを選択し、[ 停止] を選択してから、[ 終了] を選択します。

   3. Finder に戻り、もう一度 [ ごみ箱に入れる ] を選択します。

      

6. Mac の資格情報を入力し、[ OK ] を選択して削除を承認します。

   

結果： 拡張機能がアンインストールされます。Safari の拡張機能バーと [設定] > [機能拡張] タブから削除されます。

アクセシビリティの設定

入力モードに [ハードウェア イベント] を使用するには、[プライバシーとセキュリティ] の設定を使用して UiPath Assistant に Mac へのアクセス権を付与する必要があります。

次の手順を行います。

1. アップル メニューを選択します。

2. [システム設定] を選択します。

3. 左側のサイドバーで [プライバシーとセキュリティ] を選択します。

4. 右側の矢印を選択して [アクセシビリティ] に移動します。

5. リストから UiPath Assistant を有効化します。アプリケーションが表示されない場合は、リストの下部にある [ + ] を選択し、 UiPath Assistant を検索してアプリケーションを選択し、[ 開く] を選択します。この変更には、Mac の資格情報が要求されます。

   

Result: UiPath Assistant is now authorized to use Hardware Events input mode in Safari automations.

Full Disk Access configuration

To install the Safari extension using UiPath Assistant, you must specifically grant UiPath Assistant access to your Mac files using the Privacy & Security settings.

次の手順を行います。

1. アップル メニューを選択します。
2. [システム設定] を選択します。
3. 左側のサイドバーで [プライバシーとセキュリティ] を選択します。
4. Go to Full Disk Access by selecting the arrow on the right-hand side.
5. Enable Full Disk Access from the list:
   • If UiPath Assistant is listed, enable it.
   • If UiPath Assistant is not listed, select + at the bottom of the list, search for UiPath Assistant, select the application, and choose Open.

注:

この変更には、Mac の資格情報が要求されます。

Result: UiPath Assistant is now authorized to edit the files on your Mac.

既知の制限事項

Safari 用のブラウザー オートメーションを作成する際は、以下の制限事項を考慮に入れてください。

• この拡張機能はファイル URL にはアクセスできません。これは Safari の制限であり、Apple Developer フォーラムのこちらのスレッド (「Allow access to file URLs for web extensions」) で説明されています。
• この拡張機能は複数のプロファイルをサポートしていません。