URL内のクエリで、表示するレコードの条件を指定する
URL内のクエリで、表示するレコードの条件を指定する
URLのクエリ文字列を使って、表示する一覧を指定する方法や、表示するレコードを絞り込みする方法を説明します。
表示する一覧を指定する
view
パラメーターに表示する一覧のID(VIEW_ID
)を指定します。
https://sample.cybozu.com/k/APP_ID
/?view=VIEW_ID
サンプル
APP_ID
が123で、VIEW_ID
が456の一覧を表示する例です。
https://sample.cybozu.com/k/123/?view=456
表示するレコードを絞り込みする
query
パラメーターにクエリを指定します。
使用できるクエリは、次のページを参照してください。
クエリの書き方
次のオプションを指定しても、表示結果には反映されません。
- limit(表示件数)
- offset(表示を開始する位置)
- order by(表示順)
https://sample.cybozu.com/k/APP_ID
/?query=ENCODED_QUERY_STRINGS
ENCODED_QUERY_STRINGS
は、クエリをUTF-8でURLエンコードした文字列です。
サンプル
アプリIDが123のレコードを次の条件で絞り込む例です。
- 文字列1行(フィールドコード:
文字列_1行
)の値が「サイボウズ」 - ラジオボタン(フィールドコード:
ラジオボタン
)の値が「A」
URL例
https://sample.cybozu.com/k/123/?query=%e6%96%87%e5%ad%97%e5%88%97_1%e8%a1%8c%3d%22%e3%82%b5%e3%82%a4%e3%83%9c%e3%82%a6%e3%82%ba%22%20and%20%e3%83%a9%e3%82%b8%e3%82%aa%e3%83%9c%e3%82%bf%e3%83%b3%20in%20%28%22A%22%29
上記のURL例で絞り込んだ結果は、画面で次のように絞り込んだときの結果と同じです。