時間帯集計項目自動作成プラグイン（無料）
日時(DATETIME)・時刻(TIME)フィールドを選択すると、その時刻部分を「時間帯」の区分 (例: 09:00〜10:00)に変換し、ドロップダウンフィールド(グルーピング分析用)と 数値フィールド(数値分析用、時間帯開始時刻の0時からの経過分数)を保存時に 自動作成します。作成された2フィールドはレコード画面では常に非表示になり、集計・グラフ機能から そのまま利用できます。
こんな方におすすめ
- kintoneで時刻データを時間帯(09:00〜10:00など)に区分して集計したい
- 来店時間や作業時間を時間帯別にグラフ化したい
- 「kintone 時間帯集計」を探している
- 時間帯ごとの件数をkintone標準のグラフ機能で見たい
紹介動画
ユースケース
受付日時フィールドから「9:00〜10:00」のような時間帯のドロップダウンを自動作成し、kintone標準のグラフ機能でその選択肢ごとに件数集計・傾向分析ができます。区切り幅は15分〜12時間まで選べます。
ドロップダウンと同時に作成される数値フィールド(時間帯開始時刻の0時からの経過分数)を使うと、平均到着時刻の算出や数値としてのグラフ表示など、ドロップダウンだけでは難しい分析にも対応できます。
一覧画面の絞り込み条件に該当する既存レコードへ、一括で時間帯を反映するボタンを表示できます。実行できるユーザーはグループ(ロール)で絞り込めます。
セットアップ手順
- プラグインをアプリに追加し、設定画面を開く。
- 「+ 設定行を追加」で設定行を作成し、変換元フィールド(日時/時刻)と時間帯の区切り幅を選ぶ。
- 発動タイミング(フィールド変更時/保存時)を選び、必要なら一覧画面の一括実行(実行を許可するグループコード)も設定する。
- 保存すると、ドロップダウン・数値フィールドがプラグイン自身によって自動作成され、アプリの設定に反映される。
作成された2フィールドはレコード画面(詳細・作成・編集)では常に非表示になります。一覧画面・グラフ画面では通常のフィールドとして表示・利用できます。日時フィールドの変換は実行ユーザーのタイムゾーン設定に依存するため、同じレコードでも実行するユーザーによって算出される時間帯が変わる場合があります。
セキュリティレビュー結果サマリ
kintoneセキュアコーディングガイドラインに沿って実装時にチェックしています。特に重要な点は次のとおりです。
- フィールドの追加・アプリ設定の運用環境への反映は、JavaScript APIに相当機能が無いため
kintone.api()(kintone自身への呼び出し専用の内部ラッパー)のみを使用しています。外部サーバーへの通信は一切行わず、外部ライブラリも使用していません。 - 同じフィールドコードを二重作成しないよう、既存フィールド(型込み)と突き合わせてから追加対象を決定します(冪等)。コードが衝突した場合は連番を付けた別コードを採番し、保存前に確認を求めます。
- 一覧画面の一括実行ボタンの表示はグループ(ロール)の所属で判定しますが、これはボタンの表示/非表示を切り替えるクライアント側の制御であり、真の権限制御ではありません。実際にレコードを書き換えられるかどうかは自アプリ自体のkintoneレコード編集権限設定に依存します。
- 一括実行はレコードカーソルAPIで対象を列挙し、実行前にAPI実行回数の見積もりを表示して確認を取ります。書き戻し時にrevision競合が起きたレコードはスキップし、完了後に成功件数・スキップ件数を表示します。
- 設定画面でのフィールド一覧・エラーメッセージの描画は
innerHTMLではなくtextContentのみを使用しています。
詳細な確認項目・確認日は下記GitHubのチェックリストに全項目を掲載しています。
設定画面イメージ
API実行数について
設定の保存時に、フィールド追加API・アプリ設定の反映API(kintone.api()経由)を1回ずつ
実行します(既に同じフィールドが作成済みの場合はスキップされ、実行されません)。通常のレコード
保存・フィールド変更時の時間帯算出はkintone標準の保存処理に含まれ、追加のAPI実行はありません。
一覧画面からの一括実行では、対象レコード数に応じてレコード取得API(500件ごとに1回)・書き戻しAPI
(100件ごとに1回)を実行し、実行前に見積もり回数を表示します。