お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
Zoho DataPrepを利用すると、Salesforceコネクターを使って営業データをシームレスに連携できます。Salesforceから営業データをインポートし、データクリーンアップ、移行、バックアップなどを多様な方法で実行可能です。このコネクターにより、ETLワークフローの効率化やスムーズなデータ移動、SalesforceとZoho DataPrep間のデータ統合の簡素化が実現します。
免責事項:APIアクセスは、Salesforceの有料プランおよび開発者エディションのみ利用可能です。
Salesforceからデータをインポートする方法
1.既存のパイプラインを開くか、パイプラインを作成します。ホームページ、PipelinesタブまたはWorkspacesタブから、データを追加オプションをクリックします。
ヒント:パイプラインビルダーの上部にあるデータをインポート
アイコンをクリックして、複数のソースからデータをパイプラインに取り込むこともできます。
2. 左側のペインから営業/CRMカテゴリーを選択し、Salesforceをクリックします。オプションを直接検索ボックスで検索することもできます。
メモ: 以前にSalesforce連携を追加済みの場合は、左側のペインから
保存済み外部連携カテゴリーをクリックし、インポートを続行してください。保存済み外部連携の詳細については、
こちらをクリックしてください。
3. 連携を追加済みの場合は、既存の連携をクリックしてデータのインポートを開始してください。
メモ: 新しく追加するリンクをクリックして、新しいSalesforceアカウントを追加できます。複数の連携を追加したい場合は、ブラウザで既存のSalesforceアカウントからログアウトした後、新しい外部連携の追加をお試しください。
4. Salesforceアカウントの認証を行ってください。初めてこの操作を行う場合は、Zoho DataPrepへのファイルアクセスを許可する必要があります。
メモ: 連携設定は今後Salesforceからインポートする際に保存されます。認証情報は安全に暗号化されて保存されます。
5. Salesforceアカウントからデータをインポートするための設定を選択してください。
すべてのデータ - このオプションではアカウント内のすべてのデータをインポートします。
開始日 - このオプションでは、指定した日付から現在の日付までのデータをインポートします。
6. 必要なタブをクリックすると、該当する項目が項目セクションに一覧表示されます。Salesforceアカウントからインポートしたい項目を選択できます。
メモ: Multi選択lookup項目からのデータも、対応するタブでインポート可能です。
7. インポートする をクリックします。
8. データのインポートが完了すると、パイプラインビルダーのページが開きます。ここで、ETLパイプラインに変換処理を適用し始めることができます。ステージを右クリックして、
データを準備 オプションを選択すると、DataPrep Studioページでデータの準備が可能です。変換処理の詳細は
こちらをご覧ください。

9. データフローの作成および必要な変換処理の適用が完了したら、ステージを右クリックして宛先を追加し、データフローを完了できます。

メモ: パイプラインに宛先を追加した後、まずは手動実行でパイプラインの動作を確認することをおすすめします。手動実行で問題がなければ、自動化のためにスケジュールを設定できます。各種実行方法については こちらをご参照ください。
スケジュール
スケジュール オプションを使ってパイプラインのスケジューリングが可能です。スケジューリング時に、Salesforceアカウントからのインクリメンタルデータのインポートも行えます。インクリメンタルデータインポートは、前回同期後に新規または更新されたデータのみを取り込む方法です。
スケジュール設定
1. パイプラインビルダーでScheduleオプションを選択します。
2. 繰り返し方法(毎時間、毎日、weekly、月間)を選択し、Perform 頻度ドロップダウンで頻度を設定します。 Perform 頻度ドロップダウンの設定は繰り返し方法によって変わります。こちらをクリックして詳細をご覧ください。

