【Salesforce】データインポートウィザードの管理画面で確認したい設定項目

【Salesforce】データインポートウィザードの管理画面で確認したい設定項目
🛡️ 超解決

データインポートウィザードは、Salesforceで日々の業務データを取り込む際に欠かせない機能ですが、時にエラーが発生して作業が止まってしまうことがあります。エラーメッセージだけでは原因が特定できず、何度も同じ操作を繰り返してしまうことも少なくありません。この記事では、データインポートウィザードで問題が生じたときに、管理者画面でどのような項目を確認すればよいのかを具体的に解説します。権限設定やオブジェクト設定、データの入力規則など、チェックすべきポイントを体系的に整理しました。

【要点】この記事で確認すること

  • 最初に見る場所: 管理画面の「データインポート設定」と「ユーザー権限設定」。
  • 切り分けの軸: エラーが画面に出る前に止まるのか(権限・設定)、インポート後に一部失敗するのか(マッピング・ルール)。
  • 注意点: 権限や共有ルールを変更する前に、現在の設定を必ずバックアップまたはスクリーンショットで記録してください。

ADVERTISEMENT

データインポートウィザードのエラー原因を切り分けるための全体像

データインポートウィザードでエラーが発生する原因は、大きく分けて「権限・アクセスに関するもの」「データフォーマットやマッピングに関するもの」「設定やルールによる制約」の3つに分類できます。まずは、どの段階でエラーが出ているかを確認しましょう。例えば、インポートボタンを押す前から「機能がグレーアウトしている」場合は権限不足が疑われます。一方、インポートを実行した後に「エラーレポート」が表示された場合は、データの内容やオブジェクトの設定に問題がある可能性が高いです。

管理画面で確認すべき最初のステップは、該当ユーザーが「データインポートウィザード」を使用できる権限を持っているかどうかです。これはプロファイルまたは権限セットで制御されています。また、インポート対象のオブジェクトに対する「作成」「編集」権限も必要です。以降、具体的な確認手順を説明します。

管理画面で最初に確認すべき項目

最初にチェックするのは、管理画面の「ユーザー」「プロファイル」「権限セット」の各設定です。データインポートウィザードを使用するには、以下の権限が必要です。

  1. 「データインポート」権限(システム管理者権限セットなどに含まれます)
  2. インポート先オブジェクトに対する「作成」または「編集」権限
  3. 「API使用可能」権限(インポートウィザードはAPIを内部的に使用するため)
  4. 「バルク API 使用可能」権限(大量データの場合)
  5. オブジェクトの「参照」権限(関連レコードの紐付けに必要)

これらの権限が不足している場合、インポートウィザードが起動しなかったり、途中でエラーが発生します。まずは対象ユーザーのプロファイルを確認し、不足があれば権限セットで追加するか、プロファイルを編集してください。

データインポート設定の確認ポイント

管理画面の「設定」→「データ」、「データインポート設定」の項目を確認します。ここではインポートに関する全般的な設定が行われています。

インポート可能なオブジェクトの制限

デフォルトでは、すべてのカスタムオブジェクトと標準オブジェクト(取引先、取引先責任者、リードなど)がインポート可能ですが、管理者が特定のオブジェクトを無効にしていることがあります。例えば「ケース」オブジェクトはデフォルトではインポートできません。この設定は「データインポート設定」ページの「インポート可能なオブジェクト」リストで確認できます。自分の組織でインポートしたいオブジェクトがリストに含まれているか確認してください。

CSVマッピングと列の設定

インポートウィザードではCSVの列とSalesforceの項目をマッピングしますが、以下のようなミスがよく発生します。

  • CSVの列名がSalesforceの項目名と完全に一致していない(大文字小文字は無視されますが、スペルミスに注意)
  • 必須項目がCSVに含まれていない
  • 参照関係の項目に無効なID(外部IDの値など)が指定されている
  • 重複ルールに引っかかる(例: 取引先の重複ルールが有効で、同じ名前のレコードが既に存在する)
  • 入力規則が設定されている項目に対して不正な値が入っている

これらの問題はインポート後にエラーレポートで確認できますが、事前にCSVをチェックすることで予防できます。管理画面で該当オブジェクトの「項目」設定を開き、入力規則や必須項目を確認しておきましょう。

ユーザー権限とプロファイル、権限セットの確認

前述した権限に加えて、共有ルールや項目レベルセキュリティもインポート結果に影響します。例えば、ユーザーが特定のレコードタイプにアクセスできない場合、そのレコードタイプに属するレコードのインポートは失敗します。また、項目レベルセキュリティで「参照のみ」になっている項目に書き込もうとするとエラーになります。

