iDempiere 営業担当者ダッシュボードの使い方|販売管理 操作マニュアル・技術仕様
This content is not available in your language yet.
📖 販売管理の全体像: 販売管理の全体図 も合わせてご覧ください。
営業担当者ダッシュボードは、営業担当者1人分の見込顧客(リード)・営業案件・営業活動を1つのウィンドウにまとめて表示する画面です。iDempiere の標準リファレンスでは「The Sales Rep Dashboard provides a single location for managing sales opportunities」(営業案件を一箇所で管理するための画面)と定義されています。
📌 ポイント: ヘッダータブのテーブル
C_SalesDashboardはデータベースビュー(IsView=Y)です。実データを持たないため、このタブでレコードを新規作成・削除することはできません。表示されるのは既存のユーザー(営業担当者)に対応する行だけです。
営業担当者ダッシュボードでできること
Section titled “営業担当者ダッシュボードでできること”- 担当者ごとの営業パイプライン(Sales Pipeline)のチャート表示
- キャンペーン別の営業案件(Opportunity by Campaign)のチャート表示
- 売上金額(Sales Volume)のチャート表示
- 未対応リクエスト(Open Requests)のチャート表示
- 自分に割り当てられた見込顧客(リード)の確認とステータス更新
- 自分に割り当てられた営業案件の確認とステージ更新
- 自分の営業活動(タスク・電話・メール・打合せ)の確認と完了管理
ダッシュボード(ビュー)を頂点に、担当者にひも付く3つの明細タブがぶら下がる構成です。
| タブ名 | テーブル | 階層 | 項目数 | 役割 |
|---|---|---|---|---|
| ダッシュボード | C_SalesDashboard | 0 | 約6項目 | 担当者名と4種のチャート(ビュー) |
| 見込顧客(リード) | AD_User | 1 | 約22項目 | 担当者に割り当てられたリード |
| 営業案件(オポチュニティ) | C_Opportunity | 1 | 約18項目 | 担当者に割り当てられた営業案件 |
| 営業活動(アクティビティ) | C_ContactActivity | 1 | 約11項目 | 担当者の営業活動履歴 |
graph TD
T1["📊 ダッシュボード<br/>C_SalesDashboard(ビュー)<br/>チャート4種"]
T2["👤 見込顧客(リード)<br/>AD_User<br/>約22項目"]
T3["🎯 営業案件<br/>C_Opportunity<br/>約18項目"]
T4["📞 営業活動<br/>C_ContactActivity<br/>約11項目"]
T1 --> T2
T1 --> T3
T1 --> T4
表示される4種のチャート
Section titled “表示される4種のチャート”| チャート項目 | カラム | 内容 |
|---|---|---|
| Sales Pipeline | SalesPipeline | 営業ステージ別のパイプライン状況 |
| Opportunity by Campaign | OpportunityCampaign | キャンペーン別の営業案件 |
| 売上金額 | SalesVolume | 売上金額(千単位) |
| Open Requests | OpenRequests | 未対応のリクエスト件数 |
💡 ヒント: チャートの中身(集計 SQL や表示形式)は、AD の「チャート(Chart)」定義で管理されています。表示内容を変えたい場合は、レコードを編集するのではなくチャート定義側を調整します。
基本操作手順
Section titled “基本操作手順”graph TD
A["🚀 メニューから開く<br/>販売管理 > 見込顧客管理 > 営業担当者ダッシュボード"] --> B["🔍 対象の営業担当者の行を選択"]
B --> C["📊 4種のチャートで<br/>パイプライン状況を確認"]
C --> D{確認したい対象}
D -->|見込顧客| E["👤 見込顧客タブ<br/>リードステータスを更新"]
D -->|商談| F["🎯 営業案件タブ<br/>ステージ・金額を更新"]
D -->|活動| G["📞 営業活動タブ<br/>完了フラグを更新"]
E --> H["💾 保存"]
F --> H
G --> H
アクセス方法
Section titled “アクセス方法”メニューから「販売管理 > 見込顧客管理 > 営業担当者ダッシュボード」を開きます。
見込顧客(リード)の管理
Section titled “見込顧客(リード)の管理”見込顧客タブは AD_User テーブルで、まだ取引先として本登録していない問い合わせ元・引合先を管理します。
- 「見込顧客(リード)」タブに移動
- 対象のリードを選択、または「新規」で登録:
- 名称: リードの氏名・組織名(必須)
- Eメール / 電話番号 / FAX: 連絡先
- 住所: 所在地
- 取引先: 取引先化した場合にひも付け
- 社内担当者: 担当営業
- リード管理項目を更新:
- リードソース: 獲得経路
- リードソース補足説明: 経路の詳細
- リードステータス: 営業サイクル上のステータス
- リードステータス補足説明: ステータスの詳細
- 最新履歴日 / 最新履歴情報: 最終接触日と結果
- 「保存」をクリック
営業案件・営業活動の更新
Section titled “営業案件・営業活動の更新”「営業案件(オポチュニティ)」タブと「営業活動(アクティビティ)」タブは、営業案件(オポチュニティ) ウィンドウと同じテーブルを扱います。ステージ変更時に可能性(%)が自動セットされる挙動も同じです。日々の進捗更新をこの画面だけで完結させることができます。
項目リファレンス
Section titled “項目リファレンス”ダッシュボードタブ
Section titled “ダッシュボードタブ”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| Sales Rep Name | - | 文字列(60) | 営業担当者名(ビューの表示名) |
| ユーザー | - | 選択 | 対応するユーザー(ビューのキー) |
| Sales Pipeline | - | チャート | 営業パイプラインのチャート |
| Opportunity by Campaign | - | チャート | キャンペーン別案件のチャート |
| 売上金額 | - | チャート | 売上金額(千単位)のチャート |
| Open Requests | - | チャート | 未対応リクエストのチャート |
見込顧客(リード)タブ(主要項目)
Section titled “見込顧客(リード)タブ(主要項目)”| 項目名 | 必須 | 型 | 説明 |
|---|---|---|---|
| 名称 | 必須 | 文字列 | リードの氏名・名称 |
| Eメール | - | 文字列 | メールアドレス |
| 電話番号 / 電話番号2 / FAX | - | 文字列 | 連絡先 |
| 住所 | - | 住所 | 所在地 |
| 取引先 | - | 検索 | 取引先化した場合のひも付け先 |
| 社内担当者 | - | 選択 | 担当営業 |
| リードソース | - | リスト | 獲得経路 |
| リードステータス | - | リスト | 営業サイクル上のステータス |
| 最新履歴日 | - | 日付 | 最終接触日 |
| 最新履歴情報 | - | 文字列 | 最終接触の結果 |
| 営業活動 | - | 選択 | 発生元キャンペーン |
全項目は 画面リファレンス: 営業担当者ダッシュボード を参照してください。
よくある質問(FAQ)
Section titled “よくある質問(FAQ)”Q. ダッシュボードタブで新規レコードを作成できません
Section titled “Q. ダッシュボードタブで新規レコードを作成できません”C_SalesDashboard はテーブル定義上 IsView=Y(データベースビュー)かつ IsDeleteable=N です。ビューは実体を持たないため、新規作成・削除はできません。表示される行は既存のユーザー(営業担当者)に対応するものだけです。
Q. 自分の行が表示されません
Section titled “Q. 自分の行が表示されません”このダッシュボードの行はユーザー(AD_User)に対応します。行が出てこない場合は、対象ユーザーが営業担当者として登録されているか、ロールの組織アクセス範囲に該当データが含まれているかを確認してください。iDempiere ではロールの組織アクセス制限により、同じクライアントでもレコードが見えないことがあります。
Q. チャートが空白のままです
Section titled “Q. チャートが空白のままです”チャートは営業案件・リクエスト等の実データを集計して描画します。該当担当者に案件やリクエストが1件も割り当てられていない場合は空になります。まず 営業案件(オポチュニティ) で案件の社内担当者が正しく設定されているかを確認してください。
Q. 見込顧客(リード)と取引先の違いは何ですか?
Section titled “Q. 見込顧客(リード)と取引先の違いは何ですか?”見込顧客タブは AD_User(ユーザー/コンタクト)で、まだ取引が始まっていない引合先を軽量に管理します。取引が始まる段階で取引先マスタ(C_BPartner)へ登録し、リードの「取引先」欄でひも付けます。取引先としての与信管理や価格表の適用は 得意先(顧客) 側で行います。
🛠 技術仕様(開発者向け)
営業担当者ダッシュボードのヘッダーテーブル C_SalesDashboard は、テーブル属性が IsView=Y / IsDeleteable=N / アクセスレベル 3(Client+Org)のデータベースビューです。専用のモデルクラス(MSalesDashboard / X_C_SalesDashboard)は生成クラス一覧に存在せず、汎用 GenericPO として扱われます。
チャート列(SalesPipeline / OpportunityCampaign / SalesVolume / OpenRequests)は参照型が Chart のフィールドで、AD のチャート定義に基づいて画面描画時に集計・描画されます。テーブル自体に集計値が格納されているわけではありません。
アーキテクチャ概要
Section titled “アーキテクチャ概要”classDiagram
class C_SalesDashboard {
<<database view>>
+AD_User_ID
+Name
+SalesPipeline : Chart
+OpportunityCampaign : Chart
+SalesVolume : Chart
+OpenRequests : Chart
}
class MUser {
+getAD_User_ID() int
}
class MOpportunity {
+beforeSave() boolean
}
class X_C_ContactActivity {
<<generated>>
}
C_SalesDashboard --> MUser : one row per sales rep
C_SalesDashboard --> MOpportunity : child tab
C_SalesDashboard --> X_C_ContactActivity : child tab
関連ソースファイル: org.adempiere.base/src/org/compiere/model/MOpportunity.java / X_C_ContactActivity.java / MUser.java
関連DBテーブル
Section titled “関連DBテーブル”C_SalesDashboard(ビュー)
Section titled “C_SalesDashboard(ビュー)”| カラム名 | 型 | 必須 | 説明 | 備考 |
|---|---|---|---|---|
| AD_User_ID | TableDirect | N | ユーザー | キー列(IsKey=Y) |
| Name | String(60) | N | 営業担当者名 | |
| SalesPipeline | Chart | N | 営業パイプライン | チャート描画列 |
| OpportunityCampaign | Chart | N | キャンペーン別案件 | チャート描画列 |
| SalesVolume | Chart | N | 売上金額(千単位) | チャート描画列 |
| OpenRequests | Chart | N | 未対応リクエスト | チャート描画列 |
| AD_Client_ID | TableDirect | Y | クライアント | 既定値 @#AD_Client_ID@ |
| AD_Org_ID | TableDirect | Y | 組織 | 既定値 @#AD_Org_ID@ |
| IsActive | YesNo | Y | 有効 | 既定値 Y |
⚠️ 注意:
C_SalesDashboardのキーはAD_User_IDであり、専用のC_SalesDashboard_IDは存在しません。ビューであるため INSERT / DELETE は不可です。
子タブのテーブル
Section titled “子タブのテーブル”| テーブル | 役割 | モデルクラス |
|---|---|---|
| AD_User | 見込顧客(リード) | MUser |
| C_Opportunity | 営業案件 | MOpportunity(80行) |
| C_ContactActivity | 営業活動 | 生成クラス X_C_ContactActivity(364行)のみ |
erDiagram
C_SalesDashboard ||--o{ AD_User : "leads assigned"
C_SalesDashboard ||--o{ C_Opportunity : "opportunities assigned"
C_SalesDashboard ||--o{ C_ContactActivity : "activities"
C_Opportunity }o--|| C_SalesStage : "stage"
C_Opportunity }o--|| C_BPartner : "customer"
C_ContactActivity }o--o| C_Opportunity : "related opportunity"
AD_User }o--o| C_BPartner : "converted to partner"
ビジネスロジック
Section titled “ビジネスロジック”- ヘッダーにモデルロジックなし:
C_SalesDashboardはビューのため、beforeSave/afterSaveの類は存在しません。画面は既存データの読み取りと子タブの編集に特化しています。 MOpportunity.beforeSave(): 営業案件タブで有効です。C_Order_IDが設定されている場合、受注伝票のGrandTotalをOpportunityAmtへ同期します。CalloutOpportunity.salesStage: 営業案件タブでステージを選択したときに、C_SalesStage.Probabilityを可能性欄へ転記します。- 営業活動の制約:
C_ContactActivity.ContactActivityTypeはIsUpdateable=Nのため、保存後に活動タイプを変更できません。
拡張ポイント(カスタマイズ箇所)
Section titled “拡張ポイント(カスタマイズ箇所)”チャートの追加・変更
Section titled “チャートの追加・変更”チャート列は AD のチャート定義(Chart)と結びついています。表示内容を変えたい場合は、Java コードではなく AD 側のチャート定義(集計 SQL・軸・系列)を調整するのが標準的な方法です。列そのものを増やす場合はビュー定義の変更が必要になり、アップグレード時の再適用が必要になる点に注意してください。
ビューのカスタマイズ
Section titled “ビューのカスタマイズ”C_SalesDashboard はデータベースビューです。表示対象の担当者を絞り込む・組織条件を加えるといった変更はビュー定義の書き換えになります。コアオブジェクトの直接変更はアップグレードで上書きされる可能性があるため、独自ビュー+独自ウィンドウを OSGi プラグイン(2Pack)で追加する方式を推奨します。
Model Validator
Section titled “Model Validator”子タブ側(C_Opportunity / C_ContactActivity / AD_User)には通常どおり Model Validator を適用できます。
public class CustomLeadValidator implements ModelValidator { @Override public int modelChange(PO po, int type) throws Exception { if (po instanceof MUser && type == TYPE_BEFORE_CHANGE) { MUser lead = (MUser) po; // 例: リードステータス更新時に最新履歴日を必須にする if (lead.is_ValueChanged("LeadStatus") && lead.getLastContact() == null) { throw new AdempiereException("リードステータス変更時は最新履歴日を入力してください"); } } return null; }}関連プロセス
Section titled “関連プロセス”このウィンドウには標準の関連プロセス(ボタン起動のプロセス)は定義されていません。集計・分析はチャートおよびレポート機能を利用します。
関連ドキュメント
Section titled “関連ドキュメント”iDempiereカスタマイズのご相談
Section titled “iDempiereカスタマイズのご相談”営業担当者ごとの KPI 表示やパイプラインチャートは、AD のチャート定義と独自ビューで自社の管理指標に合わせて再構成できます。
As-Link株式会社では、OSGiプラグインによる安全なカスタマイズを提供しています。