一覧画面を開いた時「処理中」や「未処理」など特定の値のレコードの件数を表示できると、対応が必要なレコードの残数が一目でわかって便利ですよね。
今回は、条件に応じたレコード件数を一覧の上に表示するカスタマイズをご紹介します！
カスタマインの基本的な事柄は、こちらの「はじめてのカスタマイズ」をご参照ください。
アプリの準備
kintoneで、タスク管理アプリを準備します。
※フィールド名とフィールドコードは同じものを指定
やりたいこと
一覧画面を開いた時、フィールド「状態」が「処理中」のレコード件数を表示する。
一覧画面で「状態」を編集し、保存した時「処理中」のレコード件数を再表示する。
カスタマイズ
カスタマインに「タスク管理」アプリのカスタマイズを追加します。
状態が「処理中」のレコードを取得する その１
まず、状態が「処理中」の全てのレコード(※注：一覧画面で現在表示されていないレコードも含む)を取得します。
やること「キーを指定してレコードを取得する」、条件「一覧画面を表示した時」を用います。
やることのパラメーター「取得先アプリ」は「タスク管理」、「キーとなるフィールド」には「状態」を指定します。更に「状態」が「処理中」のレコードを取得したいので、キーの値には「処理中」と入力します。
なお、一覧画面で現在表示されているレコードのみを対象とする場合は、やること「一覧で画面に表示されているレコードを取得する」を使う形になります。
このケースについては次の記事に例があります。併せてご覧ください。
条件指定して取得したレコードの件数をカウントする その１
先ほどのアクション（アクション番号１）で取得したレコードの件数をカウントします。
やること「レコード行数をカウントする」、条件「他のアクションの実行が完了した時」を用います。
やることのパラメーター「レコード選択アクション」には「1」を指定します。
「結果をセットするフィールド（省略可）」は、何も指定せず「〈選択されていません〉」の状態にしておきます。
カウントしたレコードの件数を表示する
ここでは件数を表示します。
やること「メニュー位置に文字を表示する」、条件「他のアクションの実行が完了した時」を用います。
やることのパラメーター「場所」は、レコードのタイトルのすぐ上に表示したいので「一覧画面メニューの下側」を選択します。なお、「場所」は「レコード詳細メニューの上側」「一覧画面メニューの右側」などから選べますので、試してみてください。
「表示するテキスト」は「処理中のレコード件数：10」のように表示したいので「処理中のレコード件数：${$2}」と入力します。
「${$2}」と入力することで、アクション「2」の結果（今回は「条件指定して取得したレコードの件数をカウントする その１」でカウントした件数）を表示できます。
これで、一覧画面を表示したときに「処理中」のレコード件数を表示するカスタマイズができました。
「kintoneアプリへ登録」し、動作を確認してみましょう！
kintoneのタスク管理アプリにレコードを追加し、「処理中」のレコードの件数を確認します。
状態が「処理中」のレコード件数が表示されましたか？
これで、一見完成したように見えますが、一覧画面で、「処理中」のレコードを「完了」に変更して保存してみると……
処理中のレコード件数は２件のままです。
画面を更新すれば正しい件数である１件になりますが、これでは少し不便です。
では、一覧画面で「状態」を変更した時にもレコード件数が正しく表示されるように、カスタマイズを追加しましょう！
状態が「処理中」のレコードを取得する その２
まずは、状態が「処理中」のレコードを取得します。
やること「キーを指定してレコードを取得する」、条件「レコードを保存した直後（削除後は除く）」、「現在の画面が一覧画面ならば」を用います。
やることのパラメーター「取得先アプリ」は「タスク管理」、「キーとなるフィールド」には「状態」を指定します。更に「状態」が「処理中」のレコードを取得したいので、キーの値には「処理中」と入力します（1番アクションの「やること」と同じになります）。
条件指定して取得したレコードの件数をカウントする その２
先ほどのアクション（アクション番号４）で取得したレコードの件数をカウントします。
やること「レコード行数をカウントする」、条件「他のアクションの実行が完了した時」を用います。
やることのパラメーター「レコード選択アクション」には「4」を指定します。
「結果をセットするフィールド（省略可）」は、何も指定せず「〈選択されていません〉」の状態にしておきます（2番アクションの「やること」と同じになります）。
レコード件数を変更後の件数に更新して表示する
ここでは件数を変更(更新)します。
やること「スペース・メニュー・ポータル位置に表示した文字を変更する」、条件「他のアクションの実行が完了した時」を用います。
やることのパラメーター「変更元」は、「カウントしたレコードの件数を表示する」のアクションを指定したいので「3」を指定します。
「表示するテキスト」には先ほどのアクション（アクション番号５）のカウント結果を表示したいので「処理中のレコード件数：${$5}」と指定します。
これでカスタマイズは完了です！
一覧画面で状態を変更し、レコード件数が更新されるか試してみてください。
おわりに
条件に一致するレコードの件数を一覧画面に表示するカスタマイズ、いかがでしたか？
一覧画面を使いやすくするために、ぜひお役立てください！
また、ご不明点等ございましたら、チャットにてご質問ください！