Zoho DataPrep用Zoho Biginコネクター
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Zoho DataPrep では、Bigin by Zoho CRM コネクタを使用して、営業データをシームレスに取り込むことができます。Bigin から営業データをインポートし、データクレンジング、データ移行、データバックアップを複数の方法で実行できます。このコネクタを使用すると、ETL ワークフローを効率化し、スムーズなデータ移動を実現し、Bigin by Zoho CRM と Zoho DataPrep 間のデータ連携を簡素化できます。
Bigin by Zoho CRM からデータをインポートするには
1.既存のパイプラインを開くか、create a pipelineし、Homeページ、Pipelinesタブ、またはWorkspacesタブから、Add dataオプションをクリックします。
情報: パイプラインビルダー上部のImport data
2. 左側ペインでSales/CRMカテゴリを選択し、Bigin by Zoho CRMをクリックします。Zoho Appsカテゴリ内から Bigin を選択することもできます。
3. Organizationドロップダウンから組織を選択します。
4. 組織からデータをインポートする方法をいずれか選択します。
All Data - 組織内のすべてのデータをインポートします。
From date - 指定した日付から現在までのデータをインポートします。
新規および更新済みデータは、選択した日付を基準に、Created_Time列とModified_Time列を使用して取得されます。
6. Select タブボックスで、Bigin by Zoho CRM の次のタブからインポートするデータを選択できます。
- Contacts
- Accounts
- Tasks
- Events
- 通話
- Products
メモ: いずれのタブでも、Multi select lookup 項目からデータをインポートできます。
7. インポートをクリックして、選択したタブを Zoho DataPrep にインポートします。
8. データのインポートが完了すると、パイプラインビルダーのページが開き、そこから ETL パイプラインに変換処理を適用できます。ステージを右クリックし、Prepare dataオプションを選択して、DataPrep Studio ページでデータを準備することもできます。変換について詳しくはこちらをクリックしてください。
9. データフローの作成と、各ステージへの必要な変換の適用が完了したら、ステージを右クリックして出力先を追加し、データフローを完了できます。
9. データフローの作成と、各ステージへの必要な変換の適用が完了したら、ステージを右クリックして出力先を追加し、データフローを完了できます。
スケジュール
パイプラインはScheduleオプションを使ってスケジュールできます。スケジュール設定時に、Bigin by Zoho CRM アカウントから増分データをインポートすることも可能です。増分データインポートとは、前回の同期以降に新規作成または更新されたレコードのみをインポートする方法です。
スケジュール設定
1. パイプラインビルダーで Scheduleオプションを選択します。
2. Repeat（毎時、毎日、毎週、毎月）の方法を選択し、Perform every ドロップダウンで頻度を設定します。Perform everyドロップダウンの内容は、選択した Repeat 方法によって変わります。詳しくはこちらをクリックしてください。
3. 新しいデータをソースからインポートする GMT を選択します。デフォルトでは、ローカルのタイムゾーンが選択されています。
4.Pause schedule after: このオプションでは、指定した回数の失敗後にスケジュールを一時停止するよう設定できます。
Info: 設定できる範囲は 2～100 です。初期値は 2 です。
インポート設定
インポート設定オプションを使用して、Bigin のタブから増分データをどのようにインポートおよび取得するかを設定できます。
メモ: パイプライン内のすべてのソースに対して、インポート設定の構成が必須です。インポート設定を行わないと、スケジュールを保存できません。
5. インポート設定を行うには、Click こちらリンクを選択します。
6. How to インポート data from source?ドロップダウンから、必要なオプションを選択します。このオプションでは、すべてのデータ、変更済みおよび新規データ、または新規データのみをインポートできます。
すべてのデータをインポート
すべてのデータをインポートする場合は、From項目でデータのインポート開始日を選択します。このオプションでは、スケジュール実行のたびに、選択した日付以降のすべての利用可能なデータがインポートされます。
増分データ取得
変更済みおよび新規データのみ
前回のインポート時刻以降の変更済みおよび新規データのみを増分でインポートするには、 ドロップダウンから Only modified and new data オプションを選択します。
情報: 変更済みおよび新規データは、前回のインポート時刻以降のCreated_Time列とUser_modified_Time 列を使用して取得されます。
新規データのみ
前回のインポート時刻以降の新規データのみを増分でインポートするには、ドロップダウンからOnly new dataオプションを選択します。
新規データがない場合に既存データを使用する:
増分インポート中、
- チェックボックスがオンの場合: 参照元に新規データがないときは、最後に取得したデータが再度インポートされます。
- チェックボックスがオフの場合: 参照元に新規データがないときは、インポートは失敗し、ファイルはインポートされません。その結果、パイプラインジョブ全体が失敗します。
情報: 新規データは、前回のインポート時刻以降のCreated_Time列を使用して取得されます。
データをインポートしない
データは 1 回だけインポートされます。2 回目以降は、同じデータにルールが適用され、その結果がエクスポートされます。
7. Saveをクリックして、データのインポートをスケジュールします。
メモ: すでに Bigin でスケジュールを設定している場合、インポート configurationセクションでEdit scheduleオプションをクリックして新しいスケジュールを設定すると、以前の設定に基づいてデータが再読み込みされます。
スケジュール設定
データに無効な値がある場合はエクスポートを停止: このオプションを有効にすると、準備済みデータに無効な値が残っている場合にエクスポートを停止します。
エクスポートの順序
複数の出力先を設定している場合に、どの順序でデータを出力先へエクスポートするかを指定できます。
無効にしている場合、エクスポートはデフォルトの順序で実行されます。
無効にしている場合、エクスポートはデフォルトの順序で実行されます。
メモ: このオプションは、パイプラインに 2 つ以上の出力先を追加している場合にのみ表示されます。
エクスポート先の順序を変更するには
1) Order exportsトグルをクリックします。
2) 出力先の順序を変更するには、ドラッグ＆ドロップしてからSaveをクリックします。
メモ: 並び順を再度変更する場合は、Edit order リンクをクリックします。
8. スケジュール設定を構成したら、Save をクリックしてスケジュールを実行します。これによりパイプラインが開始されます。
各スケジュール実行はジョブとして保存されます。ETL パイプラインをスケジュールすると、各ステージで適用した一連の変換でデータが整形され、シームレスなデータ連携により、データソースから取得されたデータが宛先にエクスポートされます。この処理は定期的な間隔で行われます。この一連の処理はすべてジョブ履歴に記録されます。
9. 特定のパイプラインのジョブ一覧に移動するには、パイプラインビルダーで
10. 必要な ジョブ ID をJobs historyページでクリックすると、そのジョブのJob summaryページに移動します。
Job summary には、パイプラインフローで実行されたジョブの履歴が表示されます。Click こちら詳細はこちらをご覧ください。
11. スケジュールが完了すると、パイプラインで整形されたデータが、設定した宛先にエクスポートされます。
情報: スケジュールのステータスは、後から Jobs ページでも確認できます。
メモ: パイプラインにさらに変更を加えた場合、その変更はドラフト版として保存されます。スケジュールに変更内容を反映するには、Draftオプションを選択し、パイプラインを「準備完了」としてマークしてください。
スケジュールを設定した後は、パイプラインビルダーの Pause schedule またはResume schedule、Edit schedule、 Remove scheduleを選択できます。これらはSchedule有効オプションから操作できます。
スケジュールを編集して保存すると、次のジョブは前回のスケジュール実行時刻から次のスケジュールされたデータ間隔までのデータを対象に実行されます。
Zoho CRM の Bigin へデータをエクスポートするには
Zoho DataPrep から Zoho CRM の Bigin へは、Bigin by Zoho CRM コネクタを使用して売上データをエクスポートできます。このコネクタを使用すると、ETL ワークフローを効率化し、スムーズなデータ移動を実現し、Zoho CRM の Bigin と Zoho DataPrep 間のデータ連携を簡素化できます。
1. 既存のパイプラインを開くか、create a pipelineをホームページ、Pipelinesタブ、またはWorkspacesタブから作成します。データは50 以上のソースから取り込むことができます。
2. Pipeline Builderページで、データフローの作成と各ステージで必要な変換の適用が完了したら、ステージを右クリックして宛先を追加オプションを選択します。
3. すべての宛先タブで「Bigin by Zoho CRM」を検索し、クリックします。
4. データをエクスポートする Bigin by Zoho CRM の組織とタブを選択します。Bigin by Zoho CRM では、次のいずれかのタブにデータをエクスポートできます。
- Contacts
- Accounts
- Products
7. Bigin by Zoho CRM へのエクスポートデータの処理方法として、次のいずれかを選択します。
- 新規レコードのみ追加：このオプションでは、Bigin by Zoho CRM から新たに取り込まれたレコードのみを追加できます。
- 既存レコードのみ更新：このオプションでは、選択した項目（項目に基づいて照合）に一致する Bigin by Zoho CRM の既存レコードを更新できます。
- レコードの追加と更新の両方：このオプションでは、指定した項目に一致するレコードを更新し、一致しないレコードは新規レコードとして追加します。
-
既存レコードを削除：この操作では、DataPrep で削除対象としてマークされたレコードを追跡し、Bigin by Zoho CRM 上の対応するレコードを削除して、プラットフォームの内容を最新に保ちます。この操作は元に戻せません。
Bigin を宛先として設定したステージにID列が含まれていることを確認してください。Bigin のレコードは、IDが一致した場合に削除されます。
8. 項目に基づいて照合ドロップダウンから、一意かつ必須の項目を選択してデータを照合します。選択した項目が必須項目であり、Bigin by Zoho CRM アカウント側で重複不可に設定されていることを確認してください。
9. 既存レコードの更新を選択した場合、既存レコードを更新する際に項目を空にしないこともできます。これにより、DataPrep 側の項目が空で、Bigin 側のデータに値がある場合でも、更新時にその値が失われることを防げます。
10. 宛先の設定を保存します。
ターゲットマッチングの確認
Bigin を宛先に設定したステージのDataPrep Studio ページに移動します。
画面右上のターゲットマッチングアイコン
をクリックし、ターゲットを表示オプションを選択します。エクスポートの失敗を防ぐため、ターゲットマッチングが完了していることを確認してください。 ターゲットマッチングの詳細については こちら を参照してください。
ターゲットマッチングを確認したら、まずは手動実行でパイプラインを実行してみることをお勧めします。手動実行が問題なく完了することを確認したら、スケジュールを設定してパイプラインを自動化できます。さまざまな実行タイプについてはこちらをご覧ください。
情報: 各実行はジョブとして保存されます。パイプライン実行が行われると、データソースから取得されたデータに対して、各ステージで設定した一連の変換が適用され、その後、宛先にデータがエクスポートされます。この一連の処理はすべてジョブページに記録されます。
11. 手動実行がエラーなく成功した場合、データは正常にエクスポートされています。手動実行が失敗し、以下のターゲットマッチエラーが表示された場合は、ターゲットマッチングの手順を完了して修正してください。
ターゲットマッチングは、データモデルの不整合によるエラーが原因で発生するエクスポートの失敗を防ぐ、DataPrep の便利な機能です。
Bigin by Zoho CRM へのエクスポート時のターゲットマッチング
ターゲットマッチングは、データが宛先にエクスポートされる前に実行されます。ターゲットマッチングは、データモデルの不整合によるエラーが原因で発生するエクスポートの失敗を防ぐ、DataPrep の便利な機能です。ターゲットマッチングを使用すると、必要な Bigin by Zoho CRM のタブをターゲットとして設定し、ソースデータの列をターゲットに合わせて揃えることができます。これにより、高品質なデータを Bigin by Zoho CRM にシームレスにエクスポートできます。
メモ: ターゲットマッチングの失敗は、エクスポートの失敗ではありません。ターゲットマッチングは、データが宛先にエクスポートされる前に実行されます。このため、エクスポートの失敗につながる可能性のあるスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を防ぐことができます。
ターゲットマッチチェックが失敗した場合
1. エクスポート中にターゲットマッチチェックが失敗した場合は、DataPrep Studio ページに移動し、画面右上のターゲットマッチングアイコン
をクリックし、ターゲットを表示オプションを選択します。ターゲットのデータモデルが既存のソースデータの上部に表示されます。ソースの列は、対応する列が見つかった場合、自動的にターゲットの列に合わせて配置されます。
ターゲットマッチングでは、一致している列と一致していない列に対して、さまざまなアイコンや提案が表示されます。これらの提案をクリックすることで、既存の列をターゲット列に合わせるための変更をすばやく行えます。エラーを簡単に修正できるように、Bigin by Zoho CRM のターゲットタブがデータのターゲットとして関連付けられています。DataPrep Studioページでは、テーブルとのマッピングと、不一致がある箇所のエラーをあわせて確認できます。エラーアイコンにカーソルを合わせて内容を確認し、クリックして各エラーを解消できます。
メモ: 既定では、すべての列がグリッドに表示されます。ただし、すべての列リンクをクリックして、必要なオプションに絞り込むことができます。
2. サマリーを表示リンクをクリックすると、ターゲットマッチエラーの概要を確認できます。サマリーには、さまざまなモデルマッチエラーと、それぞれのエラーに関連付けられている列数が表示されます。必要なエラー列をクリックし、適用をクリックすると、特定のエラー列だけを絞り込んで表示できます。
ターゲットマッチエラーのサマリー
- ［ターゲットマッチエラー］セクションには、エラーの種類と、それぞれのエラーに関連付けられている列数が表示されます。
- 上部のセクションには、エラーカテゴリと各カテゴリのエラー数が一覧表示されます。
- 各カテゴリをクリックすると、そのカテゴリに関連するエラーだけをパネル内に絞り込んで表示できます。
- 既定ビューでは、すべての列が表示されますが、任意のエラーカテゴリをクリックして列を詳しく確認したり、エラーのみ表示チェックボックスを選択してエラー列だけを表示したりできます。
- ターゲットマッチエラーのサマリーで行ったフィルターの選択内容は、DataPrep Studioページのグリッドにも適用されます。
ターゲットマッチングエラー
ターゲットのマッチングで発生するエラーは次のとおりです:
-
未マッチの列: このオプションでは、ソースとターゲットのすべての未マッチ列が表示されます。
メモ:
- ターゲット側で必須ではない列は、対応するソース列があればマッチさせることも、無視することもできます。
- ソースデータを Bigin 以外からインポートした場合、ソースに存在する追加列は、デフォルトではエクスポートに含まれません。ただし、エクスポートに含めたい場合は、それらの列名を変更してマッチさせることができます。
- ソースデータを Bigin からインポートした場合、ターゲットに存在しないソース側の列は、エクスポートを続行する前にマッチさせるか削除する必要があります。ただし、システムによって自動生成された追加列は、エクスポート時に無視されます。
未マッチ列オプションを使用する場合、必須列のみを表示オプションを切り替えて、ターゲット側で必須に設定されている列があるかどうかを確認し、含めることができます。必須列のみを修正して、そのままエクスポートを続行することも可能です。
- データ型の不一致: このオプションでは、ソース側の列のうち、ターゲット側の列とデータ型が一致しないものが表示されます。
- データ形式の不一致: このオプションでは、ターゲットと異なる日付、日時、時刻形式を持つソース側の列が表示されます。
- 制約の不一致: このオプションでは、ターゲット側の列に設定されているデータ型の制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください。
-
必須列の不一致: このオプションでは、ターゲット側で必須に設定されているにもかかわらず、ソース側では必須に設定されていない列が表示されます。メモ: 必須列は、マッチさせて必須に設定しない限り、宛先へエクスポートできません。列の上部に表示される
アイコンをクリックして、その列を必須に設定できます。また、データ型の変更変換の必須（NULL 不可）に設定チェックボックスを使用して、列を必須に設定することもできます。
- データサイズ超過の警告: このオプションでは、ターゲットで許可されている最大サイズを超えるデータを含む列が絞り込まれて表示されます。
3. エラーを修正したら、パイプラインビルダーページに移動してパイプラインを実行し、データをエクスポートできます。手動実行が問題なく動作することを確認したら、スケジュールを設定してパイプラインを自動化できます。さまざまな実行タイプについてはこちらをご覧ください。
4. 部分的なエクスポート失敗が発生した場合は、今すぐロールバック機能を使用して、Zoho CRM によって Bigin に加えられた変更を元に戻す（取り消す）ことができます。必要に応じて、成功したエクスポートであってもロールバックできます。ロールバックの詳細は次のセクションをご覧ください。
エクスポートのロールバック
部分的なエクスポート失敗が発生した場合、ロールバック 機能を使用して、Zoho CRM の Bigin タブに対して行われた変更を元に戻す（取り消す）ことができます。ロールバックでは、挿入されたレコードの削除、更新されたレコードの変更の取り消し、削除されたレコードの復元を Bigin タブで行うことができます。
ロールバックするには
部分的なエクスポート失敗が発生した場合は、今すぐロールバック機能を使用して、Bigin に対して行われた変更を元に戻す（取り消す）ことができます。必要に応じて、成功したエクスポートであってもロールバックできます。
1. 出力タブで今すぐロールバックリンクをクリックして、エクスポートをすぐにロールバックします。
2. ロールバックの詳細を確認し、確認ダイアログでロールバックをクリックします。
3. ロールバックの進行状況が表示されます。ロールバックの実行中は、他の操作を行わないでください。ロールバック処理は開始後に元に戻すことはできません。
重要:
1. ロールバックできるのは直近のエクスポートのみです。つまり、データ同期をロールバック リンクは、処理済みデータを使用して実行された最新のエクスポートに対してのみ表示されます。
2. ロールバック処理は開始後に元に戻すことはできません。ロールバックの実行中は、他の操作を行わないでください。
制限事項
1. エクスポート時にデータをマッチさせる際、項目に基づいてマッチでは一意かつ必須の列のみを使用できます。
2. 一度にエクスポートできるレコード数は最大 600,000（600K）件です。
3. Zoho DataPrep は、Zoho CRM の Bigin におけるワークフロートリガーをサポートしていません。
FAQ
1. Bigin by Zoho CRM へのエクスポート時にターゲットマッチが失敗した場合、どうすればよいですか？
パイプラインの実行がターゲットマッチエラーで失敗した場合は、次の手順で修正してください。
- ジョブサマリーページで、右上のパイプラインを編集オプションをクリックします。パイプラインビルダーページが開きます。
メモ: 画面例では Zoho CRM が表示されていますが、同じ手順がすべてのコネクタに適用されます。
b. 最終ステージ（宛先として Bigin by Zoho CRM を追加したステージ）を右クリックし、データを準備オプションを選択します。DataPrep Studioページが開きます。
c. データグリッドのすぐ上、右上にあるターゲットマッチングアイコン 
をクリックします。
d. ターゲットを表示オプションを選択します。これにより、ターゲットとして Bigin by Zoho CRM のタブが表示され、ソース列をそれに合わせてマッチさせることができます。エラーと警告は赤と黄色のアイコンで強調表示されます。
e. すべての列ドロップダウンをクリックし、エラー列オプションを選択します。その後、赤または黄色のアイコンをクリックして、ステージ列を Bigin by Zoho CRM タブの項目にマッチさせます。
これにより、ステージ列に必要なデータ型と制約が追加され、Bigin by Zoho CRM のターゲット列と一致するようになります。
メモ: Bigin by Zoho CRM のターゲット列は API 名に基づいて命名されています。そのため、ステージ列も同じ名前に設定してください。これは、システムが API 標準に従って列を正しく検出し、Bigin の項目にマッピングするために必要です。
ターゲットがエラー列なしで正常にマッピングされれば、パイプラインを実行して問題なく続行できます。
関連情報