rex0220 関連レコード集計プラグイン

kintone

Last updated at 2024-12-09Posted at 2018-07-21

kintone アプリの関連レコード集計プラグインです。

関連レコードの数値合計、最新日時などをプラグイン設定するだけで集計できます。
子アプリを変更時に、親アプリに集計結果を自動反映します。

追加・変更・削除時に、親アプリに自動集計
数値等の集計機能（sum, max, min, count, c_uniq）
文字列、日付等の集計機能（first, firsta, last, lasta）
テーブル項目の集計機能
計算式の計算結果を集計可能
親アプリに関連レコード表示が無くても、集計可能
関連レコード集計を１０セット/アプリまで設定可能
既存レコードの集計機能
プラグイン設定のダウンロード＆アップロード機能

※動作環境は、PC・スマホです。

※参考　関連レコード集計プラグインによるタイムカード月次集計

rex0220 storesで、販売中です。

Ver.50
・プラグイン設定画面の「既存レコードの変更」で、テーブル集計処理の不具合対応
　集計元テーブルから集計先テーブルに項目を設定時、先頭行のみ設定する不具合対応
　ループ配列対応、出力条件対応

活動履歴を追加・変更した場合の自動集計

活動履歴アプリにレコード追加・変更した場合、顧客アプリ・案件アプリに自動集計されます。

案件アプリを追加・変更した場合の自動集計

案件アプリのプラン費用・オプション費用を修正した場合、顧客アプリに自動反映されます。
※スマホで、変更を行った場合の例です。

関連レコード集計プラグインの設定手順

「営業支援パック」のカスタマイズ例です。

集計先アプリに集計項目を追加

顧客アプリ・案件アプリに集計先項目を追加し、運用環境に反映します。

顧客アプリの例

集計先項目を入力不可

集計先項目をマニュアル入力されるとまずいので、kintone 項目入力不可プラグインで、集計先項目を入力不可に設定します。

プラグインの追加

「kintone システム管理 > プラグイン」で追加します。
「アプリの設定 > プラグイン」で、アプリに追加します。

※今回の例では、案件アプリと営業履歴アプリにプラグイン設定を行います。

プラグインの設定

案件アプリのプラグイン設定例

NOTE：メモ
説明：　処理の説明等を記載
プラグイン有効

関連レコード集計毎に、下記を設定します。

処理名：　処理内容
アプリ：　集計先アプリ
対象アプリ条件：　集計先アプリのレコード抽出条件
集計条件：　集計元アプリのレコード抽出条件
集計順：　集計元アプリのレコード抽出順
集計項目：　集計先アプリの集計項目と集計内容
テーブル項目：　集計先アプリのテーブル項目と集計内容

アプリ欄でダブルクリックすると、アプリの選択メニューが表示されますので、対象アプリ「顧客管理」を選択します
。
アプリ番号またはアプリ名を入力すると、フィルタリングされます。

対象アプリ条件

対象アプリ条件の「編集」ボタンをクリックすると、編集用ダイアログが表示されます。
「参照アプリの項目」欄でダブルクリックすると、項目の選択メニューが表示されますので、「レコード番号」を選択します
OR条件の位置： OR条件の位置を指定します。
- - : 「すべての条件を満たす」となります。（OR条件なし）
- 2～10 : 指定値以降は、「いずれかの条件を満たす」となります。

例：今回は、顧客アプリ内の案件アプリ関連レコードで「表示するレコードの条件」と同じです。
顧客アプリの「レコード番号」と案件アプリの「顧客管理レコード番号（関連レコード紐付け用）」で関連付けしています。

「条件値」欄は、項目のフィールドコードまたは計算式を指定します。
定数
- 文字： "" で、囲みます。
  "株式会社", "個"
- 数字：数字をそのまま記述
  0, 123, 1000
項目：アプリ内項目のフィールドコードを指定します。
「:」（コロン）を入力すると、項目名が一覧表示されますので、項目を選択します。
または、計算式を指定します。
※計算式プラグインと同じ計算式を入力できます。

集計条件

集計元アプリ（プラグイン設定アプリ）の集計条件を指定します。

参照アプリの項目：ダブルクリックで項目一覧表示
条件
条件値：項目または計算式

例：顧客管理レコード番号を指定
更新された案件アプリレコードの「顧客管理レコード番号（関連レコード紐付け用）」が同じレコードを集計します。

集計順

集計元アプリのレコード取得順を指定します。

項目：ダブルクリックで項目一覧表示
ソート
- asc：昇順
- desc：降順

集計項目

集計先アプリの集計項目と、集計元アプリの項目または計算式を指定します。

集計先レコードが無ければ追加：チェックなし
集計先項目
項目（計算式）
集計
- sum：合計
- max：最大値
- min：最小値
- count：カウント
- c_uniq：一意の値の個数をカウント
- first：先頭レコードの値
- firsta：有効な値を持つ最初のレコード
- last：最終レコード
- lasta：有効な値を持つ最後のレコード
初期化：　集計元レコードが無い場合に「0」を設定
レコード追加時に設定：　チェックなし
変数として、下記が利用できます。
- $sno：　集計元レコードの処理番号