3. GMTを選択し、データ元で新しく検出されたデータをインポートするタイミングを指定します。初期設定では、ご利用中のローカルタイムゾーンが選択されています。
4.一時停止する schedule が次の後: このオプションでは、選択する ことで、スケジュールを 'n' 回の失敗後に一時停止することができます。
情報: 範囲は2~100の間で指定できます。初期値は2です。
インポートする configuration
Salesforceタブからインクリメンタルデータをインポートし取得する方法をインポートする configurationオプションで設定できます。
メモ: インポートする configuration は、パイプライン内のすべてのソースに対して設定する必要があります。インポートする configuration を設定しないと、スケジュールを保存できません。
5. クリック hereリンクを選択して、インポートする configuration を設定します。
6. How to インポートする data 差出人 データ元?ドロップダウンから、必要なオプションを選択します。このオプションでは、すべてのデータ、更新済みおよび新規データ、または新規データのみをインポートすることが可能です。
すべてのデータをインポートする
すべてのデータをインポートしたい場合は、差出人項目でインポートする日付を選択してください。このオプションを選ぶと、選択した日付以降に利用可能なすべてのデータが、設定した頻度で自動的にインポートされます。
増分データ取得
更新済みおよび新規データのみ
更新済みおよび新規データを増分でインポートするには、最終インポート日時以降のデータを 選択してください。 更新済みおよび新規データのみ オプションをドロップダウンから選択してください。
情報: 更新済みおよび新規データは、Created_TimeおよびUser_modified_Time 列を使用し、最終インポート日時から取得されます。
新規データのみ
新規データのみを最終インポート日時から増分インポートするには、ドロップダウンから新規データのみオプションを選択してください。
情報: 新規データはCreated_Time列を使用し、最終インポート日時から取得されます。
データをインポートしない
データは一度だけインポートされます。2回目以降は、ルールが同じデータに適用され、エクスポートされます。
7. 保存をクリックして、データのインポートをスケジュールします。
メモ: すでにSalesforceからスケジュールを設定している場合、インポート設定セクションの以前の設定に基づき、スケジュール編集オプションをクリックして新しいスケジュールを設定すると、データが再読み込みされます。
Schedule 設定
停止する エクスポートする if data has 無効な値: このオプションを有効にすると、準備されたデータに無効な値が含まれている場合、エクスポートする処理が停止します。

順番 exports
複数の出力先を設定し、データのエクスポート先の順番を指定したい場合は、このオプションを使用できます。
無効の場合、エクスポートする処理は初期設定の順番で実行されます。
メモ: このオプションは、パイプラインに2つ以上の出力先を追加している場合のみ表示されます。
エクスポート先の順番を並べ替えるには
1) 順番 exportsトグルをクリックします
2) drag and drop 機能を使って、destinations の順番を変更し、保存をクリックします。
メモ: 順番を再度並べ替えたい場合は、編集 順番リンクをクリックしてください。
8. スケジュール設定が完了したら、保存 をクリックしてスケジュールを実行します。これによりパイプラインが開始されます。

スケジュールされた実行ごとに、ジョブとして保存されます。パイプラインがスケジュールされると、データソースからデータが取得済みとなり、各ステージで適用された一連の変換処理でデータが準備されます。その後、データはシームレスなデータ連携により、通常の間隔でエクスポート済みの状態で宛先に送信されます。通常の間隔で処理されます。この完了したプロセスはジョブ履歴に記録されます。
9. 特定のパイプラインのジョブ一覧へ移動するには、パイプラインビルダーの
三点リーダーアイコンをクリックし、Job 履歴メニューを選択してパイプラインのジョブステータスを確認します。
10. Jobs 履歴ページで必要な job ID をクリックすると、Job 概要へ移動します。対象ジョブの詳細を確認できます。
Job 概要では、パイプラインフローで実行されたジョブの履歴を表示します。こちらをクリックして詳細を確認できます。
11. スケジュールが完了すると、パイプラインで準備されたデータは設定済みの宛先へエクスポートされます。
情報: できることは、スケジュールのステータスも後でJobsページで表示できます。
メモ: パイプラインにさらに変更を加えると、変更内容は下書きバージョンとして保存されます。 「下書き」オプションを選択し、パイプラインを「準備完了」に設定すると、変更内容がスケジュールに反映されます。

