Webhookの実行モードを有効化する
エンドユーザーがデプロイ済みのWebhookイベントカードをフローの一部として使用している場合は、実行モードを有効化(Enable Run mode)オプションの含意を理解することが重要です。このオプションは、Webhookまたはサービスが一度に複数のレコードを送信する場合に有効にします。
コネクタービルダーでこのオプションが有効になっている場合、カードのエンドユーザーはフローでデータを処理する方法を選択できます。エンドユーザーは、受信ペイロードをバッチとして処理するか、WorkflowsでFor Each関数を実行し、ペイロードで返されるアイテムごとに新しいフローを実行するかを選択できます。
アクティブ
実行モードを有効化(Enable Run mode)オプションがアクティブになってる場合、Webhookイベントはペイロードが1つのバッチに格納された複数のレコードで構成されていると想定します。リターンカードは単一のリストを配信しますが、各リストアイテムは定義済みの出力に一致するキーを含むオブジェクトです。これにより、ペイロードと定義済みの出力フィールドの間に1対多のマッピングが作成されます。
ユーザーがフローで実行モード(Run mode)オプションをクリックするときには、次の2つの選択肢があります。
-
各レコード(Each record):ペイロードのレコードのバッチに含まれているアイテムごとにフローを1回実行します。
-
レコードのリスト(List of records):ペイロードのレコードのコレクション全体に対してフローを1回実行します。ユーザーがこのオプションを選択した場合、出力はオブジェクトのリストであり、ペイロードの各レコードが個別のオブジェクトになります。
非アクティブ
実行モードを有効化(Enable Run mode)オプションがアクティブになっていない場合、Webhookイベントカードはペイロードが個別のレコードであると想定します。リターンカードは、すべての定義済み出力フィールドを、ペイロードと出力フィールド間の1対1のマッピングで配信します。
このWebhookを使用するフローはすべて、受信したイベントごとに1回だけ実行されます。