ポーラー
- 最終更新日2026/01/13
ポーラー
ポーラー トリガーは定期的にデータソースを更新のためにチェックします。 設定後、ポーラーはデータソースのポーリング URL を使用して定期的に新しいデータをチェックします。 ポーラー は、リアルタイム更新が利用できない場合や、更新頻度が低い事例に最適です。
概要
ポーラーはポーリングの概念に基づいて動作し、トリガーは定期的にポーリングURLに新しいデータのリクエストを送信します。 ポーラーを設定して、受信するイベント通知を受け取り、その通知に基づいて後続の自動化を開始することができます。 アプリケーションのポーラー URL は、トリガーが新しいイベントをポーリングするためのエンドポイントとして機能します。
ポーラーをGET呼び出しまたはPOST呼び出しのために構成できます。 ポーラーを設定する際には、ヘッダーパラメータ、クエリパラメータ、コンテキスト管理の詳細、および JSON フィルターを追加する必要があります。 POSTオプションには、リクエストボディを追加するための規定が含まれています。 このオプションを使用して、イベントに必要な追加データを要求するポーラーURLにデータを送信できます。
設定
リスナー トリガーで利用可能な設定は次のとおりです。
- 名前
- ポーラー の名前を指定してください
- 投票URL
- アプリケーションのポーリング用URLを指定します。
- リクエストタイプ
- API リクエストタイプを選択してください。ポーラーはGETおよびPOSTメソッドをサポートしています。
- GET - イベントの詳細を取得するには、GET メソッドを使用できます。
- POST - POST メソッドを使用して、レスポンスデータを制限できます。 POST メソッドにはリクエストボディを追加するための規定があります。 このオプションは、レスポンスデータを制限するためのフィルターとして機能します。
- リクエスト ボディ:
- POSTメソッドのリクエストボディを入力してください。 リクエストボディには、TXT、JSON、XML、およびHTMLのような形式で追加できます。
- ポーリング間隔
- URL をポーリングして新しい情報を取得する頻度を設定します。 分、時間、または日の間隔を設定できます。 インターバルの最小限度は5分です。
- 認証モード
- トリガーの認証モードを指定します。 認証なし または OAuth2 - Control Room 管理 のいずれかを選択できます。
- 接続
- Pick ボタンを使用して、既存の OAuth 接続を認証モードとして選択します。 接続が正しく設定され、アクティブであることを確認してください。
- ヘッダーを追加
- ポーリングリクエストに適用されるヘッダーパラメータを指定してください。 リクエストヘッダーに含める必要がある認証ヘッダーやその他のユニークなパラメータを追加できます。
- クエリパラメーターの追加
- ポーリングリクエストに適用可能なクエリパラメータを指定してください。 チェックボックスを有効にして、ヘッダーを追加をクリックして項目モーダルを開きます。
- コンテキスト管理
- 任意の動的パラメータのコンテキスト管理を定義します。 トリガーは、最後のチェックポイント以降に更新された情報を取得することを保証するために、コンテキストをポーリングチェックポイントとして使用します。 ポーリング URL、ヘッダーおよびクエリパラメータのためのコンテキスト管理を定義できます。 パラメータを文字列として定義し、その文字列を使用してコンテキストを定義します。
- JSON フィルター
- 応答データのフィルターを指定してください。 この設定では、要件に応じてデータをフィルタリングできます。 例えば、JSONデータに1、5、10、25、30のような複数の長さのレコードが含まれている場合、JSONフィルターを record.length>10 として定義できます。このフィルターは、長さが10未満のレコードを破棄します。
- レスポンス
- トリガー応答データを保存するレコード変数を選択します。 自動化はトリガー応答データをキーと値のペア形式で保存します。 Botを実行した後、監査ログページに移動し、トリガーによる Bot 実行イベントを選択してレスポンスデータを確認してください。