# 関連レコード一覧集計プラグイン

## kintoneでこんなことできたらいいと思いませんか？

- 関連レコード一覧の数値の集計ができる

## 具体的には……

- 顧客マスタアプリに関連レコード一覧で表示している請求書アプリの合計金額を集計して表示する
- 商品ごとの出荷数

## このプラグインで、こんなことができるようになります！

- 関連レコード一覧の数値フィールドの値を集計して、アプリの数値フィールドに結果を自動入力することができる
- 集計対象となる数値フィールドには数値を結果とする計算フィールドも含む（以下同じ）
- 関連レコード一覧の数値フィールドの値の集計と自アプリの数値フィールドへの自動入力は、以下のタイミングで行うことができる
- レコードの保存時（新規作成後および一覧画面、詳細画面からの編集後）
- 新規作成後の保存時のみに制限することもできる
- 複数レコードについて、任意のタイミングでの集計／自動入力の一括実行時
- 値の集計方法は、以下から選択できる
- 合計／平均／件数
- 関連レコードの数値フィールドと、集計のコピー先となる自アプリの数値フィールドの組み合わせは、任意に複数設定できる
- 集計方法はそれぞれ個別に設定できる
- 複数の関連レコード一覧について、それぞれに設定できる
- 複数レコードについて、集計／自動入力を一括実行できる

## プラグインの設定のしかた

- 集計／自動入力設定
- 関連レコード一覧ごとに集計と自動入力のセットを作成する（複数設定可能）
- 関連レコード一覧をドロップダウンから選択
- 値を集計したい関連レコード一覧の数値フィールドおよび集計方法、集計結果を自動入力したい自アプリの数値フィールドのセットを作成する（複数設定可能）
- 数値を集計したい関連レコード一覧の数値フィールドをドロップダウンから選択する
- 集計方法を「合計／平均／件数」ドロップダウンから選択する
- 集計結果を自動入力する自アプリの数値フィールドをドロップダウンから選択する
- 数値の集計／自動入力を新規作成の保存時のみに制限したい場合は、チェックボックスをオンにする
- 集計／自動入力の有効化／無効化
- 「集計を有効化する」チェックボックス

## プラグインを使ってみましょう！

- 関連先として設定するアプリをふたつ作成する（関連先アプリA、関連先アプリB）
- 先に以下のフィールドを含む関連先アプリAを作成し、それを再利用して関連先アプリBを作成
- 文字列（1行）【キー】
- 数値【数値1】
- 数値【数値2】
- それぞれのアプリに数件のレコードを作成、数値1、数値2に適当な異なる数値を入力）
- プラグインテストアプリを作成、以下のフィールドを作成
- 関連レコード一覧1
- 関連先アプリ
- ...（以下続く）

## アプリの操作およびプラグインの動作

- レコードの新規作成／編集画面およびレコード一覧画面でのレコードの編集
- レコードの保存時に、設定画面での設定にしたがって画面に表示されている関連レコード一覧の数値フィールドの値を集計、自動入力先に指定した自アプリのフィールドに自動入力する
- レコード一覧画面
- 一括集計ボタンをクリックすると、絞り込み対象となる全レコードについて、設定にしたがった関連レコード一覧の数値フィールドの値の集計および自アプリの数値フィールドへの自動入力を一括実行する
- 設定画面で「集計を有効化する」をオフにしていると、一括実行ボタンを表示しない

## 動作確認しながらマニュアル書いてて気づいたこと

- 設定画面の文言は再検討すべき
- 一括実行時に確認ダイアログを表示すべき
- 一括実行時、進捗（処理済み件数）を表示すべき