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

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

kintoneのレコードから、KPI・グラフ・ピボット（クロス集計表）・ヒートマップ・ランキングのウィジェットを行レイアウトで配置し、期間／グローバルフィルターやクロスフィルターで対話的に分析できる、Power BI風のダッシュボードプラグインです。1つのプラグインを複数の一覧にセットでき、一覧ごとに別々の設定を持てます。

---

1. できること

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

---

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

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

---

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

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

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

1. ライセンス設定：販売元から提供されたライセンス情報を入力します（入力直後に有効性が表示されます）。無効だと保存できません。
2. 基本設定（このタブの一覧の設定）

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

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

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

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

---

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

• 横軸／グループ化：フィールドの値ごと／日別／週別(月曜始まり)／月別／四半期別／年別／年度別／曜日別／時間帯別／数値を範囲で区切る。
• ピボット・ヒートマップ：行・列の多階層化、小計表示（表示する／しない）、初期展開状態（全て展開／最上位のみ）、表の高さ（内容に合わせて伸縮／固定スクロール）。
• ヒートマップのカラースケール：ブルー／グリーン／オレンジ／レッド／赤-白-青(発散)。
• グラフの目標値（しきい値）：値軸のあるグラフ（棒／横棒／折れ線／エリア／複合／二軸など）に目標値を設定すると、その軸に点線の目標線を表示します。「目標値以上で強調（達成）」か「目標値以下で強調（上限・警告）」かを選び、強調色（赤・緑・オレンジ・青・紫）を指定できます。単一系列の棒・折れ線・エリアでは条件に合った棒・点が強調色に変わり、多系列・積み上げ・二軸グラフでは系列の色を保つため目標線のみを表示します。円・ドーナツ・レーダー・散布図などには適用されません。
• 表示件数の上限：画面が極端に重くならないよう、グラフ・ランキングは上位100件、クロス集計表・ヒートマップは200行・最大60列を目安に表示します。上限を超えた場合は「表示 200 / 全 3,412 件」のようにカード内に件数を明示するので、一部だけを見ていることが分かります。表示件数はウィジェットごとの「表示上限」で変更できます（列数の上限は固定です）。件数が多いときは期間を絞ってご覧ください。
• ウィジェット個別の絞り込みは kintone標準クエリ構文で記述可能（=, !=, >, <, in (...), not in (...), like "*...*", and / or, 括弧、TODAY()／THIS_MONTH()／FROM_TODAY(N,DAYS) などの日付関数）。

---

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

• 上部バー：期間フィルター（「期間指定」で開始・終了日を指定）＋グローバルフィルター＋「絞り込み」ボタン。
• 期間を変えて「絞り込み」を押すと、必要に応じてデータを取得し直します。一度表示した期間はしばらく保持されるため、前の期間に戻したときはすぐ表示されます。
• 一覧の絞り込みとの関係：ダッシュボードは、表示している一覧の絞り込み条件を反映して集計します。一覧側で条件を変えると、ダッシュボードの数値も変わります。特定の条件だけを分析したい場合は、一覧の絞り込みを活用してください。
• クロスフィルター：ピボットのセル／行／列、グラフのバー、ランキングの行などをクリックすると、その条件で全ウィジェットが連動して絞り込まれます（チップ表示、再クリックで解除）。
• ドリルダウン：各ウィジェットの🔍ボタンで集計元レコードを一覧表示。
• 出力：ツールバーの「全体PNG」「印刷/PDF」、各カードのPNG／CSVダウンロード。

---

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

• ダッシュボードが表示されない：そのタブ（一覧）の「表示する一覧・基準日付フィールド」が未設定だと動作しません。設定後にアプリを「更新」してください。なお、ダッシュボードは設定で指定した一覧でのみ表示されます（他の一覧では標準のレコード一覧が出ます）。
• 一覧の名前を変更したとき：一覧そのものに紐づけているため、名前を変えてもダッシュボードはそのまま表示されます（バージョン1.12.1以降）。更新後に一度設定画面を開いて保存すると有効になります。
• 設定していた一覧や基準日付フィールドが見つからない：一覧やフィールドを削除した場合などに、設定画面を開くと「どのタブの何が見つからないか」をお知らせします。該当タブで選び直して保存してください。
• ライセンスが無効：メイン機能は表示されません。ライセンス情報を再確認してください。
• 設定変更が反映されない：保存後にアプリを「更新」したか確認してください（バージョン更新時はブラウザキャッシュ対策のため再アップロードが必要）。
• 大量データ：選択中の期間と、表示している一覧の絞り込み条件で対象を絞り込んでから取得します。期間を狭めるほど速く表示されます。対象が2万件を超える場合は、取得前に件数を確認するメッセージが出ますので、時間がかかってもよければそのまま続行してください。
• 表示が重い・時間がかかる：期間を狭める、一覧の絞り込みで対象を絞る、ウィジェットの「表示上限」を小さくする、の順にお試しください。
• アップデート時：既存の設定はそのまま引き継がれ、バージョン更新後もそのまま動作します。バージョン1.12.1へ更新した際は、一覧名の変更に追従させるため、一度設定画面を開いて保存することをおすすめします。