初めてのデータローダー 〜Upsert編〜
公開日: 2021.04.28
この記事で学べること
- データローダーのUpsertを使用し、Salesforce にあるレコードで、すでに存在するものは一括で更新、存在しないものは一括登録という処理をおこなう方法
メリットや利用例
インポートウィザードでは一度の更新件数が5万件までとなっていますが、データローダーでは一度に最大500万件まで更新ができます。
また、商談をはじめとする特定のオブジェクトのレコードは、インポートウィザードでは登録&更新ができませんが、データローダーを利用することで、一括登録&更新ができるようになります。
Upsertの手順
Step 1:ファイルの準備
更新及び新規登録を行うための、CSVファイルを用意します。
CSVファイルを作成するときのポイント
- 「ID」の項目または外部キーによりレコードと紐付けを行っているので「ID」項目または外部キーは必須
- CSVファイルの中に必ずしも全ての項目が入っている必要はない
- 項目名はExportしたときのものをそのまま使う
Step 2:対象のオブジェクトの選択
レコードの更新及び新規登録を行うオブジェクトの選択をします。
表示されていない場合は「Show all Salesforce object」にチェックを入れオブジェクトを全て表示させてみてください。

「Browse」をクリックし、作成したCSVファイルを選択します。

「Next」をクリックすると、CSVファイルに問題がなければそのまま登録されます。
エラーが発生した場合、メッセージが表示されますのでメッセージに従ってください。

作成したCSVデータの数と一致してるか確認し、「OK」をクリックします。

IDまたは、外部キーとして作成している項目により紐付けを行います。
ここでは、どちらをキーとして紐付けを行うかを選択します。

「Next」をクリックします。

Step 3: 項目のマッピング
作成したCSVファイルのヘッダの名称と、Salesforce内の項目のマッピングを行います。
すでにマッピングを作成済みの場合は「Choose an Existing Map」を、新しくマッピングを作成する場合は「Create or Edit a Map」をクリックします(初回は「Create of Edit a Map」を選択してください)

「Auto-Match Fields to Columns」をクリックする。

「File Column Header」(CSVのヘッダー)と「Name」(Salesforceの項目)で、必要な項目が全てマッピングされていることを確認します。
マッピングされていない項目はSalesforceに登録されないので、手作業で紐付けを行う必要があります。
必要な項目が全てマッピングされたら、「OK」をクリックします。

必要な項目のマッピングがされていることが確認できたら、「Next」をクリックします。

Step 4:ログの確認 & 完了
更新を実行した結果(ログ)を格納するディレクトリ(フォルダ)を指定します。
「Browse」をクリックします。

「Finish」をクリックして更新及び新規登録を実行します。

このメッセージがでたら登録完了です。
errorsの方に数字が出ている場合は失敗しているためやり直してください。

考慮事項
データローダーで一括処理を行う際に、まずは1-2件のレコードで、テストを行うことをおすすめします。
キーを少しでも間違えると新規登録されてしまうので、重複レコードを誤って作成してしまわないように注意が必要です。
更新時に文字化けが発生することがありますが、データローダーの設定画面(設定画面の開き方は下記を参考にしてください)にて「Read all CSVs with UTF-8 encoding」にチェックをいれることで回避できますのでチェックしてみてください。
設定画面の開き方
- Windowsの場合:画面上部にあるメニューバーの「設定」から「設定」を選択する。
- Macの場合:データローダーを起動した状態で、画面上部メニューバーの「Settings」から「Settings」を選択する。
学習ツール
まとめ
Upsertは、登録や更新の時と同様にCSVファイルがきちんと作成できれば、簡単に複数のデータを登録&更新することができます。
また、登録や更新と同様に商談の登録&更新も可能となっています。
インポートウィザードとメリットデメリットを比較し、より良い方を使ってみましょう。
CSVファイルを正しく作成できれば、簡単に登録することができます。ぜひチャレンジしてみてください。
公開日: 2021.04.28
この情報は役に立ちましたか?
ご意見お待ちしております。
フィードバックありがとうございます。
より役に立つために
役に立たなかった一番の理由を教えてください。