Troubleshooting
このページでは、Account Planning モジュールのよくある問題と解決策を説明します。
モジュールが表示されない / アクティブでない
症状: Account Planning がメニューに表示されないか、非アクティブで表示される。
解決策:
- モジュールを有効化する – Setup → Modules に移動し、Account Planning を見つけて購入コードで有効化します。
- 権限を確認する – スタッフロールに Account Planning の View 権限があることを確認します。
- キャッシュをクリアする – ブラウザのキャッシュをクリアしてページを再読み込みします。
- インストールを確認する – ファイルが欠落または破損している 場合は、モジュール ZIP を再アップロードします。
フォーム送信時に 419 Page Expired
症状: フォーム(会議メモ、競合など)を送信すると「419 Page Expired」または類似のエラーが表示される。
原因: CSRF(セキュリティ)トークンの不一致。ページが長時間開いていたか、セッションが期限切れになっていることが多い。
解決策:
- ページを更新して再試行します。
- ログアウトして再ログインし、再試行します。
- Perfex のセッションタイムアウトが短すぎないことを確認します(Setup → Settings → General)。
- 同じフォームを複数タブで開かないでください。
リマインダーが送信されない
症状: スタッフが計画タスクのメールリマインダーを受け取らない。
解決策:
- リマインダーを有効にする – Settings → Account Planning → Enable email reminders。
- リマインダー日数を設定する – 例:期限の3日前。
- cron を設定する – cron job が定期的に実行されている必要があります。Setup → Settings → Cron Job に移動し、URL をサーバーの crontab に追加します。
- タスク担当者を確認する – リマインダーを受け取るにはタスクに Person In Charge(PIC)が必要です。
- Perfex メールを確認する – Perfex がメールを送信できることを確認します(Setup → Settings → Email)。
繰り返し計画が自動作成されない
症状: 完了した計画が次の期間に自動コピーされない。
解決策:
- 繰り返しを有効にする – Settings → Account Planning → Auto-create next period for completed plans。
- cron を設定する – リマインダーと同様。cron が実行される必要があります(例:毎日)。
- 日付を確認する – 月次は1日、四半期は1月、4月、7月、10月の1日に実行されます。
- 計画ステータスを確認する – コピーされるのは Completed の計画のみです。
- 重複を確認する – 新期間の計画が既に存在するクライアントはスキップされます。
Client Portal で計画が表 示されない
症状: クライアントがログインしても Account Planning や計画が表示されない。
解決策:
- Client portal を有効にする – Settings → Account Planning → Enable client portal view。
- クライアントを確認する – 計画が正しいクライアントにリンクされていることを確認します。
- 計画ステータスを確認する – 一部の設定では Draft の計画がクライアントに非表示になる場合があります。表示されるステータスを確認します。
- クライアントログインを確認する – クライアントが正しいアカウントでログインしていることを確認します。
プロジェクトビューで Unserialize Error
症状: Quick Create Project で作成したプロジェクトを開くと「unserialize()」エラーが表示される。
原因: 古いバージョンではプロジェクト設定が正しく保存されていませんでした。モジュールの更新で修正されています。
解決策:
- モジュールを最新バージョンに更新し ます(マイグレーション修正が含まれます)。
- エラーが続く場合はサポートに連絡してください。既存プロジェクトのデータベース修正が必要な場合があります。
MindMap / TinyMCE が読み込まれない
症状: MindMap またはリッチテキストエディタが表示されないか、空白エリアが表示される。
解決策:
- ページを更新する – アセットの読み込みが遅い場合があります。
- ブラウザコンソールを確認する – JavaScript エラーを確認します(F12 → Console)。
- ブラウザ拡張機能を無効にする – 広告ブロッカーやスクリプトブロッカーが干渉している可能性があります。
- 別のブラウザを試す – ブラウザ固有の問題を切り分けます。
- ファイル権限を確認する –
modules/accountplanning/assetsフォルダが Web サーバーで読み取り可能であることを確認します。
Webhooks が発火しない
症状: Webhook URL を追加したがリクエストが届かない。
解決策:
- URL をテストする – webhook.site などのサービスで URL が動作することを確認します。
- SSL 検証 – 自己署名またはテスト URL を使用する場合、Settings で「Disable SSL verification」を有効にします。
- ファイアウォール – サーバーが webhook URL への送信 HTTP リクエストを実行できることを確認します。
- イベントを確認する – Webhooks は計画の作成、更新、削除で発火します。テストするには計画を作成または編集します。
Export PDF / Excel が失敗する
症状: エクスポートボタンが反応しないか、エラーが表示される。
解決策:
- 権限を確認する – View 権限が必要です。
- 大量データ – 非常に大きな計画やテーブルはタイムアウトする可能性があります。少数の計画にフィルタして試します。
- ブラウザ – 別のブラウザを試すか、エクスポート用にポップアップブロッカーを無効にします。
- サーバー – 大量データでエクスポートが失敗する場合は PHP メモリ制限と最大実行時間を確認します。