スケジュールを設定した後は、次の操作が可能です: スケジュールの一時停止 または スケジュールの再開、スケジュールの編集や スケジュールの削除が可能です。「Schedule有効」オプションは、パイプラインビルダーで利用できます。
スケジュールを編集して保存すると、次のジョブは前回のスケジュール実行時刻から次のスケジュールデータ間隔までに実行されます。
Salesforceへのデータエクスポート方法
Zoho DataPrepからSalesforceへ営業データをエクスポートできます。Salesforceコネクターを利用することで、ETLワークフローの効率化、スムーズなデータ移動、SalesforceとZoho DataPrep間のデータ統合の簡素化が可能です。
1.
既存のパイプラインを開くか、パイプラインを作成します。「ホーム」ページ、「Pipelines」タブ、または「Workspaces」タブから操作できます。データは50以上のソースから取り込むことが可能です。
2.
Pipeline Builderページで、データフローの作成と必要な
変換の適用が完了したら、ステージを右クリックして
Destinationを追加オプションを選択します。
3. すべてのdestinationsタブでSalesforceを検索し、クリックします。
メモ: 以前にSalesforce連携を追加済みの場合は、保存済み外部連携カテゴリーをクリックし、エクスポートを続けてください。保存済み外部連携の詳細については、こちらをクリックしてください。
4. 連携を追加済みの場合は、既存の連携をクリックしてデータのエクスポートを開始します。
メモ: 新しく追加するリンクをクリックして、新しいSalesforceアカウントを追加します。複数の連携を追加したい場合は、ブラウザで既存のSalesforceアカウントからログアウトし、その後新しい外部連携の追加をお試しください。
5. Salesforceアカウントを認証します。初めて認証を行う場合は、Zoho DataPrepがファイルへアクセスできるよう認可が必要です。
メモ: 連携設定は今後Salesforceへのエクスポート用に保存されます。認証情報は安全に暗号化されて保存されます。
6. データをエクスポートしたいSalesforceのタブを選択します。Salesforceの任意のタブにデータをエクスポートできます。
7. Salesforceへエクスポートするデータの処理方法を、次のいずれかの設定から選択します。
- 新規データのみ追加: このオプションを使用すると、Salesforceへ新たにインポートしたデータのみ追加できます。
このオプション利用時は、エクスポート先のステージにID列が存在しないことを確認してください。
- 既存データのみ更新: このオプションを使用すると、Salesforce内の既存データで選択した項目と一致するものを更新できます。

- 両方 追加する および 更新する データ: このオプションは、選択済み項目に一致するデータを更新し、一致しないデータを新規挿入します。

-
既存データを削除: このオプションは、DataPrepでトランスフォームが適用されたことで削除されたデータを追跡し、Salesforce上でも同期のために該当データを削除します。この操作は元に戻せません。
このオプションを利用する際は、Salesforceへのエクスポート先のステージに
ID列があることを必ずご確認ください。
8. 照合する based オン 項目ドロップダウンから、データの照合に使用する一意かつ必須の項目を選択します。Salesforceアカウントで、当該項目が必須項目に設定されており、重複値が「いいえ」に設定されていることを確認してください。
9. 既存データの更新を選択した場合、既存データの更新時に項目を空にするのをスキップすることもできます。これにより、DataPrepに空の項目があり、Salesforceデータには値がある場合でも、データ更新時のデータ損失を防ぐことができます。
10. 保存して、宛先設定を保存します。
ターゲット照合の確認
Salesforceが宛先に設定されているステージのDataPrep Studio ページへ移動します。

画面右上のターゲット照合アイコン

