【Salesforce】CSVインポートで困った時のレポート条件と項目設定の直し方

SalesforceでCSVインポートを実行した際に、エラーが発生してデータが反映されないという経験は多くの会社員が直面する課題です。インポートが失敗する原因は多岐にわたりますが、特に「レポート条件の誤り」と「項目設定の不一致」が主要原因であることが少なくありません。本記事では、CSVインポートで困ったときにまず確認すべきレポート条件と項目設定の直し方を、具体的な手順や失敗パターンとともに解説します。これを読めば、原因を効率的に切り分け、管理者に依頼すべき設定も明確に把握できます。

CSVインポートで発生する主なエラーとその原因

CSVインポートが失敗するエラーは、大きく分けて「データ形式エラー」「参照整合性エラー」「権限エラー」「レポート条件エラー」の4種類に分類できます。それぞれのエラーが示す問題を理解することで、素早く原因を特定できます。

エラーコードから読み取る問題の切り分け

SalesforceのインポートウィザードやData Loaderが返すエラーメッセージには、多くの場合「項目が見つかりません」「値が無効です」「必須項目が不足しています」といった具体的な手がかりが含まれています。例えば「INVALID_FIELD_FOR_EXCEPTION」や「FIELD_INTEGRITY_EXCEPTION」は、CSVの列名とSalesforceの項目名が一致していない可能性が高いです。一方、「REQUIRED_FIELD_MISSING」は、必須項目に値が入っていないことを示します。これらのエラーコードを記録しておき、後述の手順で確認する際の材料にしてください。

データ形式と必須項目の不一致

CSVファイルの日付形式が「2025/01/31」なのにSalesforceが「2025-01-31」を期待している、電話番号にハイフンが入っていない、など細かなフォーマットの違いもインポート失敗の原因になります。また、参照項目(例えば取引先責任者の取引先ID)が存在しないIDを指定している場合もエラーとなります。こうした問題は、CSVの内容を吟味するだけでなく、Salesforce側の項目定義を確認する必要があります。

レポート条件の確認と修正手順

レポート条件は、インポート時にデータをどのレコードに紐付けるか、あるいは既存レコードを更新するかどうかを決定する重要な要素です。特に「外部ID」を使用したマッチングルールや、インポート前に設定する「レポート条件」が誤っていると、データが正しく取り込まれません。以下に、レポート条件を確認・修正する手順を示します。

1. Salesforceにログインし、画面右上の歯車アイコンから「設定」を開きます。
2. クイック検索ボックスに「データインポート」または「インポートウィザード」と入力し、該当するメニューをクリックします。
3. 過去のインポートジョブの履歴を開き、エラーが発生したジョブの「詳細」を表示します。
4. 「レポート条件」のセクションで、使用している外部IDの項目名と、CSVのヘッダーが一致しているか確認します。
5. もし外部IDを使用してレコードを更新する場合、CSVにその外部IDの値が正しく入力されているか、重複がないかをチェックします。
6. 必要に応じて、レポート条件を編集し「保存」します。特に複数のオブジェクトを関連付ける場合は、親子関係の基準を再確認してください。

この手順を踏んでも解決しない場合、レポート条件そのものがSalesforceの仕様と合っていない可能性があります。例えば、外部ID項目がインポート時に参照可能な状態になっていないケースがあります。その場合は次の項目設定の確認に進みます。

項目設定の直し方(項目レベルセキュリティとフィールドマッピング)

CSVインポートで頻繁に発生するのが、項目レベルセキュリティ(FLS)やフィールドのマッピング設定が原因でデータが書き込めないという問題です。特に「項目が見つかりません」というエラーは、CSVの列名とSalesforceのAPI参照名が完全に一致していないか、その項目への書き込み権限がないことを意味します。

項目レベルセキュリティの確認と変更

自分がインポートを実行するユーザープロファイル(または権限セット)が、CSVに含まれるすべての項目に対して「編集可能」権限を持っているか確認してください。確認手順は以下の通りです。

1. 「設定」→「プロファイル管理」から自分のプロファイルを選択します。
2. 「オブジェクト設定」で該当オブジェクト(例:取引先、商談)を開き、「項目レベルセキュリティ」の編集ボタンをクリックします。
3. CSVでインポートしようとしている各項目に「読み取り許可」と「編集許可」がチェックされているか確認します。
4. チェックが外れている項目があれば、管理者に依頼して有効化してもらうか、自分に権限セットが割り当てられている場合はそちらで権限を追加します。

この権限がないままインポートを実行すると、エラーにはなりませんが一部の項目が空欄になる場合もあります。その場合はエラーログに「FIELD_FILTERED」のようなメッセージが記録されます。

カスタム項目の設定ミスを直す

