Safari 向けの拡張機能

UiPath.UIAutomation.Activities バージョン 24.10.0 から、Safari の UI 要素の自動化がプレビューでサポートされるようになりました。Safari 拡張機能を使用すると、以下を実行できます。

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

このようなオートメーションを作成および実行するには、UiPath Browser Automation Safari 拡張機能をインストールする必要があります。

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

注:

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

インストール

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

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

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

   

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

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

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

   

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

   

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

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

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

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

結果

A message informs you that the extension is now available.

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

App Store から UiPath Safari 拡張機能に直接アクセスし、インストール プロセスを前のセクションの手順 4 から続行できます。

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

Studio Web から、または App Store から直接 Safari 拡張機能をインストールすると、ネイティブ ホスト コンポーネントもインストールされます。つまり、UiPath Assistant からオートメーションを実行することができ、追加でインストールを行う必要はありません。

UiPath Assistant を使用したインストールは、UiPath Assistant がすでにインストールされている限り、数回クリックするだけで追加の設定を行う必要はありません。この方法では、Web ストアに公開されている最新の拡張機能バージョンを 現在のユーザー に対してのみインストールできます。

インストール手順

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

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

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

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

5. [ App Store for Safari で表示] を選択します。

   

6. [インストール] を選択します。

7. [開く] を選択します。

8. 拡張機能に必要な手順に従います。

結果

The extension is installed and enabled in Safari.

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

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

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

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

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

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

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

UiPath では、拡張機能のインストールを管理するためのツールとして UiPath.ExtensionControl.Portable.dllを提供しています。このツールは UiPath Assistant とともに配布されます。 UiPath Assistant には、アーカイブとしてパッケージ化された拡張アプリケーションも含まれています。

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

警告:

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

前提条件

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

インストール手順

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

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

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

アンインストール

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

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

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

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

   

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

   

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

   

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

   

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

      

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

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

      

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

   

結果

The extension is uninstalled. It is removed from the Safari extension bar and from the Safari Settings Extensions tab.

アクセシビリティの設定

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

次の手順を行います。

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

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

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

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

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

   

結果

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

既知の制限事項

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

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