をクリックし、
ターゲットを表示オプションを選択します。ターゲット照合が完了していることを確認し、エクスポート失敗を防いでください。ターゲット照合の詳細については、こちらをクリックしてください。
ここで、ターゲットマッチングの確認後、まず手動実行でパイプラインをテストすることをおすすめします。手動実行が問題なく完了した場合は、スケジュールを設定してパイプラインの自動化が可能です。さまざまな実行タイプについては
こちらをご覧ください。
情報:各実行はジョブとして保存されます。パイプライン実行時には、データソースから取得済みのデータに、各ステージで申請済みの変換処理が施され、その後、データがエクスポート済みの宛先へ送信されます。この一連の完了プロセスは、
ジョブページに記録されます。
11. 手動実行がエラーなく成功した場合、データは正常にエクスポート済みとなります。手動実行が失敗し、下記のターゲット照合エラーが表示された場合は、ターゲットマッチングの手順を完了することで修正できます。
Target matchingはDataPrepの便利な機能で、データモデルの不一致によるエクスポートする失敗を防ぎます。
Salesforceへのエクスポートする際のターゲットマッチング
ターゲットマッチングは、データが宛先へエクスポートされる前に行われます。DataPrepの便利な機能であり、データモデルの不一致によるエクスポート失敗を防ぎます。ターゲットマッチングを利用すると、必要なSalesforceタブをターゲットとして設定し、データ元の列をターゲットに照合して整合させることができます。これにより、高品質なデータをSalesforceへシームレスにエクスポートできます。
メモ: ターゲットマッチング失敗はエクスポート失敗と同じではありません。ターゲットマッチングはデータが宛先にエクスポートされる前に実行されます。この仕組みにより、スキーマやデータモデルのエラーが事前に検出され、エクスポート失敗を未然に防げます。
ターゲット照合チェックが失敗した場合
1. エクスポート時にターゲット照合チェックが失敗した場合は、
DataPrep Studioページに移動し、右上のターゲットマッチングアイコン

をクリックし、
ターゲットを表示オプションを選択してください。ターゲットのデータモデルが既存のデータ元の上部に表示されます。データ元の列は、見つかった場合は自動的にターゲットの列へ照合されて整列されます。
ターゲットマッチングでは、照合済み列および未照合列に異なるアイコンや提案が表示されます。これらの提案をクリックすることで、既存の列をターゲット列に照合して素早く修正が可能です。エラーの修正を容易にするため、Salesforce内のターゲットタブがデータのターゲットとして紐付けられます。DataPrep Studioページで、テーブルとのマッピングや不一致がある箇所のエラーを確認できます。エラーアイコンにカーソルを合わせて詳細を確認し、クリックして個別にエラーを解決できます。
メモ: すべての列は初期設定でグリッドに表示されます。ただし、すべての列リンクをクリックして必須オプションでフィルター出力することができます。
2. 概要を表示リンクをクリックすると、ターゲット照合エラーの概要が表示されます。概要では、さまざまなモデル照合エラーと、それぞれのエラーに紐付く列数が確認できます。必須エラー列をクリックし、適用をクリックして特定のエラー列だけをフィルター表示できます。
ターゲット照合エラー概要
- ターゲット照合エラーのセクションでは、エラー内容およびそれぞれのエラーに紐付く列数が表示されます。
- 上部のセクションには、エラーカテゴリーごとのエラー数が一覧表示されます。
- クリックすると、各カテゴリーに関連するエラーのみをパネルでフィルター表示できます。
- 初期設定表示ではすべての列が表示されますが、任意のエラーカテゴリーをクリックして詳細を確認したり、エラーのみ表示チェックボックスを選択してエラー列だけを表示したりできます。
- ターゲット照合エラー概要で選択したフィルターは、DataPrep Studioページのグリッドにも適用されます。
ターゲットマッチングエラー
ターゲットマッチングのエラーについて、以下に説明します。
-
未照合列:このオプションでは、データ元およびターゲットで未照合のすべての列が表示されます。
メモ:
- ターゲット側で必須でない列は、利用可能な場合データ元の列と照合するか、無視することができます。
- データ元のデータをSalesforce以外からインポートした場合、データ元に存在する追加の列は初期設定ではエクスポート時に含まれません。ただし、それらの列を名前変更や照合し、含めることも可能です。
- データ元のデータをSalesforceからインポートした場合、ターゲットに存在しないデータ元の列は照合または削除してエクスポート処理を続行する必要があります。ただし、追加列(システム作成列)はエクスポート時に無視されます。
未照合列オプションを使用する際は、必須列のみ表示オプションを切り替えて、ターゲットで必須に設定されている列があるかを確認し、含めることができます。また、必須列のみ修正してエクスポートを続行することも可能です。
- データの種類不一致:このオプションは、データ元の列でターゲットの列とデータ型が一致しないものを表示します。
- データ形式不一致:このオプションは、データ元の列で日付・日時・時間の形式がターゲットと異なるものを表示します。
- 制約不一致:このオプションは、ターゲットの列のデータ型制約と一致しない列を表示します。列に制約を追加する方法については、こちらをクリックしてください。
-
必須列の不一致:このオプションは、ターゲットで必須に設定されているが、データ元では必須になっていない列を表示します。
メモ:必須列は、照合されて必須に設定されない限り、宛先にエクスポートできません。列上部の

