お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の
英語版を参照してください。
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. データのインポートが完了すると、Pipeline builder ページが開きます。ここから、ETLパイプラインに変換処理を適用し始めることができます。ステージを右クリックし、
Prepare data オプションを選択すると、DataPrep Studio ページでデータの準備も可能です。変換処理の詳細は
こちら をご覧ください。

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

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

3. GMTを選択すると、データ元で見つかった新しいデータをインポートするタイミングを指定できます。初期設定では、お使いのローカルタイムゾーンが選択されています。
4.一時停止する schedule が次の後: このオプションを使用すると、選択する ことで、スケジュールを「n」回の失敗の後に一時停止できます。
情報: 設定可能な範囲は2~100です。初期設定値は2です。
インポートする configuration
Salesforceタブからインクリメンタルデータをインポート・取得する方法を、インポートする configurationオプションで設定できます。
メモ: インポートする configurationは、パイプライン内のすべてのソースに対して設定する必要があります。設定しない場合、スケジュールを保存できません。
5. ここをクリックリンクを選択して、インポートする configurationを設定してください。
6. How to インポートする data 差出人 データ元? ドロップダウンから必須オプションを選択します。このオプションを利用すると、すべてのデータ、更新済みおよび新規データ、または新規データのみをインポートできます。
すべてのデータをインポート
すべてのデータをインポートしたい場合は、差出人項目でデータをインポートする日付を選択してください。このオプションを使用すると、選択した日付以降で利用可能なすべてのデータが、スケジュール実行の頻度に従ってインポートされます。
増分データ取得
更新済みおよび新規データのみ
更新済みおよび新規データを増分でインポートするには 最終インポート日時から、 更新済みおよび新規データのみ オプションをドロップダウンから選択してください。
情報: 更新済みおよび新規データは、Created_Timeおよび User_modified_Time列を使用して最終インポート日時以降のデータが取得されます。
新規データのみ
新規データのみを最終インポート日時以降で段階的にインポートするには、ドロップダウンから新規データのみオプションを選択してください。
既存 data を使用(新規 data が次の値と等しくない場合に利用可能):
インクリメンタル インポートする時、
- チェックボックスをオンにした場合:データ元に新規 data がない場合、最後に取得済みの data が再度インポートされます。
- チェックボックスをオフにした場合:データ元に新規 data がない場合、インポートするは失敗し、ファイルもインポートされません。その結果、パイプラインジョブ全体が失敗します。
情報: 新規 data はCreated_Time列を利用し、最終インポート日時以降のものが取得済みとなります。
データをインポートしない
データは一度のみインポートされます。2回目以降は、同じデータにルールが申請済みとなり、エクスポート済みとなります。
7. 保存をクリックして、データのインポートするをスケジュールします。
メモ: すでにSalesforceのスケジュールを設定済みの場合、インポートする設定セクションで以前の設定に基づいてデータが再読み込みされます。スケジュール編集オプションをクリックし、新規スケジュールを設定した場合に適用されます。
Schedule 設定
無効な値がある場合はエクスポートするを停止する: このオプションを有効にすると、準備されたデータに無効な値が残っている場合、エクスポート処理が停止します。

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

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

スケジュールを設定した後は、以下の操作が可能です: スケジュールの一時停止 またはスケジュールの再開、スケジュールの編集、および スケジュールの削除が、パイプラインビルダー内のスケジュール有効オプションから実行できます。
スケジュールを編集し保存した場合、次回のジョブは最後にスケジュールが実行された時間から次のスケジュールされたデータ間隔に基づいて実行されます。
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. 手動実行がエラーなく成功した場合、データは正常にエクスポート済みとなります。手動実行で以下のターゲット照合エラーが発生した場合は、ターゲットマッチングの手順を完了することで修正できます。
DataPrepのターゲットマッチング機能は、データモデルの不一致によるエクスポートする失敗を防ぐための有用な機能です。
Salesforceへのエクスポートする際のターゲットマッチング
ターゲットマッチングは、データが宛先にエクスポートされる前に行われます。これは、データモデルの不一致によるエクスポート失敗を防ぐためのDataPrepの便利な機能です。ターゲットマッチングを利用することで、必須のSalesforceタブをターゲットとして設定し、データ元のデータ列をターゲットに合わせて照合できます。これにより、高品質なデータをSalesforceへシームレスにエクスポートできます。
メモ: ターゲットマッチングの失敗は、エクスポートの失敗と同じではありません。ターゲットマッチングは、データが宛先にエクスポートされる前に行われます。これにより、エクスポート失敗の原因となるスキーマやデータモデルのエラーが事前に検出され、エクスポート失敗を防ぐことができます。
ターゲット照合チェックが失敗した場合
1. エクスポート時にターゲット照合チェックが失敗した場合、
DataPrep Studioページへ移動し、画面右上のターゲットマッチングアイコン

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

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