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

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

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

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

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

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

スケジュールを設定した後は、次の操作を行えます。 スケジュールを一時停止 またはスケジュールを再開し、スケジュールを編集したり、 スケジュールを削除できます。これらはパイプラインビルダーのスケジュール有効オプションから操作できます。
スケジュールを編集して保存すると、次回のジョブは前回のスケジュール実行時刻から次のスケジュールされたデータ間隔に基づいて実行されます。
Salesforce にデータをエクスポートするには
Zoho DataPrep から Salesforce に Salesforce コネクターを使用して営業データをエクスポートできます。このコネクターにより、ETL ワークフローを効率化し、スムーズなデータ移動を実現し、Salesforce と Zoho DataPrep 間のデータ連携を簡素化できます。
2.
Pipeline Builderページで、データフローの作成と各ステージへの必要な
変換の適用が完了したら、ステージを右クリックして
宛先を追加オプションを選択します。
3. 「All destinations」タブで Salesforce を検索し、クリックします。
メモ: 以前に Salesforce 連携を追加している場合は、Saved connectionsカテゴリをクリックして、そのままエクスポートを続行できます。Saved connections の詳細については、こちらをクリックしてください。
4. すでに接続を追加している場合は、既存の接続をクリックして、データのエクスポートを開始します。
メモ: 新しい Salesforce アカウントを追加するには、+ Newリンクをクリックします。複数の接続を追加する場合は、ブラウザーで現在ログインしている Salesforce アカウントから一度ログアウトしてから、新しい接続の追加をお試しください。
5. Salesforce アカウントを認証します。初めて実行する際は、Zoho DataPrep がファイルへアクセスできるよう認証する必要があります。
メモ: 接続の設定は、今後 Salesforce へのエクスポートに利用できるよう保存されます。認証情報は安全に暗号化され、保存されます。
6. データをエクスポートしたい Salesforce のタブを選択します。Salesforce のこれらのタブのいずれかにデータをエクスポートできます。
7. Salesforce へエクスポートされるデータの扱い方を決定するため、次のいずれかの設定を選択します。
- 新規データのみ追加: このオプションでは、新たにインポートしたデータのみを Salesforce に追加できます。
このオプションを使用する場合、Salesforce にエクスポートするステージに ID列がないことを確認してください。
- 既存データのみ更新: このオプションでは、選択した項目(項目に基づいて照合)に一致する Salesforce の既存データを更新できます。

- 新規データの追加と既存データの更新: このオプションでは、指定した項目に一致するデータを更新し、一致しないデータは新規として挿入します。

-
既存データの削除: この操作では、DataPrep で削除対象としてマークされたデータを追跡し、Salesforce 上の対応するデータを削除して、プラットフォームの内容を最新に保ちます。この操作は元に戻せません。
Salesforce を宛先として設定したステージに ID 列が含まれていることを確認してください。Salesforce 上のデータは、ID が一致した場合に削除されます。
8. 「Match based on field」ドロップダウンから、一意かつ必須の項目を選択してデータを照合します。選択した項目が必須に設定され、Salesforce アカウント側で重複値なしとしてマークされていることを確認してください。
9. 既存データの更新を選択した場合、既存データを更新する際に項目を空にしないこともできます。これにより、DataPrep 側の項目が空で、Salesforce 側には値が存在する場合でも、更新時にデータが失われることを防げます。
10. 宛先の設定を保存します。
ターゲットマッチングの確認
Salesforce を宛先に設定したステージの DataPrep Studio ページに移動します。

画面右上のターゲットマッチングアイコン

をクリックし、
Show targetオプションを選択します。エクスポート失敗を防ぐため、ターゲットマッチングが完了していることを確認してください。ターゲットマッチングの詳細については、ここをクリックして確認してください。
ターゲットマッチングを確認したら、まずは手動実行でパイプラインを実行してみることをおすすめします。手動実行が問題なく動作することを確認したら、スケジュールを設定してパイプラインを自動化できます。実行タイプの詳細については
こちらを参照してください。
Info: 各実行はジョブとして保存されます。パイプライン実行が行われると、データソースから取得したデータに対して、各ステージで適用した一連の変換が実行され、その後データが宛先へエクスポートされます。この一連の処理は、
ジョブページに記録されます。
11. 手動実行がエラーなく成功した場合、データは正常にエクスポートされています。手動実行が失敗し、以下のターゲットマッチングエラーが表示された場合は、ターゲットマッチングの手順を完了して修正できます。
ターゲットマッチングは、データモデルの不整合によるエクスポート失敗を防ぐための、DataPrep の便利な機能です。
Salesforce へのエクスポート時のターゲットマッチング
ターゲットマッチングは、データが宛先にエクスポートされる前に実行されます。ターゲットマッチングは、データモデルの不整合によるエクスポート失敗を防ぐための、DataPrep の便利な機能です。ターゲットマッチングを使用すると、目的の Salesforce タブをターゲットとして設定し、ソースデータの列をターゲットに合わせて揃えることができます。これにより、高品質なデータを Salesforce へシームレスにエクスポートできます。
メモ: ターゲットマッチングの失敗は、エクスポートの失敗と同じではありません。ターゲットマッチングは、データが宛先にエクスポートされる前に実行されます。この仕組みにより、エクスポート失敗の原因となり得るスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を防ぎます。
ターゲットマッチングチェックが失敗した場合
1. エクスポート中にターゲットマッチングチェックが失敗した場合は、
DataPrep Studio ページに移動し、画面右上のターゲットマッチングアイコン

