[kintone]レコード一覧画面で絞り込み条件を取得する方法

kintoneのカスタマイズしてると現在の一覧画面の絞り込み条件を利用したいときが多々ある。
絞り込み条件を利用してレコードの一括更新とか一括登録とか。
やり方は2パターン。

  • kintone.app.getQueryCondition()
  • kintone.app.getQuery()

kintone.app.getQueryCondition()

公式ページにもあるけど注意点は↓、最近したカスタマイズだと表示順がほしかった。

表示件数(limit)、表示開始位置(offset)、表示順(order by)を取得するには別の API kintone.app.getQuery() を利用します。

デベロッパーツールで確認。
絞り込み条件が↓の場合

'レコード番号 >= "10"' のように絞り込みの条件だけ取得できる。

kintone.app.getQuery()

こっちを利用して同条件の絞り込みで取得した結果。

表示件数(limit)、表示開始位置(offset)、表示順(order by) が取得できる。

まとめ

基本的には一括でレコード取得するときに利用すると思うので、次の登録や更新処理で表示件数とか表示順が必要なときにはgetQuery()を使って、それ以外のときはgetQueryConditionを使う感じかな〜