統計・分析ダッシュボードプラグイン

分析・統計ダッシュボードプラグイン 操作マニュアル

• プラグイン名：統計・分析ダッシュボードプラグイン（manifest名：分析・統計ダッシュボードプラグイン）
• バージョン：1.8.1
• 種別：APPプラグイン（ライセンス必須／AES-GCM暗号化方式）
• 概要：kintoneのレコードから、KPI・グラフ・ピボット・ヒートマップ・ランキングのウィジェットを行レイアウトで配置し、期間／グローバルフィルターやクロスフィルターで対話的に分析できるPower BI風ダッシュボード。1つのプラグインを複数の一覧にセットでき、一覧ごとに別々の設定を持てる。

---

1. できること

• 5種類のウィジェットをプリセットから追加：KPIカード／グラフ／ピボット（クロス集計表）／ヒートマップ／ランキング（Top N）。
• 集計方法：件数・ユニーク件数・合計・平均・最小・最大・中央値。
• グラフ種別（17種）：縦棒／横棒／積み上げ縦棒／積み上げ横棒／グループ化棒／折れ線／複数系列折れ線／エリア／積み上げエリア／複合(棒+折れ線)／二軸／円／ドーナツ／ポーラーエリア／レーダー／散布図／バブル。
• 上部の「期間」フィルターと「グローバルフィルター（スライサー）」で全ウィジェットを一括絞り込み。
• セル・バー・行のクリックで連動する「クロスフィルター」、各ウィジェットの集計元レコードを見る「ドリルダウン」。
• 階層クロス集計（行・列を多階層化、小計表示・初期展開、縦横ヘッダー固定）。
• フィールド値のカスタム並び順、kintone標準クエリ互換のウィジェット個別絞り込み。
• ダッシュボード全体のPNG／印刷(PDF)出力、ウィジェット単位のPNG／CSV出力。
• 設定画面のライブプレビューで、実データを使って確認しながら構築可能。
• 【v1.8.0】1つのプラグインを複数の一覧にセット可能。一覧ごとに別々のダッシュボード設定（プロファイル）を、設定画面上部のタブで切り替えて管理できる。

---

2. 事前準備（対象アプリ側に必要なもの）

• 集計の基準にする日付フィールド：DATE／DATETIME／TIME／作成日時／更新日時 のいずれか。
• 集計・グループ化・スライサーに使うフィールド：文字列1行／ドロップダウン／ラジオボタン／チェックボックス／複数選択／ユーザー選択／組織選択／グループ選択／ステータス／日付／数値。
• ダッシュボードを表示する一覧（カスタマイズビュー推奨）。複数の一覧に表示したい場合は、その数だけ一覧を用意。

---

3. 設定手順（プラグイン設定画面）

1. 対象の一覧（複数一覧対応／v1.8.0）：設定画面の最上部「対象の一覧」タブで、設定する一覧を切り替えます。タブごとに「基本設定／グローバルフィルター／フィールド値の並び順／ウィジェット」を個別に設定できます。

• 「＋一覧を追加」：別の一覧用の設定（プロファイル）を追加。
• 「この設定を複製」：現在のタブの設定をまるごとコピーして新タブを作成（一覧の選択だけ空になるので別の一覧を選ぶ）。
• 「この一覧を削除」：選択中タブを削除（最低1つは必要）。
• 同じ一覧を2つのタブに設定することはできません。
• ※ライセンスキー・シークレットキーは全タブ共通です。

1. ライセンス設定：販売元発行のライセンスキー・シークレットキーを入力（入力直後に有効性を表示）。無効だと保存できません。
2. 基本設定（このタブの一覧の設定）

