Paginate: set a maximum page index

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

Paginate関数カードを使用する場合、関数の反復回数を制御することが重要です。Okta Workflowsでは、この関数の反復回数が5,000回に制限されます。そのため、フローをテストする際には、この回数を超えないことが重要です。

この例では、max_page_indexを10に設定し、そのインデックスに達したらページネーションを停止する方法を示します。

ヒント:

この関数カードの使用を開始するには、「ページネーション」を、このカードの使用時のその他のベストプラクティスについては「ページネーション：APIエンドポイント」を参照してください。

Constructオブジェクトカードを使用して、3つのキーと値のペアを含むオブジェクトを作成します。たとえば、次のようなキーが考えられます。

その後、生成されたオブジェクト（object）をPaginate関数カードに渡すことができます。

{
  "page_index": 0,
  "max_page_index": 10,
  "break": false
}

ヘルパーフロー

Paginate関数にはヘルパーフローが必要です。ヘルパーフローで定義される入力は、ページネーションオブジェクト（object）で定義したキーと一致する必要があります。

ヘルパーフローの実行時に、フローに渡される値を管理する必要があります。ページネーション関数によって行われる反復回数を追跡することが目的であるため、反復ごとにpage_indexの値を増やす必要があります。これを行うには、Add数値関数カードを使用します。

次に、ページネーションオブジェクト（object）をPaginate関数カードに返せるように新しく再構築します。

生成されるオブジェクト（object）の値は次のようになります。

{
  "page_index": 1,
  "max_page_index": 10,
  "break": false
}

フローが反復すると、カウンターが増加します。page_indexが10に到達（max_page_indexに一致）した後にPagination関数の反復を停止するには、オブジェクト（object）からbreakを削除する必要があります。

ヘルパーフロー内にIf/Else分岐関数を追加します。比較（Compare）フィールドに、new_indexがmax_page_indexに等しいかどうかをチェックすることを入力します。

保存（Save）をクリックします。
FALSEの場合に実行（Run when FALSE）行では、更新されたオブジェクトをAssignカードにドラッグできます。オブジェクトは、If/Elseカードを変更せずにそのままにします。
TRUEの場合に実行（Run when TRUE）行（page_indexがmax_page_indexに等しくなったときにトリガーされます）で、Unsetオブジェクト関数を追加してbreakキーを削除します。生成されたページネーションオブジェクト（object）が親フローに返されると、Paginate関数はbreakパスをチェックします。そのパスが更新されたオブジェクト（object）に見つからない場合、関数はページネーションを停止して完了します。
出力を作成（Create outputs）をクリックし、出力（Output）フィールドをReturnフロー制御カードにドラッグします。
各行から出力オブジェクト（object）を、trueまたはfalseのテスト結果に対応する出力（Outputs）フィールドにドラッグします。

親フローを実行すると、最終的なオブジェクト（object）は次のようになります。

{
  "page_index": 10,
  "max_page_index": 10
}