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