アイコンをクリックして必須に設定できます。また、
データ型の変更トランスフォームの
必須にする(null不可)チェックボックスを利用して、列を必須に設定できます。
- データサイズオーバーフロー警告:このオプションは、ターゲットで許可されている最大サイズを超えたデータを持つ列をフィルタリングします。
3. エラーを修正した後、
パイプラインビルダーページに移動し、パイプラインを実行してデータをエクスポートします。手動実行が正常に動作することを確認したら、パイプラインの自動化スケジュールを設定できます。さまざまな実行タイプについては
こちらをご参照ください。
4. 部分的なエクスポート失敗の場合、Salesforceに対して行った変更を元に戻す、またはキャンセルするには今すぐロールバック機能を利用できます。必要に応じて、正常に完了したエクスポートもロールバックすることが可能です。ロールバックの詳細については次のセクションをご覧ください。
エクスポートのロールバック
部分的なエクスポート失敗の場合、ロールバック 機能を使ってSalesforceタブへの変更を元に戻す、またはキャンセルすることができます。ロールバックを実行すると、挿入されたデータの削除、更新されたデータの変更の取り消し、削除されたデータの復元をサポートします。ロールバックエクスポートに関する簡単な動画もご用意しています。
ロールバックの手順
部分的なエクスポート失敗の場合、Salesforceに対して行った変更を元に戻す、またはキャンセルするには今すぐロールバック機能を利用できます。正常に完了したエクスポートも、ご希望であればロールバック可能です。
1. Outputタブの今すぐロールバックリンクをクリックして、エクスポートを即時ロールバックします。
2. ロールバックの詳細を確認し、確認ダイアログでロールバックをクリックします。
3. ロールバックの進行状況が表示されます。ロールバック中は、他の操作を行わないでください。一度ロールバック処理を開始すると、元に戻すことはできません。
重要:
1. ロールバックできるのは最新のエクスポートのみです。つまり、データ同期をロールバック リンクは、処理済みデータを用いて実行された直近のエクスポートにのみ表示されます。
2. ロールバック処理を開始すると元に戻すことはできません。ロールバックが進行中は、他の操作を行わないでください。
制限事項
1. エクスポート時のデータ照合には、照合する based オン 項目内の一意かつ必須のカラムのみ使用できます。
2. 一度にエクスポートできるデータは最大50,000(50K)件です。
3. Zoho DataPrepはSalesforceのワークフロートリガーをサポートしていません。
関連情報