CRMデータのエクスポート:安全でコンプライアンスに沿った、移行に対応したファイルのためのベストプラクティス

CRMのエクスポートは、ワンクリックのボタンのように見えます。しかし実際には、リレーショナルなデータが行へと平坦化され、エンコーディングが静かに壊れ、PIIが管理されたシステムから外に出る瞬間です。移行の準備をしている場合でも、並行レポート用にデータを供給する場合でも、一度でクリーンにエクスポートする方法を以下に示します。

約7分で読めます8セクション2026年6月22日

執筆

Kostadin Stamboliev

創業者・Imaginator

Pineido の創業者・Imaginator。IT コンサルティング、アプリ・ウェブ開発、テクニカル SEO、AI と自動化に携わる。スコープと責任を明確にした 30 日間のスプリントで本番コードを届ける。

LinkedIn

エクスポートを押す前に、エクスポートの目的を決める

正しいエクスポートは目的によって変わります。移行前の抽出には、すべてのオブジェクト、すべてのリレーションのリンク、そして凍結された一時点が必要です。並行レポート用のフィードには、添付ファイルや使われていないフィールドを引きずらずに、スケジュールに沿って取得できるクリーンで再現可能なサブセットが必要です。これらは別物として扱ってください。混乱を生む最速の方法は、移行のためにエクスポートしている最中に営業担当者が旧システムを編集し続けることなので、明確なデータカットオフ日を設定してください。これは、それ以降は新しいレコードや編集がレガシーCRMに入らない時点であり、ファイルが読み込まれる前に古くなってしまわないようにするためのものです。レポート用フィードでは逆です。増分取得が望ましいので、次回フィルタできる最終更新タイムスタンプを取得しておきます。

依存関係の順序で、オブジェクトごとにエクスポートする

CSVは平坦なグリッドです。あなたのCRMは、取引先が連絡先にリンクし、連絡先が商談にリンクし、商談が活動にリンクするグラフです。すべてを1つの巨大ファイルにエクスポートすると、それらのリンクが壊れます。代わりに、オブジェクトごとに1ファイルをエクスポートし、標準的な順序に従ってください。ユーザーとロール、次に取引先と会社、次に連絡先とリード、次に商談とオポチュニティ、次に活動とメモ、次に添付ファイル、そして最後にカスタムオブジェクトです。カスタムオブジェクトは通常いくつかの標準オブジェクトを参照するので、それらの親が存在した後に来なければなりません。この順序は官僚主義ではありません。戻すときに順序を1つ間違えてインポートすると、商談がどのパイプラインにも属さず孤立し、営業チームから見えなくなるのです。

IDを保持しないと、リレーションを手作業で再構築することになる

これは最も見落とされがちな一手です。エクスポートされた各行には、元システムのレコードIDに加えて、その親のID(連絡先における取引先ID、商談における連絡先IDと取引先ID)を持たせるべきです。再インポートすると、各親はターゲットシステムで新しいIDを取得するので、旧IDから新IDへのマッピングを記録し、そのマップを次のオブジェクトの読み込みに渡すことで子が正しく紐づきます。IDを省略すると、何万件ものレコードにわたって関連付けを手作業で再構築することになり、これが「完了した」はずの移行が運用上は壊れていることが判明する最も一般的な原因です。行数だけでなくリレーションを検証することこそが、すべての勝負どころです。

毎週、オペレーションのヒントを受け取る

サービス業の経営者・運営者と一緒に、オペレーション、自動化、成長に関する実践的なヒントを毎週1つ受け取りましょう。

人間であることを確認しています。まもなく送信できます。

スパムは送りません。いつでも配信停止できます。

登録が完了しました。次号を受信トレイでお待ちください。

CSVのフォーマットを正しくする:エンコーディング、区切り文字、先頭のゼロ

