関連レコードの件数を取得するワザ

はじめに

指定した条件にあてはまるレコードをフォームに表示する「関連レコード一覧」ですが
関連するレコードの数を取得することができません。

そこで今回は、アプリ同士の連携で、関連レコードとして紐づけられている
レコードの数を表示させるためのTipsをご紹介します。

利用イメージ

例えば、顧客リストアプリと案件情報アプリで
顧客名で紐づけた関連レコードを利用している場合に
顧客リストアプリ内で関連した案件の数を把握したい場合に利用できます。

あるいは、レンタル品目一覧アプリとレンタル申請アプリを紐づけている際には
レンタル品目一覧アプリを確認することで、利用回数の多い備品を確認することなどが可能になります。

毎回、関連するアプリに移動し絞り込みやグラフの確認などをすることなく
関連レコードを設置したアプリからレコード数が確認できるようになるTipsです。

アプリの準備

まず、アプリストアにある営業支援パックを追加します。
今回のTipsでは、営業支援パック内の顧客管理（Aアプリ）と案件管理（Bアプリ）を使用します。

顧客管理（Aアプリ）

顧客管理（Aアプリ）の、下記のフィールドを使用します。

フィールドタイプ	フィールド名	フィールドコード	備考
文字列(1行)	顧客名	顧客名	関連レコードに表示するレコードの絞り込み用
関連レコード一覧	案件一覧	案件一覧	件数対象の関連レコード一覧

また、関連レコードの件数を表示するための、スペースフィールドを追加します。

フィールドタイプ	フィールド名	フィールドコード	備考
スペース	設定なし	num	関連レコードの件数を表示するためのスペース

ついでに、スペースフィールドの近くにラベルを設置して
何を示している値なのかわかりやすくしておきましょう。

※この場合のラベル名は関連案件数としています。

案件管理（Bアプリ）

案件管理（Bアプリ）の、下記のフィールドを使用します。

フィールドタイプ	フィールド名	フィールドコード	備考
ルックアップ	顧客名	顧客名	関連レコードに表示するレコードの絞り込み用

サンプルコード

ソースコードの説明

kintone.Promiseオブジェクトでの非同期処理

kintone APIでPromiseを使ってみよう！のページで解説されているように
別アプリのデータを取得して処理を行う際にはkintone.Promiseの利用が推奨されています。
このサンプルでは上限100件までのレコードを指定して、
関連レコードで紐づけているBアプリのレコードの情報を取得しています。

関連レコード数の値をスペースフィールドに反映

上記kintone.api()で取得したオブジェクトの数をスペースフィールドに反映させます。

スペースフィールドの利用については、kintone API解説シリーズレコード詳細にもボタンを設置しようで
kintone.app.record.getSpaceElementについて詳しく解説しています。

今回はというフィールドコードで設置したスペースフィールドに
値を反映させますので、関連レコードの項目を条件付きで集計と同じように
関連レコードに合致するレコードの数を、フィールドの近くに設置しました。

※上記サンプルの場合は一度に表示する最大レコード数を5件に設定していますが
実際の案件情報アプリでの関連レコードは全部で6件登録されていることがわかりました。

関連レコードの絞り込み条件を増やした場合

関連レコードのフィールド設定で「さらに絞り込む条件」を設定することができます。

この設定を行った場合は、サンプルコード上で件数カウントをするためのクエリにも条件を追加してください。

デモ環境

https://dev-demo.cybozu.com/k/285/

※デモ環境についての説明、アカウントとパスワードはこちら

おわりに

アプリ同士の連携を図る関連レコード一覧は標準機能で利用できるため
kintoneを活用するには欠かせない機能となっています。

さらに、今回のTipsでご紹介したカスタマイズを加えることで
より便利になると思いますので、お使いのkintoneアプリ用にアレンジを加えて
チーム内での情報活用にお役立てください。

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