【Salesforce】リード変換が想定と違う時の本番反映前の切り分け

Salesforceのリード変換機能は、リードを取引先責任者・商談・取引先に変換する重要なプロセスです。しかし、変換後の項目が意図しない値になったり、取引先が重複したり、レコードタイプが変わったりと、想定と違う結果になることがあります。本番環境に影響が出る前に、Sandboxや開発環境で原因を切り分けることが不可欠です。この記事では、リード変換に関するよくあるズレの原因を詳細に解説し、本番反映前に確認すべきポイントを整理します。

リード変換の基本的な仕組みと想定外が起きるパターン

リード変換では、リードの項目値が取引先責任者・商談・取引先の各オブジェクトの項目にマッピングされます。変換時に選択する「取引先」の扱い方(既存取引先を使用、新規取引先を作成)や「商談を作成する」オプションの有無によって結果が変わります。想定外の現象として代表的なものは以下の通りです。

• 変換後、特定の項目が空白になる/異なる値が入る
• 意図しない取引先に紐づけられる(重複取引先が作成される)
• 変換後のレコードタイプが想定と異なる
• 商談が作成されない/不要な商談が作成される
• 変換前に設定したフローやプロセスビルダーが期待通り動作しない

これらの原因を切り分けるには、まず「リード変換の項目マッピング」を確認することが第一歩です。

本番前の切り分け手順:5ステップ

以下の手順でSandbox(または開発者組織)でテストを行い、問題を特定します。手順は管理者権限があることを前提としています。ない場合は管理者に依頼してください。

1. ステップ1:変換元リードのデータを確認する
   変換したいリードのすべての項目値を書き出します。特にカスタム項目や参照関係の項目(取引先企業名、業種など)が正しく入力されているか確認します。例えば「会社」項目が空欄だと、自動生成される取引先名がリードの氏名ベースになるなど、意図しない名前に変わることがあります。
2. ステップ2:リード変換の項目マッピングをエクスポートして目視確認する
   [設定]>[オブジェクトマネージャ]>[リード]>[項目とリレーション]>[項目マッピング]で、変換先(取引先責任者、商談、取引先)へのマッピングをスクリーンショットまたはCSVで書き出します。特に「変換先の項目」と「変換元の項目」の対応が正しいか、空白のマッピングがないかをチェックします。よくあるミスは、変換先の必須項目がマッピングされていないために変換時にエラーになるか、代わりにデフォルト値が適用されるケースです。
3. ステップ3:変換オプションの設定をテストする
   リード変換ダイアログでは「取引先への割り当て方法」と「商談の作成」オプションがあります。これらはユーザが変換時に選択できますが、通常は事前にデフォルトが決められています。Sandboxで以下の3パターンを試し、結果の違いを記録します。
   ・「既存の取引先を使用」で実際の取引先名を指定して変換
   ・「新規取引先を作成」で変換
   ・「商談を作成しない」で変換
   これにより、マッピング以外の要因(重複ルールのチェック、取引先名の自動生成ロジック)が影響しているか判断できます。
4. ステップ4:重複ルールとマージルールを確認する
   [設定]>[重複管理]で、取引先と取引先責任者の重複ルールが有効になっていないか確認します。重複ルールが有効だと、変換時に一致する既存レコードが存在する場合、自動的に重複としてフラグが立ったり、マージが提案されたりします。意図しない既存取引先に紐づく原因の多くはここにあります。Sandboxで重複ルールを一時的に無効にして変換し、挙動が変わるかテストします(本番では勝手に無効にしない)。
5. ステップ5:カスタムロジック(トリガ、フロー、プロセス)の動作を検証する
   リード変換時には、ApexトリガやProcess Builder、フローが起動することがあります。[設定]>[プロセスビルダー]や[フロー]で変換イベントに関連するものを洗い出し、Sandboxで実際に変換を実行して、それらが期待通り値を設定しているか確認します。特に「リード変換後」のトリガで項目を上書きしているケースは、マッピングだけでは予測できません。デバッグログを取得すると原因が明確になります。

状況別の比較表:よくある想定外の症状と主な原因

下の表は、リード変換後にユーザが遭遇する代表的な違和感と、その原因を切り分けるための観点をまとめたものです。本番反映前のテストでこの表を参考にしてください。

管理者に確認すべき設定項目とよくある失敗パターン

管理者に確認すべき設定

• カスタム項目マッピング: 標準の項目マッピングに加え、カスタム項目のマッピングが適切かどうか。特にリードのカスタム項目を変換先の別名カスタム項目にマッピングしている場合、API参照名が正しいか確認が必要です。
• 変換後アクション(フロー・トリガ): 変換後に実行される自動化ロジックの有無と、その中で項目の上書きが行われていないか。
• 権限セットとプロファイル: リード変換を実行するユーザが、変換先オブジェクトの項目への書き込み権限を持っているか。権限不足だと変換は成功しても一部項目が書き込まれないことがあります。

よくある失敗パターン

• 「会社」項目が空欄のリードを変換する: 新規取引先を作成する場合、取引先名はリードの「会社」項目が使用されます。これが空だとリードの氏名(FirstName+LastName)が取引先名になり、後から混乱します。
• マッピングで「変換先を空白にする」を選択している: 誤って「変換先を空白にする」に設定されていると、リードに値があっても変換先には何も入りません。
• Sandboxと本番で設定が異なる: Sandboxでテストして期待通りでも、本番にリリースする前に本番のマッピングや重複ルールがSandboxと同期されているか確認しないと、本番で想定外が発生します。

よくある質問(FAQ)

Q1. リード変換時に「取引先を選択」画面で検索しても既存取引先が表示されない

A. 検索権限や共有設定が原因です。ユーザが取引先レコードに対する参照権限を持っていないか、検索レイアウトで表示される項目が少なすぎる可能性があります。管理者に取引先の参照権限と検索レイアウトを確認してもらいましょう。

Q2. 変換後、商談の所有者が想定と異なる

A. リード変換時の所有者の割り当てルールが影響しています。[設定]>[リード]>[変換設定]で「変換先レコードの所有者」のデフォルト設定を確認してください。「リードの所有者」または「変換を実行したユーザ」を選択できます。また、カスタムの割り当てルールがトリガで上書きしている可能性もあります。

Q3. 変換しようとすると「必須項目が不足しています」とエラーになる

A. 変換先オブジェクト(取引先責任者や商談)に必須項目があるのに、マッピングで対応するリード項目が設定されていない、またはリード側の値が空です。項目マッピングを見直すか、リードの必須項目を埋めてから変換してください。

まとめ

リード変換の想定外の結果を本番前に切り分けるには、項目マッピング、変換オプション、重複ルール、自動化ロジックの4つの領域を順に確認することが効果的です。特にSandboxで実際の操作を再現しながらテストすることで、本番でのトラブルを大幅に減らせます。もし原因が特定できない場合は、変換前後のレコードデータを比較できるレポートを作成し、管理者と共に差分を分析してください。本番反映は必ず変更セットやパッケージを使って実施し、マッピング設定の誤りが混入しないように注意しましょう。