エクスポートの損傷のほとんどは静かに起こり、ファイル形式の中に潜んでいます。UTF-8でエクスポートすれば、ダイアクリティカルマークやキリル文字、絵文字を含む名前が文字化けした記号に変わらずに生き残ります。古典的な落とし穴に注意してください。Salesforceのレポート用CSVはバイトオーダーマークのないUTF-8で、Windows上のExcelはそれをWindows-1252と想定して開くため、誰かがファイルをダブルクリックした瞬間に文字が壊れます。代わりに「データ」、「テキストまたはCSVから」を通して開き、エンコーディングを65001(UTF-8)に設定してください。HubSpotも同様に、ファイルに外国語の文字が含まれる場合はUTF-8を要求し、UTF-16やWindows-1252のファイルはよくあるマッピング失敗です。他の静かな破損にも気をつけてください。Excelは、それらの列をテキストとして扱わない限り、郵便番号や電話番号、外部IDの先頭のゼロを取り除きます。フリーテキストのフィールドは文字数の上限で切り詰められ、日付ロケールの混在(MM/DD対DD/MM)やISOコードのない通貨は下流で検証を壊します。値が識別子であれば、それは数値ではなくテキストです。

プラットフォームのエクスポート上限とウィンドウを尊重する

ネイティブのエクスポートには、規模が大きくなると噛みついてくるルールがあります。Salesforceはエクスポートを48時間しか利用可能な状態に保たず、新しい手動またはスケジュールされたエクスポートを開始すると、たとえそのウィンドウ内にあっても、前のものを即座に削除します。組織は一度に1つのエクスポートセットしか保持しないためです。速やかにダウンロードしてください。Salesforceはエクスポートをそれぞれ約512 MBのZIPファイルにまとめ、大きなエクスポートを複数のZIPに自動分割します。数千件を超えるレコードを戻すには、UIではなくBulk APIを使ってください。HubSpotのインポートと同時実行の上限はプランごとに段階分けされています。無料および基本アカウントは最大20 MBのファイルと1日あたり最大500,000行を許可し、Starter、Professional、Enterpriseは最大512 MBのファイルを許可します。マーケティングページにある層ではなく、実際に持っている層を基準にバッチを計画してください。

エクスポートはPIIイベントとして扱う。実際にそうだから

データがCRMを離れた瞬間、それはシステムのアクセス制御と監査証跡から離れます。これは単なるITの作業ではなく、コンプライアンスのイベントです。データ最小化を適用してください。仕事に必要なフィールドとレコードだけをエクスポートします。なぜなら、持ち越すすべてのレコードは、GDPRの下であなたが積極的に処理しているデータであり、それに伴うすべての義務を負うからです。ファイルは転送中も保管時も暗号化し、暗号化されていないCSVを共有クラウドストレージやメールの添付ファイルに置いたままにしないでください。誰が何をいつエクスポートしたかの監査証跡を残してください。そして保持と削除の権利に留意してください。「念のため」に何年分もの非アクティブな連絡先をエクスポートしているなら、おそらく自社の保持ポリシーに反して動いており、CCPAは暗号化されていない個人情報が侵害された場合に限り、カリフォルニア州の住民に私的訴権を与えます。テスト実行では、本番データをサンドボックスに渡すのではなく、実際のPIIをマスキングまたは仮名化してください。

ファイルを信頼する前に検証する

完成したエクスポートは、確認するまでは仮説にすぎません。まずレコード件数の照合から始めます。ファイル内の取引先、連絡先、商談、活動の合計をオブジェクトの種類ごとにライブシステムと比べ、すべての不一致を丸めて済ませるのではなく調査します。それから件数より深く掘り下げてください。件数だけでは最悪の失敗が隠れてしまうからです。オブジェクトごとに50件から100件のレコードを抜き取り、カスタムフィールドを含めたフィールドレベルの正確性を確認し、親子のリンクが実際に解決することを検証します。マッピングの後ではなく前に重複排除をしてください。重複は重複した関連付けや同意レコードとして持ち越され、向こう側でほどくのははるかに苦痛だからです。さらに本物の重複はあいまいで(省略された名前、入れ替わったメールドメイン、まちまちの会社の接尾辞)、完全一致の重複排除では不十分です。このエクスポートが移行に供給されるなら、まずオブジェクトごとに数百件のレコードで小さなテスト読み込みを実行してください。壊れたマッピングを捕まえるコストは200行であって、50,000行ではありません。

Pineidoが役立つところ

