ページネーション

ページネーションとは、大量のデータを複数のページに分割して取得ができる仕組みです。

SaaSごとにページングのサイズが異なったり、ページネーションの設定方法が異なります。そのため、各SaaSのAPIドキュメントを確認しながらページネーションを構築してください。

今回はSlackBotでユーザー一覧を取得する際にページネーションで取得する方法をご紹介します。200件ずつAPIでユーザーを取得し、1つのデータに格納していく使い方をご紹介します。

今回作成するページネーションの流れは下記の通りです。

ソリューションの詳細な作り方は下記をご確認ください。

詳細については下記を参照してください。

変数アクションを追加します。

[Formulaで変数を作成]を選択します。
- 変数定義：手動追加します。追加する定義は下記の通りです。
  - 名前[next cursor]、型[String]で、追加します。
- 変数のオブジェクト：入力をFormulaに変更し、[None]と入力します。

もう1つ変数アクションを追加します。

JSONを入力するモーダルが表示されるので、以下のJSONをコピーして貼り付けます。

{  
  "user_list": [  
    {  
      "user": {}  
    }  
  ]  
}

変数を作成できたら、[ユーザー一覧を取得]のステップを修正します。

次にリストを作成します。

次に繰り返しを設定します。繰り返しアクションを設定しないとリストを受け取ることができません。

[+]ボタンをクリックし、[繰り返し]ステップを選択します。
- 繰り返すリスト：変数の[リスト]を選択します。
- 繰り返しモード：[アイテムごとに繰り返す]を選択します。

繰り返しステップの中にユーザー一覧を取得のステップを移動させます。

次に繰り返しユーザー一覧を取得するために変数の更新を2つ設定します。

1つ目の変数の更新

ステップを追加しアクションから変数を選択します。
- 変数を更新を選択します。
  - 変数選択：[next cursor]を選択します。
  - オブジェクト：変数の[NextCursor]を選択します。

2つ目の変数の更新

ステップを追加しアクションから変数を選択します。
- 変数を更新を選択します。
  - 変数選択：変数の[user_list]を選択します。
  - オブジェクト：変数を使用します。入力をFormulaに変更し、下記のように入力します。

[list(user_list | Step4)] + [(Members | Step7)]

リストで設定したページよりも件数が少なかった場合に、取得を終了するステップを追加します。

リストでユーザー一覧を取得した場合、レスポンスペイロードが変わるため、設定を修正します。

レスポンス名を[user_list]に変更します。
- リストソース：変数の[user_list]を選択します。
- id：変数を使用します。入力をFormulaに変更し、下記のように入力します。

[i番目のuser | Step4]["id"]

以上で設定は終了です。テストして成功するか確認してください。

この設定により、ページネーションによりデータを取得することができました。

最終更新 1 か月前