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回だけ実行されます。