カテゴリー内の他の記事

URL内のクエリで、表示するレコードの条件を指定

フォローする

URL内のクエリで、表示するレコードの条件を指定

  • PC用画面のみで利用できます。

使用できるクエリは、レコードの一括取得(クエリで条件を指定)(注)をご確認ください。
クエリは、UTF-8でURLエンコードしてご利用ください。

注: "order by", "limit", "offset" による指定は反映されません。

例1:一覧を指定したURLの例

https://{sub-domain}.cybozu.com/k/{appId}/?view={viewId}

例2:絞り込み条件を指定したURLの例

https://{sub-domain}.cybozu.com/k/{appId}/?query={クエリをUTF-8でURLエンコードした文字列}

サンプル

次の絞り込み条件を指定したURLです。

フィールドコードが「文字列__1行」のフィールドの値

項目
サブドメイン example
アプリID 123
フィールドコードが「文字列__1行」のフィールドの値 サイボウズ
フィールドコードが「ラジオボタン」のフィールドの値 A

 

https://example.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

※クエリ部分は、「文字列__1行_="サイボウズ" and ラジオボタン in ("A")」をUTF-8でURLエンコードしています。
※上記のクエリは、画面上で指定する次の絞り込み条件と同等です。

記事に関するフィードバック

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

Avatar
西尾英道

レポートでも同じような指定はできませんか?

Avatar
cybozu Development team

西尾様

はい、集計機能の「条件」でも、同じような指定は可能です。
この記事では、画面上の一覧の絞込機能とAPIのクエリによる絞込が同等であることを示しています。

Avatar
瀬戸 晴生

ソート(order by)は指定出来ないのでしょうか?

Avatar
maaai

瀬戸 晴生さん

この記事に記載のある、下記の「レコードの一括取得(クエリで条件を指定)」というリンクの先に
「order by」の記載があるので、利用できると思います。

> 使用できるクエリは、レコードの一括取得(クエリで条件を指定)をご確認ください。

Avatar
瀬戸 晴生

maaiさん

お返事ありがとうございます。

私もそう思い、試してみたのですが、クエリ内のorder byは、無視され、表示中のビューの並び順が反映されている気がするのです。

Avatar
cybozu Development team

瀬戸様

私どもの環境でも試したところ、一覧画面のクエリ指定においてorder byの並び順は無視されるようです。

記事に「注: order by による指定は反映されません。」と記載いたしました。ご指摘をありがとうございました。

Avatar
TAKA

コミュニティでもご質問させていただいているのですが、
選択項目(DROP_DOWN、MULTI_SELECT)での指定方法はありますでしょうか?

選択項目の場合、仮に「A」という選択肢を指定したい場合、
「選択項目 in ("A")」では指定できず、「選択項目 in ("9999")」のような、ユニークな数値を指定する必要があります。

下記を参考にAPIで項目の情報を取得しても、このユニークな数値を取得することは出来ませんでした。

https://developer.cybozu.io/hc/ja/articles/204783170

なんらかの方法で、このユニークな数値を取得するか、それ以外の方法で選択肢を指定することはできますでしょうか?

TAKAにより編集されました
Avatar
cookie

TAKAさん

URLでも複数選択の値は指定できますよ。「?query=」でURLエンコードしたクエリを指定してみてください。

「?q=」と間違えていませんか?

アプリID「1」、クエリ「複数選択 in ("A")」なら以下のようなURLになります。

https://example.cybozu.com/k/1/?query=%E8%A4%87%E6%95%B0%E9%81%B8%E6%8A%9E%20in%20(%22A%22)

Avatar
TAKA

cookie様

コミュニティでもご指摘いただきましたが、query=で指定する方法で希望の結果を得ることが出来ました。
大変助かりました。
ありがとうございました!

ログインしてコメントを残してください。