カーソル

この関数カードはWorkflowsコネクタービルダーでのみ使用可能です。

この関数カードは、ポーリング監視イベントフロー内でのみ機能します。

カーソル（Cursor）カードが実行されると、フローのメタデータに値が保存され、ポーリング監視のスケジュールされた実行のAPIクエリをフィルタリングするために使用できます。

この値は、デプロイされたポーリング監視を使用してユーザーが作成する各フローに固有です。

通常、カーソルはAPIクエリフィルターとして使用するためのタイムスタンプ値を保存します。また、以前に記録された識別子のリストなど、ポーリング要求の状態値を保存することもできます。

ポーリング モニター イベントでカーソルを実装する最も簡単な方法は、タイムスタンプを使用して API をクエリすることです。このメソッドは新しいレコードまたは更新されたレコードを返します。ポーリング間で他のメタデータを保持するために複雑なカーソル オブジェクトは必要ありません。

カーソル（Cursor）カードを追加する

コネクタービルダーでポーリング監視イベントを作成すると、イベントカードにはカーソル（Cursor）という名前の出力が含まれます。ポーリング監視イベントを作成すると、プロパティー（Properties）（Cursor）という名前の単一の入力が含まれ、出力がないカーソル（Properties）関数カードも追加されます。

ポーリング監視が実行されるたびに、プロパティー（Properties）フィールドに渡される値は、ポーリング監視（Cursor）イベントカードのカーソル（Cursor）（Polling Monitor）フィールドの新しい値になります。

カーソル（Cursor）カードは次の型をサポートします：Date & Time、Number、Text、Object。API呼び出しのフィルターを構築するために必要な任意の形式を使用できます。ポーリング監視（Cursor）カードのカーソル（Cursor）（Polling Monitor）フィールドとカーソル（Properties）関数カードのプロパティー（Properties）（Cursor）入力フィールドで指定された型は一致している必要があります。

ポーリング監視（Polling Monitor）カードを更新する

ポーリング監視が初めて実行されるときは、ポーリング監視（Cursor）イベントカードのカーソル（Cursor）（Polling Monitor）フィールドは空なので、フローでその最初の実行を処理する必要があります。カーソル（Cursor）フィールドが空の場合は、レコードを取得するためにAPIを呼び出すカードをスキップします。たとえば、カーソルにタイムスタンプを使用している場合は、Now関数カードを使用してカーソルを初期化します。ポーリング監視の後続の実行すべてには、フローによってカーソル（Cursor）カードが毎回呼び出されるため、値を持つカーソル（Cursor）フィールドが含まれます。

クエリフィルタリングにカーソルを使用する

今後の実行では、ポーリング監視（Polling Monitor）カードのカーソル（Cursor）フィールドに、前回の実行で割り当てられた値が含まれます。フローは、この値をAPIクエリのフィルターの開始点として、たとえばstartDateというパラメーターとして取得します。

APIクエリの終了点として別のデータポイントを作成します。たとえば、Now関数カードを呼び出すと、新しいendDateパラメーターが提供されます。次に、startDateパラメーターとendDateパラメーターをAPIクエリに指定します。パラメーター名は、APIサービスで指定されたフィルター名によって異なります。時間枠は、ポーリング監視が最後に実行されたときからポーリング監視の現在の実行までの期間です。

APIリクエストのフィルターとしてstartDateパラメーターとendDateパラメーターを使用します。レコードを取得した後、フローはカーソル（Properties）カードのプロパティー（Properties）（Cursor）フィールドを更新し、スケジュールされた次回の実行で使用できるようにします。

カーソル（Cursor）カードを使用したポーリング監視イベントフローの例については、「ポーリング監視イベントフローを構築する」を参照してください。

入力

出力

このアクションカードには出力フィールドがありません。

関連項目

Workflowsの関数

ポーリング監視イベントフローを構築する

コネクタービルダー機能制限