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例で絞り込んだ結果は、画面で次のように絞り込んだときの結果と同じです。