• ダッシュボードタイトル（任意。空欄なら「分析・統計ダッシュボード」）
• 表示する一覧（必須）：カスタマイズビューを選ぶと、標準のレコード一覧テーブルが非表示になりダッシュボードのみ表示されます。
• 基準日付フィールド（必須）：期間フィルター・月別推移・対前期比較など時系列集計の基準。
• 年度開始月（既定：4月）：「今年度」「年度別」の起点。
• 期間フィルターの初期表示（既定：今年度）：全期間／今月／先月／直近7日／直近30日／直近90日／今四半期／上期／下期／今年度／前年度 から選択。閲覧者は開いた後に変更可能。

1. グローバルフィルター：閲覧者が値を選んで全ウィジェットを一括で絞り込むスライサー（ドロップダウン）を追加。
2. フィールド値の並び順（任意）：指定フィールドの値が並ぶ順序を固定（ピボット／ヒートマップ／グラフ／ランキングすべてに適用）。
3. ウィジェット設定（行レイアウト）

• 「＋追加」で種別を選んでカードを追加。
• 行ヘッダーの ☰ をドラッグで行の順番を、カード（ウィジェット）をドラッグで配置・順番を並び替え。
• 「✎ 編集」で詳細（タイトル・集計方法・対象フィールド・横軸／行列フィールド・グラフ種別・サイズ・カラー等）を設定。チェックボックスを外すと非表示（削除はされません）。
• サイズ：小(1/3幅)／中(2/3幅)／大(全幅)。

設定後は必ず「保存」し、アプリを「更新」してください。複数の一覧を設定した場合も、保存は1回でまとめて反映されます。

---

4. 集計・表示オプション

• 横軸／グループ化：フィールドの値ごと／日別／週別(月曜始まり)／月別／四半期別／年別／年度別／曜日別／時間帯別／数値を範囲で区切る。
• ピボット・ヒートマップ：行・列の多階層化、小計表示（表示する／しない）、初期展開状態（全て展開／最上位のみ）、表の高さ（内容に合わせて伸縮／固定スクロール）。
• ヒートマップのカラースケール：ブルー／グリーン／オレンジ／レッド／赤-白-青(発散)。
• ウィジェット個別の絞り込みは kintone標準クエリ構文で記述可能（=, !=, >, <, in (...), not in (...), like "*...*", and / or, 括弧、TODAY()／THIS_MONTH()／FROM_TODAY(N,DAYS) などの日付関数）。

---

5. ダッシュボード画面の使い方

• 上部バー：期間フィルター（「期間指定」で開始・終了日を指定）＋グローバルフィルター＋「絞り込み」ボタン。
• クロスフィルター：ピボットのセル／行／列、グラフのバー、ランキングの行などをクリックすると、その条件で全ウィジェットが連動して絞り込まれます（チップ表示、再クリックで解除）。
• ドリルダウン：各ウィジェットの🔍ボタンで集計元レコードを一覧表示。
• 出力：ツールバーの「全体PNG」「印刷/PDF」、各カードのPNG／CSVダウンロード。

---

6. 注意事項・トラブルシューティング

• ダッシュボードが表示されない：そのタブ（一覧）の「表示する一覧・基準日付フィールド」が未設定だと動作しません。設定後にアプリを「更新」してください。なお、ダッシュボードは設定で指定した一覧でのみ表示されます（他の一覧では標準のレコード一覧が出ます）。
• ライセンスが無効：メイン機能は表示されません。ライセンスキー・シークレットキーを再確認してください。
• 設定変更が反映されない：保存後にアプリを「更新」したか確認してください（バージョン更新時はブラウザキャッシュ対策のため再アップロードが必要）。
• 大量データ：レコードは $id シーク方式で全件取得します（1万件超のアプリにも対応）。件数が非常に多い場合は集計・描画に時間がかかることがあります。
• 【アップデート時／v1.8.1】既存の設定は新形式（プロファイル）へ自動移行されるため、バージョン更新後もそのまま動作します。v1.8.1以降は更新時に「設定が必要です」のバナーは表示されません。

---

（本マニュアルは analytics-dashboard-plugin-1.8.1.zip 内の manifest.json / config.html / config.js / desktop.js の実装内容に基づいて作成しています。）