desire2learn - get リクエストの Valence ページネーション

Question

ページネーションについていくつか質問があります。

1. ページネーションを強制できますか?
2. ページネーションを制御できますか (例: 200 レコードのページを要求する)?
3. 1 と 2 の答えが「いいえ」の場合、ページネーションが発生するときのしきい値はどれくらいですか?
4. ページネーションは安定していますか (同じエンティティの同じ数のレコードは、常にページ付けされるか、ページ付けされないかのいずれかになります)?

ありがとう、

ヴラド

Answer 1

1. ページネーションは、特定の API 呼び出しで使用されると強制されます。見つかったレコードの数に関係なく、その呼び出しは常にページ単位でデータを返します。デフォルトでページネーションされない呼び出しでページネーションをリクエストすることはできません。呼び出しは、ページ付けされるか、されないかのいずれかです。

2. 現在、データ ページのサイズの変更をリクエストすることはできません。ページ セットの各ページで返されるレコードの数は、ページを使用する呼び出しごとに固定されます (理論的には、ページ サイズはそのような呼び出しごとに異なる可能性がありますが、実際には (現在) 異なります)。

3. しきい値はありません。呼び出しのデータがページ化された結果セットで返されるか、返されないかのいずれかです。一致する結果の数がページ サイズよりも少ない場合でも、呼び出しは、ページ化された結果セット構造内に 1 つのデータ ページを返す必要があります。プロパティ セットは、それ以上データ ページが使用できないことを示します。

4. はい、安定しています: ページ化された結果を伴う呼び出しは常にページ化された結果を返し、ページで返される結果の数は静的のままであると信頼できます (サービスの製品バージョンが変更されない限り: 製品のアップグレード)ページ化された結果のデータ ページのサイズが変更される場合があります)。

ページ サイズの変更に対応できないコードや、ページ サイズが何であるかを知る必要があるコードは記述しないでください ( API コントラクト バージョンを変更しなくても新しい製品バージョンで変更できるため)。 API 呼び出しAからの戻り値が常にページングされると想定するコードを記述します(ドキュメントにページングされた結果が返されると記載されている場合)。