「顧客」アプリに「注文」アプリの関連レコード一覧を配置している場合に、注文件数・注文金額の合計・平均単価などを顧客レコード上の数値フィールドへ自動で反映できます。関連レコード一覧フィールドは値をそのまま集計に使えない(APIで取得できない)ため、本プラグインは同じ絞り込み条件を参照先アプリへのクエリとして再現し、参照先アプリの実際のレコードを取得・集計します。

集計のタイミングは3種類から必要なものを選んで組み合わせられます。(a)レコードの保存時に自動集計、(b)詳細画面のボタンを押したときにオンデマンドで集計・保存、(c)一覧画面のボタンで現在の絞り込み条件に該当する全レコードを対象に一括集計、です。一括集計は実行前にAPI実行回数の見積もりを表示して確認を求めます。

kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。

• REST APIの呼び出しはすべてkintone.api()(kintone自身への呼び出し専用の内部ラッパー)経由であり、生のfetch/XMLHttpRequestは使用していません。外部サーバーへの通信は一切行わず、外部ライブラリも使用していません。
• 参照先アプリへのクエリに埋め込む値(自レコードの関連付け値・除外条件)は、ダブルクオートをエスケープしてから埋め込んでおり、値に特殊文字が含まれていてもクエリ構文が壊れません。
• 参照先アプリの閲覧権限が無いユーザーが実行した場合は集計を中止し、実態とズレた値を書き込みません(保存時トリガーは保存自体をキャンセルします)。
• 一覧画面からの一括集計は、書き戻し前に全対象レコードの集計を終える2段階構成にしており、集計中にエラーが起きた場合は1件も書き戻しません。書き戻し時のレコードごとの更新競合(revision競合)はそのレコードだけスキップし、他のレコードは正常に反映します。
• 一括集計ボタンの表示グループ制限は画面上の表示切り替えに過ぎず、真の権限境界ではないことを設定画面本文にも明記しています。

revision競合時の実際のエラー判定条件や、絞り込み条件に動的条件を含む場合の挙動など、実環境での検証が一部未了の項目があります。詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。

→ security-checklist.md をGitHubで見る