VtigerCRM OSSの導入・運用 ｜ 要件定義
VtigerCRMのカスタマイズはどこまでノーコード？ 標準設定・拡張・個別開発の境界線
「案件に項目を追加したい」「値引きが一定率を超えたら上長の承認を通したい」。どちらもよくある要望ですが、承認依頼をメールで知らせる場合と、承認前の見積発行を止める場合では、必要な仕組みも見積りも変わります。
OSS版VtigerCRM 8.4.0を基準に、管理画面で設定できる範囲、既存の拡張モジュールで対応できる範囲、PHPやJavaScriptで設計・実装する範囲を、実際の業務要件に沿って整理します。
要件を「いつ、誰が、何をできるか」で分ける
要件定義では、要望の件数より、例外時の動作や他システムへの影響で工数が変わります。「見積を承認したい」なら、通知、承認者の判定、発行制御、金額変更後の再承認を別々に書き出します。対象モジュール・利用者の権限・導入済みの拡張をそろえた環境で、次の早見表を起点に確認します。
| 領域 | 標準設定で試す | 既存の拡張を確認する | 個別開発を見積もる |
|---|---|---|---|
| 項目・入力画面 | 項目・ブロック、必須、定義リストの依存関係 | 画面やメニューの改善、対応する参照項目の追加 | 企業ランクと明細を参照した入力制御・保存時検証 |
| 権限・承認 | ロール・プロファイル・共有、ステータス変更時の通知 | 条件に合う承認ルートや履歴を備えた拡張 | 承認額や例外に応じた経路分岐、発行や外部連携の制御 |
| 日本仕様・帳票 | 対応する表示項目、標準帳票・CSV出力を確認 | 日本語表示や日本語PDF、PDF帳票デザイナー、Excel出力 | 指定の帳票やExcel様式、明細と税計算の独自ルール |
| 自動処理 | メール、項目更新、対応モジュールでの活動作成 | 実行したい処理に対応する追加タスクや連携アプリ | 複数レコードの更新を連動させる処理、失敗時の再処理 |
| 集計・予実 | 一覧フィルタ、標準レポート・グラフ | 受注予実管理や既存のダッシュボード拡張 | 組織・期間・計上ルールをまたぐ独自指標 |
| 外部連携・AI | メール設定、Webフォームの取り込み（有効化済みの環境） | 対応済みコネクター、生成AIの要約や下書き | 双方更新・照合・再送、独自のAI入出力と承認 |
既存の拡張を使える条件も確認します。 対象バージョン、対応モジュール、必要な他アプリ、ライセンス、導入・更新の作業を確認し、要件に残る差分だけを開発見積りに含めます。
標準設定
管理画面で設定できる5つの領域
1. カスタム項目・ブロック・配置
レイアウトエディタから、文字列、数値、金額、日付、チェックボックス、定義リストなどを追加し、ブロックに配置できます。たとえば案件に「初回提案日」と「競合区分」を追加し、対象項目の必須設定を調整できます。既存の標準項目には変更できる属性に制約があるため、追加・変更前に詳細画面、一覧、CSVインポートへの影響も確認します。 カスタム項目数とDB上限のガイド
2. 定義リストと連動プルダウン
業種や案件フェーズなどの選択肢を管理し、定義リスト依存関係で同じモジュール内の選択肢を連動させます。たとえば「製品カテゴリ」を選んだとき、対応する「製品タイプ」の候補に絞れます。別の顧客企業レコードの契約条件で候補を変える要件は、参照先の値を取得して絞り込む処理を個別に検討します。
3. ロール・プロファイル・共有ルール
営業担当と部門長で見えるレコードを分け、一般ユーザーの削除やエクスポートの権限を絞れます。ロール階層と共有ルールでレコードの範囲、プロファイルで対象モジュールの操作や項目の権限を設計します。テスト用の一般アカウントで、一覧・直接アクセス・関連リスト・必要な出力経路を確認します。 情シス向けセキュリティチェックリスト
4. 標準ワークフローの通知・項目更新・活動作成
対象モジュール、実行タイミング、条件、利用可能なタスクを組み合わせます。たとえば、案件が受注になったら経理にメールを送り、同じ案件の確認フラグを更新するルールが候補です。活動作成が選べるモジュールでは、見積提出時に期日付きのフォロータスクを作る方法も検討できます。
期日を7日後にしたタスクを今作る要件と、7日後に条件を判定して処理を起動する要件は、実行設定が異なります。後者はスケジューラーの実行条件や対象モジュール、重複実行を検証します。 標準ワークフローを使った承認通知の設定例
5. 一覧フィルタ・レポート・ダッシュボード
「今月完了予定で100万円以上」の案件を絞り込み、一覧フィルタとして保存できます。標準レポートは、選べる主モジュールと関連モジュールの項目、集計、グラフを組み合わせられます。対応するグラフやウィジェットをダッシュボードに配置し、一般ユーザーが見る件数や金額も照合します。
拡張・個別開発
標準設定を超えやすい5つの領域
1. 入力中の画面制御と保存時の検証
顧客ランクに応じて割引の上限を表示する、明細の変更に合わせて金額を再計算するなど、入力中に反応する処理は、対応するUI拡張やJavaScript実装を検討します。違反データの登録を防ぐ要件には、サーバー側の判定も設計し、通常画面・一括更新・CSV・APIのうち利用する経路をテストします。
2. 参照項目（UIタイプ10）とデータ構造
案件から独自の「契約台帳」モジュールを参照するなど、新しい参照項目が必要な場合は、標準レイアウトエディタで追加できる型を確認します。OSS版8.4.0の標準の追加候補には任意の参照型が含まれていません。対応する拡張か、vtlibの Vtiger_Field と setRelatedModules() を使う実装を検討します。
項目定義やDBの変更は、関連定義、権限、既存データ、移行手順をセットで管理します。既存の標準項目をそのまま使えるかも先に確認します。 フィールド属性とUIタイプのリファレンス ／ 公式vtlibの項目API
3. 姓名順・日本語帳票・指定Excel様式
一覧、詳細、検索、差し込みで「姓・名」の表示をそろえる場合は、対象画面ごとに確認します。PDF帳票は、見積書・請求書などの出力見本を用意し、項目や明細、適格請求書に必要な記載、税区分・端数処理を経理と確認します。既存の帳票アプリで満たせる範囲と、計算ロジックの追加が必要な範囲を切り分けます。
一覧データのExcel出力と、自社指定テンプレートのセル位置・数式・複数シートを維持する出力は別の要件です。 日本仕様化で確認する5つの設定
4. 予算・見込み・実績を突き合わせる集計
担当者別の案件金額を集計する要件なら、まず標準レポートで試します。月次予算を担当・部門別に持ち、受注見込みと受注実績を並べる場合は、「どの時点で実績とするか」「失注や取消、組織変更をどう扱うか」を決めます。既存の予実管理アプリで合う部分を使い、独自の計上や期間集計が残る場合は追加実装を見積もります。
5. 会計・外部API・生成AIとの連携
会計へのCSV受け渡しで業務が回る場合は、更新頻度と照合作業を先に検証します。受注や請求の自動連携、変更・取消の同期が必要なら、コネクターの対応範囲を確認し、送信項目、相手側ID、再送、二重登録防止、エラー監視を設計します。たとえば同じ受注を再送しても、会計側で新規伝票を二重作成しないことをテストします。
AIで商談メモを要約する場合も、既存アプリが扱える履歴や画面を確認します。送信できる情報、生成結果の確認者、保存先、API費用を要件に含めます。 VtigerCRMの生成AI活用4例
「値引きの承認」を3段階に分けて見積もる
たとえば「値引きが15％を超えたら上長承認が必要」という要望を、利用者の操作と期待結果に分けます。同じ見積業務でも、次のどこまで必要かで実装範囲が決まります。
| やりたいこと | 実現方法の候補 | 受入テスト |
|---|---|---|
| 承認依頼を通知する | 標準のステータスとワークフロー。判定に使う値が条件で参照できるか確認する。 | 条件を満たしたときに通知され、同じ状態で保存し直しても二重通知されない。 |
| 承認履歴を残し、発行を制御する | 既存の承認系拡張の適合を確認し、不足分を追加実装する。 | 承認前は対象経路で見積書を発行できず、承認後は発行できる。承認者と日時を追える。 |
| 承認後の変更で再承認する | 対象項目、承認の無効化、差戻し、発行制御を個別に設計する。 | 承認後に対象の金額や値引きを変更すると再承認待ちに戻り、確認済みの条件でのみ発行できる。 |
要件表には、対象画面・APIなどの入口、実行者と権限、条件、期待結果、例外時の扱い、候補となる実装方法を記録します。データ移行のある案件では、既存の値と新しい必須項目・制御が両立するかも確認します。 CSVインポートとデータ移行の実務ガイド
本体の変更を抑え、更新時に検証できる形で残す
本体ファイルに直接変更を加えると、更新で変更箇所が上書きされたり、新しい本体との競合を解消する作業が発生したりします。拡張の入口として、vtlibの項目定義やモジュールリンク、保存前後のイベントなど、対象バージョンで使える仕組みを優先します。 公式vtlib開発ガイド
- 管理画面の変更を残す。 項目、権限、ワークフローの設定値と、その設定にした理由を記録します。
- 拡張の配布単位と依存関係を残す。 導入ZIP、対象のVtigerCRM・PHP・DBバージョン、導入・更新手順、データの移行方法を管理します。既存の本体改修がある場合は差分と影響範囲も一覧にします。
- 更新前に業務操作を再現する。 検証環境で保存、検索、帳票、権限、ワークフロー、外部連携を通し、通常時の画面応答と障害時の戻し方も確認します。 画面レスポンスを改善するポイント
費用を比較するときは、初期の設定・開発だけでなく、拡張の利用料、更新時の確認、障害対応の担当も見積りに入れます。 100名・5年間で比較するCRMの総所有コスト
vtplusで既存アプリを確認し、残る差分を相談する
vtplusは、OSS版VtigerCRMを基盤とする導入・運用支援と、業務支援アプリを提供しています。必要な機能が既存アプリで満たせるか確認してから、設定や個別開発の範囲を決められます。
- 日本仕様と画面。 日本語化や日本語PDF、画面・メニューの改善を、対象環境に合わせて検討できます。既存環境で一部を整えたい場合は JP Fix Packの紹介 や IPUIManager をご覧ください。
- 帳票・出力・予実。 PDF帳票デザイナー、一覧Excel出力、受注予実管理 が候補です。自社の帳票見本や集計ルールで、対応範囲を確認できます。
- 生成AIと個別要件。 AIセンター・AI要約 などのアプリと、コトバ開発で追加できる処理を比較し、入力データ・利用条件・保守を整理します。
アプリやAIの利用条件、個別開発、サーバー保守の範囲は構成によって異なります。 vtplusの料金と導入支援
vtplus ｜ 要件定義・カスタマイズ・移行
自社の要件を、標準設定・拡張・個別開発に仕分ける
実現したい操作、現在のVtigerCRMのバージョン、帳票の見本や連携先をお知らせください。導入前の機能確認から、既存環境の改修や他社CRMからの移行まで、要件ごとに実現方法と検証範囲を整理します。