カスタム項目のAPI参照名がCSVのヘッダーと異なっているケースです。例えば、画面表示名は「顧客ランク」でもAPI参照名は「Customer_Rank__c」であるため、CSVのヘッダーを「顧客ランク」としてしまうとマッチしません。必ずAPI参照名(末尾に__cが付く)をCSVの列名に使用してください。また、数式項目や自動計算項目はインポート対象外ですので、CSVから削除しておきましょう。

状況別:CSVデータが取り込めない原因と対処法の比較表

状況	考えられる原因	確認するポイント	対処法
インポートは成功したが一部の項目が空	項目レベルセキュリティで書き込み権限なし	エラーログにFIELD_FILTEREDがあるか	プロファイルまたは権限セットで編集権限を付与
「項目が見つかりません」エラー	CSVの列名とAPI参照名が不一致	設定>オブジェクトマネージャでAPI参照名を確認	CSVのヘッダーをAPI参照名に変更
「重複レコード」エラー	重複ルールが競合	設定>重複ルールで条件を確認	一時的にルールを無効化、またはマッチングルールを調整
レコードが作成されず更新もされない	レポート条件の外部IDが一致しない	インポートジョブのレポート条件設定	外部IDの値をCSVで正しく設定し直す、またはレポート条件を変更

失敗パターンと回避策

実務でよく見られる失敗パターンをいくつか紹介します。これらを事前に把握しておくことで、インポートの手戻りを防げます。

文字コードや区切り文字の問題

CSVファイルをExcelで編集・保存すると、文字コードがUTF-8ではなくShift_JISになることがあります。SalesforceはUTF-8を推奨しているため、インポート前にCSVをUTF-8(BOMなし)で保存し直してください。また、項目内にカンマや改行が含まれている場合、ダブルクォーテーションで囲まれていないと列がずれる原因となります。CSVのエクスポート時には必ずダブルクォーテーションで囲む設定にしましょう。

重複ルールによるインポート失敗

組織で重複ルールが有効になっている場合、インポート時に新しいレコードが既存レコードと重複しているとエラーになります。特に取引先やリードで発生しやすいです。回避策として、インポート前に重複ルールを一時的に無効化するか、マッチングルールを調整して外部IDで重複を許容する設定に変更します。ただし、これは管理者権限が必要な作業のため、管理者に相談してください。

管理者に確認すべき設定と注意点

CSVインポートのトラブルシューティングでは、自分で変更できない設定が原因の場合があります。以下の項目は管理者に確認を依頼しましょう。

• 外部ID項目の設定: 外部IDとして使用する項目に「外部ID」属性が付いているか確認する必要があります。設定>オブジェクトマネージャで該当項目を開き、「外部ID」チェックボックスがオンになっていることを確認します。
• インポート権限: ユーザープロファイルまたは権限セットに「データインポート」権限があるかどうか。これがないとインポートウィザード自体が使用できません。
• 共有設定: 組織の共有モデルが「参照のみ」などの制限がある場合、インポートしたレコードが他のユーザーに見えないことがあります。必要に応じて共有ルールの追加を依頼します。
• トリガやワークフロー: インポートによって起動するトリガやプロセスがエラーを発生させている可能性があります。管理者に該当の自動化ルールを一時停止してもらうことも検討してください。

よくある質問(FAQ)

Q1: CSVインポートで「レポート条件に一致しません」と出ました。どうすればよいですか?
A: まずインポートジョブのレポート条件設定を開き、使用している外部ID項目がCSVのデータと合致しているか確認してください。外部IDの値が正確でないか、項目自体が外部IDとして設定されていない可能性があります。

Q2: 項目レベルセキュリティを自分で変更できますか?
A: 一般的に、一般ユーザーは自分自身のプロファイルを編集できません。権限セットが割り当てられていれば、その権限セットの項目設定を変更できる場合がありますが、多くの組織では管理者に依頼する必要があります。必ず管理者に相談してください。

Q3: CSVの列名を間違えました。修正せずにインポートする方法はありますか?
A: Salesforceのインポートウィザードには「フィールドマッピング」機能があり、CSVの列名とSalesforceの項目を手動で紐付けることができます。ただし、大量の列がある場合はCSV自体を修正するほうが確実です。

Q4: インポート後にデータが反映されないのですが、エラーは出ていません。
A: インポートが成功していても、ページのキャッシュが原因で表示されないことがあります。画面をリフレッシュするか、別のリストビューで確認してみてください。それでも反映されていない場合、レポート条件が更新ではなく新規作成になっている可能性があります。インポートモードを「更新」に変更して再実行してみてください。

まとめ

CSVインポートのトラブルは、レポート条件と項目設定の2点を重点的にチェックすることで、ほとんどの原因を特定できます。エラーメッセージを読み解き、CSVのデータ形式やAPI参照名の一致、項目レベルセキュリティの権限を確認する手順を習慣化しましょう。管理者にしか変更できない設定がある場合は、躊躇せずに相談することがスムーズな解決への近道です。本記事の手順を参考に、インポート作業の効率を向上させてください。