kintone 2023.03.02

kintoneの関連レコードの値を取得する方法は？プラグインやJavaScriptでのやり方を紹介

kintoneには「関連レコード」という他のアプリや同じアプリ内の情報を特定の条件で絞り込んで表示する機能があります。
ただし、関連レコードはあくまでレコード詳細画面で表示できるだけなので、レコード内で計算に使いたかったり、一覧画面に表示したかったりする場合にはレコード内の入力できるフィールドに値を取得してくる必要があります。
通常、それらのカスタマイズはプログラミング言語を用いた設定となるため、専門知識・経験をもたない人にとって容易ではありません。

しかし、そんなカスタマイズもプラグインやサンプルコードを使えば簡単に実現できます。

そこで当記事では、プラグインやサンプルコードを使って「簡単に関連レコードの値を取得する方法」を紹介します。
後半では関連レコードの数値を集計する方法も解説するので、参考にしてみてください。

この記事でわかること

kintoneの関連レコードの値を取得する方法
kintoneの関連レコードに関する便利な機能

こんな人におすすめの記事です

kintoneの関連レコードの値を取得してひと目で集計結果を把握できるようにしたい方
kintone関連レコードに関する機能を活用して業務効率化を目指したい方

無料プラグインを使って関連レコードの値を取得する方法

kintone(キントーン)の関連レコードの値を取得する方法として、「関連サブテーブル一覧表示プラグイン」を使って関連レコードの値を取得する方法があります。
当プラグインの本来の趣旨は「標準機能では関連レコードで表示できないサブテーブルを関連レコード一覧として表示させること」ですが、値の取得も可能です。

事前準備として、関連サブテーブル一覧を表示させたい位置に「スペース」フィールドを配置して、要素IDを設定しておきます。

プラグイン設定を開いて、あらかじめ設定しておいたスペースフィールドを「関連サブテーブル(テーブルデータ)一覧表示フィールド」に指定します。
関連レコードと同じように表示したい情報と、表示した情報の集計結果を表示する項目を指定すれば完了です！
サブテーブルが無くても設定できる他、合計値だけではなく平均値や最大・最小値もアプリ内のフィールドに保存することができます。

このように設定することで、関連レコードとして表示しながらその結果をアプリ内に自動保存してくれます。
ただし、レコードにコピーしている集計結果は「レコードを編集」しなければ更新されませんので注意してください。

本来の集計結果は5件の100万円ですが、レコードを編集・保存していないためその前にレコードを編集したときの情報のままになっています

「コンストラクタ」を使って関連レコードの値を取得する方法 | テーブル挿入も可能

関連レコードの値を取得するためには、本来「フィールド設定と同値のqueryを書いて、records.json等を用いてレコードを取得する…」という設定が必要です。

しかし、公式(cybozu developer network)が公表している「コンストラクタ」を使えば、上記の工数不要で簡単に関連レコードの値を取得できます。

以下では、サンプルアプリ「営業支援パック」の顧客管理アプリを例に、案件一覧の合計と活動履歴の件数を表示する手順を説明します。

【コンストラクタを使って関連レコードの値を取得する方法】

アプリの設定より要素ID「space1」「space2」のスペースフィールドを追加
以下を読み込む

・RelatedRecordsFieldManager.js

・sample.js

参考：https://developer.cybozu.io/hc/ja/community/posts/360017851006

コンストラクタを使えば、用途に合わせて一部分のフィールドコードを変更するだけで実装できます。テーブル挿入も可能なので、kintoneでのデータ管理がより便利になるでしょう。

JavaScriptを使ってレコードの値の取得と設定を行う方法

JavaScriptを使って、関連レコードの値の取得･設定を行う方法もあります(API使用)。
専門知識が必須となるものの、kintoneをJavaScriptでカスタマイズすればより自社の業務･要望に沿った設定が可能です。

JavaScriptによる関連レコードの値の取得方法は、雛形コードをカスタマイズする･ファイルを取り込むという2つの方法があります。

【JavaScript(雛形コード)を使ってレコードの値の取得と設定を行う方法】

レコードの値の取得には「kintone.app.record.get()」、レコードに値を設定するには「kintone.app.record.set()」のAPIを使用します
コード編集ツール「JSEdit for kintone」をインストールする
kintone のシステム管理から「プラグインの設定画面」を開き「読み込む」をクリック
プラグインを読み込み、アプリ設定画面から「設定」タブを開く
「カスタマイズ／サービス連携」の「プラグイン」をクリック
「プラグイン設定画面」を開いて「プラグインの追加」をクリック
一覧表示されるプラグインの中にある「JSEdit for kintone」をチェックして「追加ボタン」をクリック
「設定」の歯車アイコンから編集するファイルを追加し「新規作成」ボタンをクリック
表示されるJavaScripの雛形が表示されたらコードを編集する
「保存」をクリック

【JavaScript(ファイル)を取り込んでレコードの値の取得と設定を行う方法】

レコード一覧画面の右上にある「アプリ設定ボタン」をクリックし、「設定」タブの「カスタマイズ／サービス連携」にある「JavaScript / CSSでカスタマイズ」を選択する
カスタマイズの適用範囲を「すべてのユーザーに適用」「アプリ管理者だけに適用」「適用しない」の中から選択する
「URL指定で追加」もしくは「アップロードして追加」をクリックして、取り込むファイルを選択する
「保存」をクリックし、画面右上の「アプリを更新」ボタンを押して完了

kintone関連レコードの値を取得･活用して業務効率化に役立てよう！

kintoneの関連レコードの値を取得して活用すれば、別のアプリに登録されたデータの把握が容易になります。
1つのアプリで別アプリのデータを関連レコードで確認できるだけでなく、数値の自動集計も可能です。

「kintoneの関連レコードの値を取得する」と聞くと設定が難しそうなイメージを抱きがちですが、コンストラクタやプラグインを使えば比較的簡単に値を取得できます。

kintone関連レコードの値を取得･活用して、自社の業務効率化に役立ててみてください！

この事例を自社でも実現したい！
という企業さまはお問い合わせください！

＼ kintoneでの業務効率化について相談したい／

お問い合わせはこちら

業種に対応した業務改善機能をパッケージ化

資料をダウンロードする

ITツール導入の費用が最大450万円補助

補助金について問い合わせる

この記事を書いた人

生田智之

『DXの第一想起者』

日本人の心のふるさとである”三重県伊勢市”を拠点に、中小企業のDX化を支援しています。 kintoneをはじめとする、各社に合ったクラウドサービスの提案から導入、伴走まで一貫したサービスを得意としています。また、youtubeではkintoneのノウハウを大公開する「kintone芸人」として活動しています。「DX化したいけど具体的なイメージができない」「こうなりたい！はあるけど手段がわからない」…等の想いをお持ちの企業様、是非一度ご相談ください！