外部イベントを使用して外部コンテキストを設定する

外部イベントは、親ウィンドウと子ウィンドウ (iframe) に埋め込まれたアプリとの間でセキュリティで保護されたデータ交換を可能にする、カスタムのウィンドウ間通信メッセージです。これにより、実行時に、アプリは設定された外部イベントをリッスンして、関連するオートメーションを実行できます。

外部イベントがもたらすもの:

• イベントドリブンなアーキテクチャ - カスタムのイベントの種類に基づいて特定のアクションをトリガーします。
• セキュリティで保護されたメッセージング - 信頼できる発信元間でのみ通信が行われるようにします。
• リアルタイムのデータ交換 - ホスト アプリケーションと埋め込み UiPath Apps 間の動的な対話を可能にします。

前提条件

外部イベント機能は、 UiPath Communication Driver に依存しています。UiPath Communication Driver は、クロスウィンドウ メッセージング用の軽量で安全な通信ライブラリです。

UiPath Communication Driver をホスト プラットフォームにインストールする必要があります。npm パッケージのページに移動してドライバーをダウンロードし、インストールと使用方法の詳細なドキュメントをお読みください。

外部イベントを有効化する

1. アプリを開きます。

2. プロジェクト エクスプローラーで [アプリ ] を右クリックし、[ プロパティ] を選択します。

3. [ 外部イベント ] セクションを展開し、[ 有効化] を選択します。

4. [許可されたオリジン] フィールドに、ホスト アプリケーションのドメインを入力します。URL のコンマ区切りのリストを追加して、複数のエントリを追加できます。許可されたオリジンは、外部イベントのセキュリティにとって重要です。許可されたオリジンを定義すると、次のことが可能になります。

   • メッセージソースの検証 - 指定された発信元からのメッセージのみを処理します。
   • 対象を絞ったメッセージ配信 - 応答が目的の受信者に確実に届くようにします。
   • CSRF 攻撃の防止 - 不正なクロスサイトリクエストをブロックします。
   • データの整合性を維持する - 信頼できる通信チャネルを確保します。

   

外部イベントを作成する

1. アプリを開き、プロジェクト エクスプローラーでページを選択します。

2. [プロパティ] パネルの [イベント] タブに移動します。

3. [ 外部イベントを作成] を選択します。

4. 外部イベントのわかりやすい名前を入力します。

   

5. [ ワークフロー ファイルを定義 ] を選択して、定義済みのイベントに対して実行されるワークフロー ファイルを設定します。外部イベントで受け取ったデータは、 ExternalEventData という名前のワークフロー引数で使用できます。