UiPath Data Fabric のイベント

Webhook 通知を使用してレコード レベルの変更時にワークフローをトリガーするように Integration Service で UiPath Data Fabric イベントを設定します。

イベント

Data Fabric のイベントは、エンティティ レコードのステート変更を表します。Data Fabric は Webhook を介して Integration Service にイベントを発行します。サブスクライブしたエンティティでレコード レベルの変更が発生するたびに (例: レコードが作成または更新されるたびに)、Data Fabric は通知を出力し、Integration Service はこの通知をサブスクライブしたワークフロー トリガーにルーティングします。詳しくは、 トリガーに関する こちらのページをご覧ください。

UiPath Data Fabric コネクタは、以下のイベントをサポートしています。

• Record created — 選択したエンティティに、トリガーの構成済みフィルターに一致するレコードが作成されたときに起動します。
• Record updated — 選択したエンティティの既存のレコードが更新され、更新後のステートがトリガーの構成済みフィルターに一致したときに起動します。

UiPath Data Fabric コネクタのイベントは Webhook を介して配信されます。

イベントのプロパティ

イベント エンベロープは、すべての Data Fabric イベントに存在する以下のプロパティで構成されます。

プロパティ	説明
UiPathEvent	イベントの種類 (例: CREATED、 UPDATED)
UiPathEventObjectType	イベントが発生したエンティティ (例: Customer、 Invoice)
UiPathEventObjectId	影響を受けるレコードの一意の識別子 (Id) です (例: 65747f9e-6442-f111-8ef2-000d3a350adf)
UiPathEventConnector	オートメーションを開始したコネクタ (常に uipath-uipath-dataservice)

イベントの出力

UiPath Data Fabric の各イベントは、エンティティ レコードへの参照を出力します。出力には、トリガー接続ユーザーの権限に基づいて、選択したエンティティでアクセスできるすべてのフィールドが含まれます。

イベント	出力の種類
レコードの作成時	エンティティ レコード
レコードの更新時	エンティティ レコード

トリガー接続の権限とイベントの送信について詳しくは、「 セキュリティの改善」をご覧ください。

接続トリガー

接続トリガーを使用すると、ワークフローはイベント エンベロープのプロパティで開始されます (レコード ペイロードは含まれません)。ただし、トリガー アクティビティは、このレコード ペイロードを自動的に生成します。Integration Service のイベント トリガーの使用方法について詳しくは、「 Integration Service でトリガーを使用する」をご覧ください。

動作

• トリガー アクティビティの [ output ] プロパティは、 影響を受けるエンティティ レコードであり、エンティティのスキーマとして型指定されます。フィールドの種類、形式、およびアクセシビリティは、設計時にエンティティのメタデータから派生します。
• このワークフローでは、追加の設定なしに、 output から直接フィールドを読み取って下流のアクティビティで使用できます。
• イベント エンベロープのプロパティ (UiPathEvent、 UiPathEventObjectIdなど) は、解決されたレコードと一緒に引き続き使用できます。

接続していないトリガー

接続していないトリガーを使用すると、ワークフローはイベントエンベローププロパティでのみ開始されます—影響を受けるレコードのペイロードはワークフローに入力されません。ワークフロー作成者は、イベントで保持される識別子を使用して、レコードを自分で取得することが期待されます。Integration Service のイベント トリガーの使用方法について詳しくは、「 Integration Service でトリガーを使用する」をご覧ください。

動作

レコードを読み取るには、ワークフローで以下の操作を行う必要があります。

1. UiPathEventObjectId にバインドされた入力プロパティ (影響を受けるレコードのId) を受け入れます。
   • ワークフローは、必要に応じて、他のイベント エンベロープ プロパティ ( UiPathEventObjectType、 UiPathEvent、 UiPathEventConnectorなど) を入力として受け入れることもできます。
2. 影響を受けるレコードの Idを使用して、トリガーがサブスクライブされているエンティティに対して [エンティティ レコードを ID で取得] アクティビティを呼び出します。
3. 返されたレコードを後続のアクティビティで使用します。