概要とビジネスシーン
Data Import Wizard（データインポートウィザード）は、Salesforce にデータを迅速かつ容易に取り込むための、管理者にとって不可欠な強力なツールです。CSV（Comma Separated Values）形式のファイルを利用し、リード、取引先、取引先責任者、キャンペーンメンバー、ソリューション、およびカスタムオブジェクトに対して、最大5万件のレコードを一度にインポート、更新、または挿入・更新（Upsert）できます。直感的なUI（User Interface：ユーザーインターフェース）を通じて、項目マッピング、重複ルールの適用、割り当てルールの設定などが簡単に行える点が最大の魅力です。
実際のビジネスシーン
シーンA：中小企業（小売業）
- ビジネス課題：新規顧客獲得キャンペーン後、Excel スプレッドシートに収集したリード情報（約3,000件）をSalesforce に手作業で入力しており、時間と労力がかかるだけでなく、重複データの発生リスクも高かった。
- ソリューション：Salesforce 管理者はData Import Wizard を使用し、キャンペーンで獲得したリードデータを「リード」オブジェクトに一括インポートしました。インポート時に標準の重複ルールを適用し、メールアドレスによる重複レコードの作成を防止。
- 定量的効果：リード登録にかかる時間が従来の80%削減され、営業担当者がキャンペーン終了後すぐに新しいリードに対応できるようになりました。これにより、キャンペーンからの商談成立率が15%向上しました。
シーンB：非営利団体
- ビジネス課題：年次寄付キャンペーン後、外部の寄付プラットフォームからダウンロードした寄付者情報と寄付履歴（約800件）をSalesforce の「取引先」と「商談」オブジェクトに連携させる必要がありました。手動入力ではミスのリスクが高く、データ統合に時間がかかっていました。
- ソリューション：Data Import Wizard を利用して、まず寄付者情報を「取引先」としてインポートし、既存の取引先とのマッチング機能を活用して重複を回避しました。次に、寄付履歴を「商談」としてインポートし、取引先とのリレーションシップを確立しました。
- 定量的効果：データ入力の正確性が95%に向上し、レポート作成にかかる時間が50%短縮されました。これにより、寄付者への迅速なサンキューメール送信と、よりパーソナライズされた関係構築が可能になり、次年度の寄付継続率に貢献しました。
シーンC：ITサービス企業
- ビジネス課題：買収した小規模企業の顧客リスト（約5,000件）を既存のSalesforce環境に統合する必要がありました。既存の取引先との重複を避けつつ、買収元で使われていた特定のカスタム項目（例：レガシーシステムID）もSalesforceのカスタム項目にマッピングして取り込む必要がありました。
- ソリューション：Data Import Wizard の「更新」機能と、カスタム項目（外部IDとして設定されたレガシーシステムID）によるマッチング機能を利用して、既存データとの重複を避けつつ、新しい顧客データを「取引先」オブジェクトに取り込みました。事前にレガシーシステムIDとSalesforceの外部ID項目をマッピングしました。
- 定量的効果：データ統合プロセスが予定より3日短縮され、手動でのデータクレンジング作業が大幅に削減されたことで、人件費を削減できました。統合された顧客データに基づき、クロスセル・アップセルの機会を迅速に特定できるようになりました。
技術原理とアーキテクチャ
Data Import Wizard は、Salesforce の堅牢なデータ管理基盤の上に構築されており、管理者がコーディングなしでデータ操作を行えるよう設計されています。
基礎的な動作メカニズム
Data Import Wizard は、ユーザーがアップロードしたCSVファイルを解析し、選択されたSalesforceオブジェクトのデータモデルと照合します。内部的には、指定されたオブジェクトに対する標準API（通常はSOAP APIまたはREST APIの特定のエンドポイント）を呼び出して、レコードの作成、更新、またはUpsert（挿入と更新の組み合わせ）を実行します。このプロセス中、Salesforceプラットフォームは、データ型検証、必須項目チェック、重複ルール評価、割り当てルール適用など、一連のデータ整合性チェックとビジネスロジックの実行を自動的に行います。
主要コンポーネントと依存関係
- UI（ユーザーインターフェース）：直感的なウィザード形式で、ファイルの選択、オブジェクトの指定、項目マッピング、設定オプションの指定を案内します。
- CSVパーサー：アップロードされたCSVファイルを読み込み、ヘッダーとレコードデータを構造化します。
- マッピングエンジン：CSVファイルのヘッダーとSalesforceオブジェクトの項目（標準・カスタム）を関連付けます。自動マッピング機能と手動調整オプションを提供します。
- データ検証エンジン：Salesforceオブジェクトの定義（データ型、長さ、必須性など）に基づいて、インポートデータの妥当性をチェックします。
- 重複検出エンジン：設定されたマッチングルール（標準またはカスタム）に基づいて、インポートレコードと既存レコードの重複を検出します。
- 処理エンジン：実際にSalesforceデータベースに対して、レコードの挿入、更新、またはUpsert操作を実行します。
- 結果レポートジェネレーター：インポート処理の成功レコード、失敗レコード、およびエラーメッセージを含む詳細なレポートを生成し、ダウンロード可能にします。
データフロー
| ステップ | 説明 | 技術的側面 |
|---|---|---|
| 1. ファイル選択とオブジェクト指定 | インポートするCSVファイルと対象Salesforceオブジェクトを選択 | UI入力、データモデル選択 |
| 2. 項目マッピング | CSVヘッダーとSalesforce項目を関連付け、未マッピング項目を確認 | メタデータAPIによる項目リスト取得、自動/手動マッピングロジック |
| 3. 詳細設定 | 重複処理、割り当てルール、ワークフロールールなどの適用可否を設定 | システム設定の参照、ユーザー選択に応じたフラグ設定 |
| 4. インポート実行 | 設定内容に基づいてデータインポート処理を開始 | Salesforce API（Bulk APIのサブセット相当）の内部呼び出し |
| 5. データ検証と処理 | プラットフォームがデータ型チェック、必須項目検証、重複ルール、自動化を実行 | データベーストランザクション、Apexトリガー・フロー・ワークフローの実行 |
| 6. 結果通知とレポート生成 | インポート結果（成功/失敗）をユーザーに通知し、詳細レポートを提供 | 非同期処理キュー、ログ記録、CSVファイル生成 |
ソリューション比較と選定
SalesforceにはData Import Wizard以外にも複数のデータ操作ツールがあります。それぞれの特性を理解し、適切なツールを選択することが重要です。
| ソリューション | 適用シーン | パフォーマンス | Governor Limits | 複雑度 |
|---|---|---|---|---|
| Data Import Wizard | 数十件から数万件の小規模〜中規模データ、単一オブジェクト、GUIベースの手動操作。リード、取引先、取引先責任者、キャンペーンメンバー、ソリューション、カスタムオブジェクトに限定。 | 中速（GUI操作のオーバーヘッドあり） | 1回あたり最大 50,000 レコード | 低（直感的なUI） |
| Data Loader | 数万件から数百万件の大規模データ、全ての標準・カスタムオブジェクト、CLI（Command Line Interface）による自動化も可能。複雑なオブジェクトリレーション（例：親レコードの参照先を指定）に対応。 | 高速（バッチ処理） | 1回あたり最大 500 万レコード | 中（初期設定やCLI操作の学習が必要） |
| Apex Data Loader (API) | プログラムによる高度な自動化、複雑なビジネスロジックを伴うデータ操作、外部システム連携。 | 最速（直接API呼び出し） | Salesforce API制限（通常バッチサイズ200レコード） | 高（開発スキルが必要） |
| Heroku Connect / ETLツール | Salesforceと外部データベース間の継続的なデータ同期、大規模なデータウェアハウスとの連携、複雑なデータ変換・統合。 | 非常に高速（最適化された同期エンジン） | 外部システムとSalesforce API制限に依存 | 非常に高（専門知識とインフラ構築が必要） |
data import wizard を使用すべき場合：
- ✅ 5万件未満のデータインポート/更新：比較的小規模なデータセットを扱う場合に最適です。
- ✅ 手動での操作が容易で、定期的な自動化が不要な場合：ワンショットのデータ投入や更新に適しています。
- ✅ インポート対象オブジェクトが限定されている場合：リード、取引先、取引先責任者、キャンペーンメンバー、ソリューション、カスタムオブジェクトへのインポート時に有効です。
- ✅ 重複ルールや割り当てルールを適用したい場合：GUI上で簡単に設定でき、データ品質を維持できます。
- ✅ Salesforceの標準UIから直接操作したい場合：外部ツールをインストールする必要がないため、手軽に利用できます。
❌ 不適用シーン：
- ❌ 5万件を超えるレコードを頻繁に処理する場合：Data Loader の使用を推奨します。
- ❌ 複数のオブジェクトにまたがる複雑な親子関係を一度にインポートする場合：Data Loader のリレーションシップマッピング機能が適しています。
- ❌ 完全な自動化、スケジュールされたデータ同期が必要な場合：Data Loader CLI、Apex、またはETLツールを検討すべきです。
実装例（設定例と技術的ポイント）
Data Import Wizard はGUIベースのツールであり、直接的なコードの実装は存在しません。しかし、CSVファイルの構造やマッピングの工夫は、その「実装」における重要な側面です。ここでは、リードオブジェクトへのデータインポートを例に、CSVファイルの構成と、ウィザードでの設定の技術的ポイントを解説します。
CSVファイル例：新規リードのインポートと既存リードの更新（外部ID利用）
以下のCSVファイルは、新規リードの挿入と、カスタムの外部ID Legacy_ID__c を利用した既存リードの更新を想定しています。
// Data Import Wizard にインポートするリードのCSVサンプル // 外部ID (Legacy_ID__c) を利用して既存レコードを更新する場合の例 "FirstName","LastName","Company","Email","Phone","LeadSource","Status","Legacy_ID__c" "John","Doe","ABC Corp","john.doe@abccorp.com","111-222-3333","Web","Open - Not Contacted","LID001" "Jane","Smith","XYZ Inc","jane.smith@xyzinc.com","444-555-6666","Partnership","Working - Contacted","LID002" "Robert","Johnson","123 LLC","robert.j@123llc.com","777-888-9999","Employee Referral","Qualified","LID003" "Alice","Brown","NewTech Solutions","alice.b@newtech.com","123-456-7890","Direct Mail","Open - Not Contacted","" // 新規リード "David","Wilson","ABC Corp","david.w@abccorp.com","987-654-3210","Web","Working - Contacted","LID001" // 既存LID001の更新
各主要項目の解説：
"FirstName","LastName","Company","Email","Phone"：標準のリード項目です。CSVファイルのヘッダーはSalesforceの項目API参照名と一致させる必要はなく、後でマッピングできますが、一致していると自動マッピングがより正確になります。"LeadSource","Status"：選択リスト項目です。CSVの値はSalesforceで定義されている選択リスト値と正確に一致させる必要があります。一致しない場合、インポートエラーとなるか、デフォルト値が適用されることがあります。"Legacy_ID__c"：これはカスタム外部ID項目の例です。Salesforceのカスタム項目として「テキスト」型で作成され、「外部ID」としてチェックされています。Data Import Wizardで既存レコードを更新またはUpsertする際に、SalesforceレコードIDの代わりにこの外部IDを使用してレコードをマッチングさせることができます。"LID001","LID002","LID003"：既存リードを識別するための値です。""(空欄)：この行は新しいリードとして扱われます。
Data Import Wizard でのインポート手順（技術的ポイント）
- ウィザードの起動：Salesforce 設定 (Setup) から「データインポートウィザード」を検索し、起動します。
- インポート対象の選択：「標準オブジェクト」の中から「リード」を選択し、「レコードの追加と更新」または「新規レコードの追加」を選択します。外部IDを利用した更新を行う場合は「既存のレコードを更新」または「新規レコードを追加し、既存のレコードを更新」を選びます。
- CSVファイルのアップロード：上記で準備したCSVファイルをアップロードします。
- 項目マッピングの確認と調整：
- Data Import Wizard は、CSVヘッダーとSalesforce項目を自動的にマッピングしようとします。正確にマッピングされているか確認します。
- 特に重要なのは、カスタム外部ID項目（例：
Legacy_ID__c）をSalesforceの対応する外部ID項目に正確にマッピングすることです。これが既存レコードを識別するキーとなります。 - マッピングされていない必須項目がないか確認し、必要に応じて「スキップ」またはSalesforce項目にマッピングします。
- 詳細設定オプションの選択：
- 重複処理：外部IDでの更新を選択した場合、この設定が重要です。外部IDが一致するレコードは更新され、一致しない場合は新規作成されます。
- 割り当てルールとワークフローの実行：通常、新規リードに割り当てルール（例：リードキューへの自動割り当て）やワークフロー（例：通知メール送信）を適用したい場合はチェックを入れます。インポートパフォーマンスを優先し、副作用を避けたい場合はチェックを外すことも検討します（「注意事項とベストプラクティス」参照）。
- インポートの開始と結果確認：すべての設定を確認後、インポートを開始します。完了後、成功したレコードと失敗したレコードのファイルをダウンロードし、エラーがあればその原因を特定して対処します。
注意事項とベストプラクティス
権限要件
Data Import Wizard を利用するには、以下の権限がユーザープロファイルまたは権限セットで付与されている必要があります。
- "Import Records" 権限：データインポートウィザードを使用するための基本的な権限です。
- オブジェクトごとの "Create" および "Edit" 権限：インポート対象のオブジェクト（例: リード、取引先）に対して、それぞれレコードを作成または更新する権限が必要です。
- 関連するカスタム項目へのアクセス権限：インポートするカスタム項目に対する参照および編集権限が必要です。
- "View All Data" または "Modify All Data" (場合による)：組織全体のデータを扱う場合、これらの権限が必要となることがあります。通常は "Import Records" とオブジェクトごとの権限で十分です。
Governor Limits
Data Import Wizard には以下の主要な制限があります。
- 最大レコード数：1回のインポート操作で、最大 50,000 レコードまで処理できます。これを超える場合は、ファイルを分割するか、Data Loader の使用を検討してください。
- ファイルサイズ：明示的なファイルサイズ制限はあまり強調されませんが、CSVファイル内のデータ量（文字数）が増えすぎると、ブラウザのタイムアウトや処理の遅延が発生する可能性があります。
- API制限：内部的には Salesforce の API を利用しており、組織のAPIコール制限に間接的に影響を与える可能性がありますが、通常のGUI操作では意識することは少ないでしょう。
エラー処理
インポート中にエラーが発生した場合、ウィザードの完了画面で「エラーを表示」リンクからエラーログをダウンロードできます。一般的なエラーと解決策は以下の通りです。
- 必須項目不足：Salesforceで必須となっている項目がCSVファイルに含まれていないか、マッピングされていない。→ CSVファイルに項目を追加し、値を入力するか、Salesforceの必須設定を見直す。
- 無効なデータ型：数値項目にテキスト値が含まれている、日付形式がSalesforceの要件と異なるなど。→ CSVファイルを修正し、正しいデータ型と形式に合わせる。
- 参照整合性エラー：ルックアップ項目に存在しないIDや名前を指定している。→ CSVファイルの参照値をSalesforceに存在する値に修正する。
- 重複エラー：重複ルールが有効な状態で、既存レコードと重複するデータがインポートされた。→ 重複ルールを見直すか、重複データを事前にクレンジングする。
解決策：エラーファイルを分析し、エラーが発生した行のみを修正した新しいCSVファイルを作成して、再度インポートするのが効率的です。
パフォーマンス最適化
- データクレンジングの徹底：インポート前にCSVファイルのデータ品質（重複、データ型、必須項目の有無、選択リスト値の一致）を確保することで、インポートエラーを最小限に抑え、処理時間を短縮します。
- 自動化の一時停止：インポート対象のオブジェクトに設定されているApexトリガー、ワークフロールール、プロセスビルダー、フローなどを一時的に無効化することで、インポート処理のパフォーマンスを向上させ、予期せぬ副作用（大量メール送信、予期せぬ更新）を回避できます。完了後、必ず再有効化してください。
- 外部IDの活用：既存レコードを更新する際に、SalesforceレコードID（15桁または18桁のID）ではなく、カスタム外部ID（例: レガシーシステムID）をCSVファイルに含めてマッチングキーとして使用すると、より効率的にレコードを識別し、処理できます。
- バッチサイズの考慮：Data Import Wizard は自動的にバッチ処理を行いますが、CSVファイルをさらに論理的な塊に分割してインポートすることで、特定のエラー発生時に影響範囲を限定しやすくなります。
よくある質問 FAQ
Q1：Data Import Wizard でインポートできるオブジェクトの種類は？
A1：Data Import Wizard で直接インポートできるのは、リード、取引先、取引先責任者、キャンペーンメンバー、ソリューション、およびカスタムオブジェクトに限定されます。その他の標準オブジェクト（例：商談、ケース）や、より複雑な親子リレーションシップを持つデータの一括処理には、Data Loader を使用する必要があります。
Q2：インポート中にエラーが発生した場合、どうすればよいですか？
A2：インポート完了画面で提供される「エラーファイル」をダウンロードし、内容を確認してください。このファイルには、どのレコードが、どのような理由（例：必須項目不足、無効な選択リスト値、データ型不一致）で失敗したかが詳細に記載されています。CSVファイルを修正し、エラーが発生したレコードのみを抜き出して再度インポートすることで、効率的に問題を解決できます。
Q3：Data Import Wizard でインポートしたレコードに対して自動化（ワークフロー、プロセス、フロー、トリガー）は実行されますか？
A3：はい、デフォルトでは実行されます。これは、データインポートを通じて通常のユーザー操作と同様にビジネスロジックが適用されるためです。インポート中に自動化を一時的に無効化するオプションを選択することで、パフォーマンスの向上や予期せぬサイドエフェクトの回避が可能ですが、ビジネス要件とインポートの目的によっては、自動化の実行を継続させる必要があります。事前にテスト環境で影響を確認することをお勧めします。
まとめと参考資料
Salesforce Data Import Wizard は、管理者がSalesforceのデータを効率的に管理するための、非常にアクセスしやすく強力なツールです。GUIベースの直感的な操作性、重複防止機能、そして主要な標準オブジェクトおよびカスタムオブジェクトへの対応は、日々のデータ管理業務において不可欠な機能を提供します。
しかし、その限界（レコード数制限、オブジェクトの制約）を理解し、Data Loader や Apex などのより高度なツールと適切に使い分けることが、Salesforce環境全体のデータ品質とパフォーマンスを最適化する鍵となります。本記事で解説したビジネスシーン、技術的側面、ベストプラクティス、およびFAQを参考に、Data Import Wizard を最大限に活用してください。
公式リソース：
- 📖 公式ドキュメント：データのインポートウィザードを使用してデータをインポートする
https://help.salesforce.com/s/articleView?id=sf.admin_import.htm&type=5 - 📖 公式ドキュメント：データのインポートウィザードを習得する
https://help.salesforce.com/s/articleView?id=sf.basics_data_import_wizard.htm&type=5 - 🎓 Trailhead モジュール：データ管理
https://trailhead.salesforce.com/content/learn/modules/data_management/data_import
コメント
コメントを投稿