フルバックカレンダーPro

フルバックカレンダーPro 操作マニュアル

• プラグイン名：フルバックカレンダーPro
• バージョン：3（manifest version。履歴表記は2.1.0）
• 種別：APPプラグイン（AES-GCM暗号化方式のライセンス認証あり）
• 概要：kintoneのスケジュールデータをグループ／個人／施設ビューでカレンダー表示し、ドラッグ＆ドロップや繰り返し予定に対応するスケジュール管理プラグイン。

1. できること

• グループ週／グループ日ビュー（組織×メンバーの横断表示）
• 施設週ビュー（施設名フィールド設定時）
• 個人ビュー（月／週／日）
• 予定のドラッグ＆ドロップ移動（確認なしで即時反映）
• 空きセルのクリック／＋アイコンで新規作成、予定クリックでモーダル編集・削除
• 繰り返し予定（毎週／隔週／毎月。既定で1年先まで、最大200件）
• 参加者2モード：ユーザー選択／社員マスタ等のルックアップ
• 区分（ドロップダウン等）ごとの色分け表示
• 組織・ユーザーでの絞り込み
• 終日予定・非公開予定・場所・メモ・添付ファイルの表示
• モバイル専用のカード型ビュー対応

2. 事前準備（対象アプリに必要なフィールド）

【必須】

• 開始日時：日時（DATETIME）
• 終了日時：日時（DATETIME）※未入力でも登録・表示できます（v2.1.0〜）
• タイトル：文字列1行（SINGLE_LINE_TEXT）
• 参加者：
• ユーザー選択モード → ユーザー選択／組織選択／グループ選択フィールドのいずれか
• ルックアップモード → ルックアップフィールド ＋ 予定グループID（文字列1行）
• 表示用のカスタマイズビュー（一覧）を1つ作成しておく

【任意】

• 終日：チェックボックス（＋終日を示す選択肢の値）
• 区分：ドロップダウン／ラジオボタン（色分け用）
• 施設名：ドロップダウン／文字列1行
• 場所：文字列1行
• メモ：文字列1行／複数行／リッチエディター
• 添付ファイル：FILE
• 非公開：チェックボックス（＋非公開を示す選択肢の値）
• 繰り返しID／繰り返しルール：文字列1行 ×2（繰り返し機能を使う場合）
• ルックアップモード時：マスタアプリ側の「表示名」「部門」フィールド

3. 設定手順

1. アプリの設定 → プラグイン → フルバックカレンダーPro の設定（歯車）を開く。
2. ライセンス設定：ライセンスキー・シークレットキーを入力（入力中にリアルタイム検証。有効でないと保存不可）。
3. 表示設定：表示する一覧（カスタマイズビュー）を選択。デフォルト表示モード・表示開始/終了時刻・時間スロット間隔を指定。
4. グループ表示設定：表示する組織をカンマ区切りで指定（空欄ならログインユーザーの所属組織を自動取得）。
5. フィールドマッピング：開始日時・終了日時・タイトル・参加者モードと各フィールドを選択。必要に応じて終日／区分／施設／場所／メモ／添付／非公開を設定。
6. 繰り返し予定を使う場合は繰り返しID・繰り返しルール用の文字列フィールドを指定。
7. 区分を設定した場合は各区分の表示色を設定。
8. 「保存」→ アプリを更新。

【主な既定値】

• 表示開始時刻：7:00
• 表示終了時刻：22:00
• 時間スロット間隔：30分
• デフォルト表示モード：グループ週

4. ロジックの要点

• データ取得：表示範囲と重なる予定を取得。終了日時が未入力の予定は「開始日時が表示範囲内」のときに表示（点予定として扱う）。※kintoneは空の日時を比較上の最小値として扱うため、v2.1.0で取得クエリを開始日時ベースのOR条件に改修。
• 繰り返し：毎週／隔週／毎月。既定で起点から1年先まで、最大200件。
• ルックアップモード：1つの予定を参加者人数分のレコードに展開し、予定グループIDで束ねて一括作成・更新・削除。
• 取得は500件単位でページング、作成／更新／削除は100件単位でバッチ処理。

5. 画面の使い方

• ツールバー：前へ／次へ／今日、ビュー切替（グループ週・グループ日・施設週・月・週・日）、組織・ユーザーでの絞り込み。
• 新規作成：空きセルのクリック、または＋アイコン。
• 編集・削除：予定をクリックでモーダル表示。削除時のみ確認ダイアログ。繰り返し予定は「この予定だけ／これ以降／すべて」を選択可能。
• ドラッグ＆ドロップ：予定をドラッグして日時を移動（確認なしで即反映）。
• 詳細：モーダルの「詳細」からレコード標準画面を別タブで開く。
• モバイル：専用のカード型ビューで表示・作成・編集。

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

• ライセンスが無効だとカレンダーは表示されません（kintone標準の一覧画面は残ります）。
• kintone標準UIは一覧テーブルのみ非表示にし、一覧切替・追加ボタン・設定アイコン等は残します。
• 終了日時は未入力でも登録・表示できますが、入力する場合は開始日時以降にしてください（v2.1.0で前後チェックを追加）。
• 予定が大量にある期間は取得に時間がかかる場合があります。

（本マニュアルは fullback-calendar-pro-v3.zip 内の manifest.json / config.html / config.js / desktop.js / mobile.js の実装に基づいて作成しています。）