cybozu developer network

Enhanced by Google

カテゴリー内の他の記事

一覧画面で条件に応じたレコード件数を取得するテクニック

作成日
更新日

（著者：落合 雄一）

はじめに

一覧画面で現在のレコード件数を取得したいことがあるかと思います。例えば、以下のようにステータスが「処理中」のレコードの件数を常に表示させておきたい時などに便利です。

しかし、kintoneにはレコード件数を取得するAPIは用意されていません。レコード件数を取得するにはrecords.jsonを利用して100件ずつ取得して算出する方法と、DOMの文字列操作で取得する方法の２通りあります。今回は、records.jsonを利用して100件ずつ取得して算出する方法を紹介いたします。

デモ環境

こちらのデモ環境から実際に動作を確認できます。
https://dev-demo.cybozu.com/k/73/

デモ環境の利用は、事前に cybozu developer network のメンバー登録が必要です。画面右上の「サインイン」ボタンよりご登録ください。
デモ環境アカウントとパスワードは、サインイン後にこちらのページでご確認ください。

ソース

取得したレコードの件数が100件未満になるまでKintoneRecordManagerのgetRecordsを呼び出しています。

最後に

今回、レコード件数の取得方法について説明いたしました。しかしこの方法では、レコード件数が多くなると取得に時間がかかり利用できない場合があるかと思います。その場合は、DOMの文字列操作で以下のキャプチャ部分から取得する方法もありますが、バージョンアップ時に動作しなくなる可能性がありお勧めできません。

早くkintoneにレコード件数を取得できるAPIが用意されると良いですね(^^♪

 

このTipsは、2014年6月版で確認したものになります。 

※デモ環境についての説明はこちら

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

記事のコメント欄は記事に対するフィードバックをする場となっております。
右の記事フィードバックのためのガイドを参照してコメントしてください。
記事のリンク切れなど、気になる点がある場合も、こちらのフォームからフィードバックいただけますと幸いです。

Avatar
mikan

こちらですが、実装させていただいたところ、（すべて）の一覧表示でしか動作しなかったのですが、
任意で作成した一覧では動作しないような仕組みになっておりますでしょうか。

Avatar
落合　雄一

mikanさん
cstapの落合です。

通常の一覧であれば、動作する用になっているかと思います。
しかし現在は、REST API の records.json で totalCount を取得できるので、こちらを利用するほうが良いかと思います。

(function() {
  "use strict";

  // 一覧ページ
  kintone.events.on('app.record.index.show', function(event) {
    // 現在の検索条件&処理中のレコード取得
    var query = kintone.app.getQueryCondition();
    if (query === '') {
      query += ' status in ("処理中")';
    } else {
      query += ' and status in ("処理中")';
    }
    kintone.api('/k/v1/records', 'GET', {
      app: kintone.app.getId(),
      query: query,
      totalCount: true
    }, function(resp) {
      kintone.app.getHeaderMenuSpaceElement().innerHTML = '処理中のレコード件数：' + resp.totalCount;
    });
  });
})();

以上、参考になりますでしょうか？

Avatar
mikan

落合様

ありがとうございます。

バージョンアップか何かでTotalCountというものがサポートされるようになっているのですね。
参考にさせていただきます。

どうぞよろしくお願いいたします。

Avatar
よこい

ステータスが処理中のものと未処理のもの、両方のレコード件数を出力したい場合は

どのように変更すればよいでしょうか？

Avatar
cybozu Development team

よこい 様

こちらのコメント欄は直接的な記事のフィードバックを頂く場所となっております。

カスタマイズに関する質問に関してはcybozu developer コミュニティをご活用ください。

 

どうぞよろしくお願いいたします。

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