をクリックし、
Show targetオプションを選択します。ターゲットのデータモデルが既存のソースデータの上部に表示されます。ソース内の列は、一致するものが見つかった場合、自動的にターゲットの列に合わせて配置されます。
ターゲットマッチングでは、一致した列と一致していない列に対して、さまざまなアイコンや提案が表示されます。これらの提案をクリックすることで、既存の列をターゲット列に合わせてすばやく修正できます。エラーを簡単に修正できるよう、Salesforce のターゲットタブがデータのターゲットとして関連付けられています。DataPrep Studioページで、テーブルとのマッピングと、不一致がある箇所のエラーをあわせて確認できます。エラーアイコンにカーソルを合わせると問題の内容を確認でき、クリックすると各エラーを解決できます。
メモ: 既定では、すべての列がグリッドに表示されます。ただし、All columnsリンクをクリックして、必須列のみをフィルター表示することもできます。
2. Show summaryリンクをクリックすると、ターゲットマッチングエラーの概要を表示できます。概要には、さまざまなモデルマッチングエラーと、それぞれのエラーに関連付けられている列数が表示されます。必要なエラー列をクリックし、Applyをクリックして、特定のエラー列のみをフィルター表示できます。
ターゲットマッチングエラーの概要
- 「Target match errors」セクションには、エラーの種類と、それぞれのエラーに関連付けられている列数が表示されます。
- 上部のセクションには、エラーカテゴリと、それぞれのカテゴリに含まれるエラー数が一覧表示されます。
- 各カテゴリをクリックすると、そのカテゴリに関連するエラーのみをパネル内にフィルター表示できます。
- 既定の表示では、すべての列が表示されますが、任意のエラーカテゴリをクリックし、列を詳しく確認したり、Show only errorsチェックボックスを選択してエラー列のみを表示したりできます。
- Target match error summaryで行ったフィルターの選択内容は、DataPrep Studioページのグリッドにも適用されます。
ターゲットマッチングエラー
ターゲット照合で発生するエラーは次のとおりです:
-
未照合の列: このオプションでは、データソースとターゲットのすべての未照合列が表示されます。
メモ:
- ターゲット側で必須ではない列は、利用可能であればデータソースの列と照合するか、無視することができます。
- Salesforce 以外のデータソースからデータをインポートした場合、データソース側に存在する追加列は、デフォルトではエクスポートに含まれません。ただし、必要に応じてそれらの列の名前を変更して照合し、含めることができます。
- Salesforce からデータソースデータをインポートした場合、ターゲットに存在しないデータソース側の列は、エクスポートを続行する前に照合するか削除する必要があります。ただし、追加列(システム作成列)はエクスポート時に無視されます。
未照合の列オプションを使用する際は、必須列のみを表示オプションを切り替えて、ターゲット側で必須に設定されている列があるか確認し、それらを含めることができます。必須列のみを修正して、そのままエクスポートを続行することも可能です。
- データ型の不一致: このオプションでは、データソース側の列のうち、ターゲットの列とデータ型が一致しないものが表示されます。
- データ形式の不一致: このオプションでは、データソース側の列のうち、ターゲットと異なる日付、日時、時間形式を持つ列が表示されます。
- 制約の不一致: このオプションでは、ターゲットの列に設定されたデータ型の制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください。
-
必須列の不一致: このオプションでは、ターゲット側で必須に設定されているものの、データソース側では必須に設定されていない列が表示されます。
メモ: 必須列は、照合されて必須に設定されていない限り、宛先にエクスポートできません。列を必須に設定するには、その列の上にある

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