ほとんどのチームは、上記のチェックリストでクリーンなエクスポートを実行できます。難しくなるのは、カスタムオブジェクト、規模に応じたあいまいな重複排除、そして再インポートが件数だけでなくリレーションを保持したことを証明することです。それが私たちのCRMおよび移行スプリントの仕事です。$8,500の固定された30日間のスコープで、エクスポート計画、文書化されたフィールドとIDのマップ、サンドボックスでのドライラン、そしてあなたが承認できる照合を提供します。エクスポートが移行ではなくレポートのためであれば、私たちのレポート信頼スプリントが、再現可能でエンコーディングに強い取得を構築し、ダッシュボードがCRMと食い違うのをやめさせます。

リリースの準備はできましたか?

どこで行き詰まっているかを教えてください。内容を確認し、1営業日以内に的を絞った提案をお送りします。

よくある質問

CSVにエクスポートすべきか、それともAPIを使うべきか?

CSVは、小中規模のデータセット、一度きりの取得、予算を意識するチームには適しています。手軽でどこでも使えます。大規模なインスタンス、繰り返しの差分取得、または再インポートで数千件を超えるものには、代わりにプラットフォームのバルクAPIまたはバッチAPIを使ってください。ページネーション、レート制限、UIエクスポートでは詰まってしまう大量のデータを処理できるからです。多くのチームは両方を行います。一括の履歴読み込みにはネイティブのUIエクスポートを、その後に変更されたレコードにはAPIの差分更新を使います。

CRMデータをエクスポートした後、なぜ特殊文字が壊れるのか?

ほぼ確実に、そのファイルがUTF-8として読み込まれていません。CRMは内部でデータをUTF-8として保存しますが、Salesforceのレポート用CSVはバイトオーダーマークなしで提供されるため、Windows上のExcelはWindows-1252と想定し、ファイルを開いた瞬間にアクセント付きや非ラテン文字を文字化けさせます。CSVはExcelの「データ」、「テキストまたはCSVから」のパスを通して開き、エンコーディングを65001(UTF-8)に設定してください。Excelから保存するときは、既定でマシンのANSIエンコーディングになることに注意し、書き込み時にUTF-8を強制するツールまたは設定を使ってください。

エクスポートにレコードIDを本当に保持する必要があるのか?

はい、再インポートされるあらゆるエクスポートには必要です。各行の元システムIDに親IDを加えたものが、旧レコードをターゲットの新しいIDにマッピングし、連絡先を取引先に、商談を両者に再び紐づけることを可能にします。そのマッピングがないと、リレーションを手作業で再構築することになり、これが移行が完了したように見えて運用上は壊れている最も一般的な原因で、孤立した商談や切り離された活動が生じます。

CRMデータをエクスポートする際のコンプライアンス上のリスクは何か?

エクスポートはPIIをCRMのアクセス制御と監査証跡の外へ引き出すので、プライバシーのイベントです。必要なフィールドとレコードだけをエクスポートし(データ最小化)、ファイルを転送中も保管時も暗号化し、暗号化されていないCSVを共有ストレージやメールに置いたままにせず、誰が何をいつエクスポートしたかを記録してください。GDPRの下では持ち越すすべてのレコードがあなたが処理しているデータであり、CCPAの下ではカリフォルニア州の住民が暗号化されていない個人情報の侵害時に限り私的訴権を持つので、暗号化は任意ではありません。

エクスポートが完全で正しいことをどう確認するのか?

オブジェクトの種類ごとにファイルとライブシステムの間でレコード件数を照合し、すべての不一致を追跡してください。件数だけでは不十分なので、オブジェクトごとに50件から100件のレコードを抜き取り、カスタムフィールドを含めたフィールドの正確性を確認し、親子のリンクが解決することを確かめます。エクスポートが移行に供給されるなら、オブジェクトごとに数百件のレコードで小さなテスト読み込みを実行し、完全な読み込みを確定する前に、行だけでなくリレーションを検証してください。

データカットオフ日とは何で、なぜ重要なのか?

カットオフ日とは、エクスポートが単一の一貫した一時点を反映するように、元のCRMで編集と新しいレコードを凍結する瞬間です。これがないと、エクスポートしている間も営業担当者がレコードを追加・変更し続け、ファイルは読み込みを終える前に古くなってしまいます。移行では、新しいシステムが検証されるまで、元システムを凍結して読み取り専用に保ちます。繰り返しのレポート用フィードでは逆を行い、最終更新タイムスタンプを使って増分で取得します。