以下の表に、権限設定でよくある問題と確認方法をまとめます。

問題の症状 確認すべき設定 対応策
インポートウィザードがグレーアウトしている 「データインポート」権限の有無 権限セットで「データインポート」を追加
インポート実行後に権限エラーが発生 オブジェクトの「作成」権限 プロファイルまたは権限セットで権限を付与
特定の項目だけ空白になる 項目レベルセキュリティ 権限セットで「編集可能」に変更
重複エラーが発生 重複ルールの設定 ルールを一時的に無効化、または重複レコードを先にマージ

外部システムとの連携やWeb-to-Leadなどとの干渉

データインポートウィザードは、単独で動作するものですが、他の機能と干渉する場合もあります。例えば、Web-to-Leadで受信したリードが重複ルールに引っかかる場合、インポート時に同様のエラーが発生します。また、外部システムとの連携(HubSpot、Marketoなど)で同じオブジェクトに自動的にレコードが作成されている場合、インポート時に一意性制約に違反する可能性があります。

管理画面で確認するのは、各オブジェクトの「トリガ」「フロー」「ワークフロールール」です。これらの自動化ルールがインポート時に起動し、予期せぬエラーを引き起こすことがあります。特にトリガでレコードの更新やバリデーションを行っている場合、インポートのデータが条件を満たさないとエラーになります。自動化ルールの有効状態を確認し、必要に応じてテスト環境でインポートを試すことをお勧めします。

エラーログの見方と管理者への報告方法

インポートに失敗した場合、Salesforceは「エラーレポート」をCSV形式でダウンロードできるようにしています。このレポートには、エラーが発生した行番号、エラーメッセージ、失敗した項目名が記載されています。管理画面の「データインポート」タブから、過去のインポートジョブを選択し、「エラーレポートのダウンロード」をクリックしてください。

エラーメッセージの例としては、「重複レコード」、「項目が無効」、「無効なID参照」などがあります。これらのメッセージを元に、前述の確認ポイントを順にチェックします。管理者に報告する場合は、エラーレポートの内容と、どのようなデータをインポートしようとしたのか(CSVのサンプル)を添えて伝えると、原因解決がスムーズです。

また、Salesforceの「デバッグログ」を有効にすると、より詳細なエラー情報を取得できます。ただし、大量のインポートではログが膨大になるため、開発者コンソールから対象ユーザーと時間帯を指定して取得してください。

よくある質問(FAQ)

Q1: データインポートウィザードで「この機能を使用する権限がありません」と表示されます。どこを確認すればよいですか?

A: 管理画面の「ユーザー」→「プロファイル」または「権限セット」で、「データインポート」権限が有効になっているか確認してください。システム管理者プロファイルであればデフォルトで有効ですが、カスタムプロファイルの場合は手動で追加する必要があります。

Q2: インポートは完了したが、一部のレコードが作成されていません。エラーレポートを見ると「外部IDが一致しません」と出ます。

A: 参照項目に対して、外部IDの代わりにSalesforceのレコードID(18桁のID)を誤って入力していないか確認してください。外部IDを使用する場合、その項目が外部IDとして設定されている必要があります。CSVには外部IDの値を正しく入力してください。

Q3: 大量データ(5万件以上)をインポートする場合、注意点はありますか?

A: データインポートウィザードの1回のインポート上限は500万件(標準)ですが、バルクAPIの制限や組織の総データ容量に注意してください。また、大量データをインポートする前に、トリガやフローを一時的に無効化することを検討してください。特にワークフロールールやプロセスビルダーが多すぎると、タイムアウトエラーの原因になります。

以上の確認ポイントを順にチェックすることで、データインポートウィザードの多くの問題は解決できます。それでも原因がわからない場合は、Salesforceのサポートにエラーレポートを添えて問い合わせてください。適切な情報を準備しておくと、解決が早まります。


まとめ

データインポートウィザードで進めない時は、CSVの形式だけでなく、対象オブジェクトの権限、必須項目、重複判定、インポートウィザードで扱える件数と項目の制約を確認します。エラー画面の文言とCSVの先頭数行を保存してから管理者へ渡すと、データローダーへ切り替えるべきかも判断しやすくなります。

この記事の監修者
✍️

超解決 第一編集部

疑問解決ポータル「超解決」の編集チーム。正確な検証と、現場視点での伝わりやすい解説を心がけています。