例：プラン費用合計の集計
顧客アプリの「プラン費用合計」に、案件アプリの「プラン費用」を合計（sum）します。

例：案件件数
顧客アプリの「案件件数」に、案件アプリのレコード単位に 1 をカウント（count）します。
※集計結果は、案件アプリの対象レコード数になります。

テーブル項目

集計先テーブルを設定する場合に指定します。

有効：　チェックして、テーブルを選択します。
To テーブル：　対象テーブルを選択します。
From テーブル：　"-----":レコードまたは、テーブルを選択します。
集計：　レコード取得後に集計してテーブルに設定する場合に、チェック
- 「集計」をチェックすると、集計キー、集計順、ソートキー、ソート順の入力欄を表示
チェック：　設定項目を有効にします。無効の場合は、初期値を設定します。
識別ID：　レコード識別用の項目を指定します。チェックすると計算式に $id が自動セットされます。
項目（計算式）：　集計項目の計算式と同様です。
集計キー：　集計キーを番号で指定
- 項目タイプは、数値、文字列、ドロップダウン、ラジオボタンを指定のこと
- チェックボックス、複数選択、ユーザー選択等は、値が配列で集計・比較できません。
集計順：　asc: 昇順, desc: 降順
集計
- sum：合計
- max：最大値
- min：最小値
- count：カウント
- c_uniq：一意の値の個数をカウント
- first：先頭レコードの値
- firsta：有効な値を持つ最初のレコード
- last：最終レコード
- lasta：有効な値を持つ最後のレコード
ソートキー：　集計後のソートキーを番号で指定
ソート順：　asc: 昇順, desc: 降順
変数として、下記が利用できます。
- $sno：　集計元レコードの処理番号
- $rno：　テーブルの行カウンター
- $val：　ループ配列のループ値

テーブル項目の集計例

活動履歴を対応者別に集計し、最新対応日時順にソートして、テーブルにセット

一覧画面の一括関連集計

一覧画面で関連レコード集計の一括関連集計ができます。
アプリ毎に 10,000 回/日の API 発行制限がありますので、制限回数を超えないように対象レコードを絞って実行してください。

ボタン

一覧画面で表示するボタンについて設定します。

チェック：　選択状態でボタンを表示
デフォルト：　ボタン表示名
英語：　英語表記
日本語：　日本語表記
中国語：　中国語表記

一覧別設定

「一括計算ボタン」を表示する一覧画面を設定します。

すべての一覧で有効：　チェックするとすべての一覧画面でボタンを表示
チェック：　選択した一覧でボタンを表示

権限設定

「一括計算ボタン」を表示する権限を設定します。
ユーザー・組織・グループ単位で設定できます。

活動履歴アプリのプラグイン設定

こちらは集計先アプリが、顧客アプリと案件アプリになります。
同様にプラグイン設定を行います。

設定のポイント
最新の対応日時を取得するため、下記の設定を行います。

集計順を対応日時とレコード番号($id)の降順
最新対応日時の集計は first (先頭レコード)

チェックボックス、複数選択、ユーザー選択項目について

集計先が、チェックボックス、複数選択、ユーザー選択項目の場合、計算式で下記関数を指定してください。

チェックボックス、複数選択項目は、ARRAY関数を指定

ARRAY(チェックボックス)
ARRAY(複数選択)

ユーザー選択は、SEL_CODE関数を指定

SEL_CODE(ユーザー選択)

テーブル内項目の計算

テーブル内の項目については、テーブル集計関数が使えます。

テーブル内数値項目の合計

SUM(T数値)

既存レコードの更新

設定した集計方法で、集計先アプリの既存レコードを更新できます。
※「既存レコードを変更」では、集計先レコード追加は行いません。

集計先アプリと集計元アプリの全レコードを処理しますので、レコード数が多い場合は、１日の API 発行回数制限値（10,000回/1アプリ）をオーバーする場合があります。

案件アプリの「既存レコードの更新」

活動履歴アプリの「既存レコードの更新」

プラグイン設定のダウンロード

プラグイン設定をダウンロードできます。
設定変更している場合は、変更後の設定が対象です。
ブラウザ IE については、プラグイン設定のダウンロードの動作対象外です。

プラグイン設定のアップロード

プラグイン設定をアップロードできます。
ブラウザ IE については、プラグイン設定のアップロードの動作対象外です。

注意事項

既に、JavaScript によるカスタマイズを行っているアプリの場合、処理が競合して、エラーになる場合があります。その場合は、該当するアプリでプラグインの使用を中止してください。

活用例　予算・実績アプリ

予算アプリと実績アプリの集計も簡単に出来ます。

プラグイン設定

標準の一覧で、予実績表示

標準のグラフ機能で予実績表示

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up