Zoho DataPrep向けZoho Biginコネクタ

Zoho DataPrep向けZoho Biginコネクタ

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。


Zoho DataPrepでは、Bigin by Zoho CRMコネクターを使用して、売上データをスムーズに取り込むことができます。Biginから売上データをインポートし、データクレンジング、データ移行、データバックアップをさまざまな方法で実行できます。このコネクターを使用すると、ETLワークフローを効率化し、データ移動を円滑にし、Bigin by Zoho CRMとZoho DataPrep間のデータ連携を簡素化できます。

Bigin by Zoho CRMからのデータのインポート

1.既存のパイプラインを開くか、イプラインを作成します。[ホーム]ページ、[パイプライン]タブ、または[ワークスペース]タブから実行できます。次に、[データの追加]オプションをクリックします。

Info情報:複数のソースからパイプラインにデータを取り込むには、パイプラインビルダー上部の[データのインポート]アイコンをクリックすることもできます。


2. 左側のペインから[営業/CRM]カテゴリを選択し、[Bigin by Zoho CRM]をクリックします。Biginは[Zohoアプリ]カテゴリからも確認できます。



3. [組織]ドロップダウンから組織を選択します。

4. 組織からデータをインポートする方法として、いずれかのオプションを選択します。

[すべてのデータ]- このオプションでは、組織内のすべてのデータをインポートします。
[指定日以降]- このオプションでは、特定の日付から現在の日付までのデータをインポートします。


      



Info選択した日付以降の新規データと更新データは、Created_Time列とModified_Time列を使用して取得されます。

6. [タブの選択]ボックスで、Bigin by Zoho CRMの次のタブからデータをインポートできます。
  1. 連絡先
  2. 取引先
  3. タスク
  4. 予定
  5. 通話
  6. 商品

Notes
メモ:どのタブでも、複数選択ルックアップ項目からデータをインポートできます。

7. 選択したタブをZoho DataPrepにインポートするには、[インポート]をクリックします。

8. データのインポートが完了すると、パイプラインビルダーページが開きます。このページから、ETLパイプラインへの変換の適用を開始できます。ステージを右クリックし、[データの準備]オプションを選択して、DataPrep Studioページでデータを準備することもできます。変換の詳細については、こちらをご参照ください。



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


 

Notes
メモ:ETLパイプラインに出力先を追加した後、まず手動実行でパイプラインを実行してみることができます。手動実行が正常に動作することを確認したら、スケジュールを設定して、パイプラインとデータ移動を自動化できます。各種実行については、こちらをご参照ください。

スケジュール

[スケジュール]オプションを使用して、パイプラインをスケジュール設定できます。スケジュール設定時に、Bigin by Zoho CRMアカウントから差分データをインポートすることもできます。差分データのインポートは、前回の同期後に追加または変更されたデータをインポートする方法です。

スケジュールの設定

1. パイプラインビルダーで[スケジュール]オプションを選択します。

2. [繰り返し]方法(毎時、毎日、毎週、毎月)を選択し、[実行間隔]ドロップダウンを使用して頻度を設定します。[実行間隔]ドロップダウンの選択肢は、繰り返し方法によって変わります。詳細については、こちらをご参照ください。




3. ソースで検出された新しいデータをインポートするタイムゾーン(GMT)を選択します。初期設定では、ローカルタイムゾーンが選択されます。


4. [スケジュールの一時停止条件]このオプションでは、失敗回数がn回に達した後にスケジュールを一時停止するように設定できます。
Info情報:範囲は2〜100です。初期値は2です。

インポート設定

Biginのタブから差分データをインポートして取得する方法は、[インポート設定]オプションで設定できます。
Notes
メモ:パイプライン内のすべてのソースで、インポート設定を必ず設定する必要があります。インポート設定を設定しないと、スケジュールを保存できません。

5. インポート設定を行うには、[こちらをクリック]のリンクを選択します。

6. [ソースからデータをインポートする方法]のドロップダウンから必要なオプションを選択します。このオプションでは、すべてのデータ、変更済みデータと新規データ、または新規データのみをインポートできます。

すべてのデータのインポート

すべてのデータをインポートする場合は、[開始日]の項目で、データのインポートを開始する日付を選択します。このオプションでは、スケジュール実行のたびに、選択した日付以降の利用可能なすべてのデータがインポートされます。



増分データの取得

変更済みデータと新規データのみ

前回のインポート日時以降の変更済みデータと新規データを増分インポートするには、ドロップダウンから[変更済みデータと新規データのみ]のオプションを選択します。



Info情報:変更済みデータと新規データは、前回のインポート日時以降のCreated_TimeUser_modified_Time列を使用して取得されます。

新規データのみ

前回のインポート日時以降の新規データを増分インポートするには、ドロップダウンから[新規データのみ]のオプションを選択します。




[新規データがない場合は既存のデータを使用]


増分インポート時は、

  1. チェックボックスが選択されている場合:ソースに新規データがないときは、前回取得したデータが再度インポートされます。
  2. チェックボックスが選択されていない場合:ソースに新規データがない場合、インポートは失敗し、ファイルはインポートされません。その結果、パイプラインジョブ全体が失敗します。

Info
情報:新規データは、前回のインポート日時以降のCreated_Time列を使用して取得されます。

データをインポートしない設定

データは1回だけインポートされます。2回目以降は、同じデータにルールが適用され、エクスポートされます。



7. データのインポートスケジュールを設定するには、[保存]をクリックします。

メモ:Biginからすでにスケジュールを設定している場合は、インポート設定のセクションで以前の設定に基づいてデータが再読み込みされます。これは、[スケジュールを編集]オプションをクリックして新しいスケジュールを設定した場合に適用されます。

スケジュール設定

[データに無効な値がある場合にエクスポートを停止]:有効にすると、準備済みデータに無効な値が残っている場合にエクスポートが停止します。



[エクスポート順序]

複数のエクスポート先を設定しており、データを各エクスポート先にエクスポートする順序を指定したい場合に、このオプションを使用できます。

有効にしない場合、エクスポートは標準の順序で実行されます。

メモ:このオプションは、パイプラインに複数のエクスポート先を追加している場合にのみ表示されます。

エクスポート先の順序変更

1)[エクスポート順序]の切り替えボタンをクリックします


2)エクスポート先をドラッグ&ドロップして順序を変更し、[保存]をクリックします。



メモ:順序をもう一度並べ替える場合は、[順序の編集]リンクをクリックします。

8. スケジュール設定を構成したら、[保存]をクリックしてスケジュールを実行します。これにより、パイプラインが開始されます。



スケジュールされた各実行はジョブとして保存されます。ETLパイプラインがスケジュールされると、データソースからデータが取得され、各ステージで適用した一連の変換を使用して準備され、シームレスなデータ連携によって、一定の間隔でデータがエクスポート先にエクスポートされます。この一連の処理はジョブ履歴に記録されます。


9. 特定のパイプラインのジョブ一覧に移動するには、パイプラインビルダーで省略記号アイコンをクリックし、[ジョブ履歴]メニューをクリックして、パイプラインのジョブステータスを確認します。

10. 対象のジョブIDをジョブ履歴ページでクリックし、特定のジョブのジョブ概要に移動します。

ジョブ概要には、パイプラインフローで実行されたジョブの履歴が表示されます。こちらをクリックして詳細をご確認ください。

11. スケジュールが完了すると、パイプラインで準備されたデータが設定済みのエクスポート先にエクスポートされます。

情報:スケジュールのステータスは、後からジョブページでも確認できます。

メモ:パイプラインにさらに変更を加えると、変更は下書き版として保存されます。変更をスケジュールに反映するには、[下書き]オプションを選択し、パイプラインを準備完了としてマークしてください。




スケジュールを設定した後、必要に応じて[スケジュールの一時停止]または[スケジュールの再開][スケジュールの編集][スケジュールの削除]を、パイプラインビルダーの[スケジュール有効]オプションから実行できます。

スケジュールを編集して保存すると、次のジョブは前回のスケジュール実行時刻から次にスケジュール設定されたデータ間隔までを対象に実行されます。


Bigin by Zoho CRMへのデータのエクスポート

Zoho DataPrepの営業データを、Bigin by Zoho CRMコネクターを使用してBigin by Zoho CRMにエクスポートできます。このコネクターにより、ETLワークフローを効率化し、スムーズなデータ移動を可能にし、Bigin by Zoho CRMとZoho DataPrep間のデータ連携を簡素化できます。

1. 既存のパイプラインを開くか、イプラインを作成します。作成は、[ホーム]ページ、[パイプライン]タブ、または[ワークスペース]タブから行えます。50件以上のソースからデータを取り込むことができます。

2. Pipeline Builderページで、データフローの作成と各ステージで必要な変換の適用が完了したら、ステージを右クリックし、[エクスポート先の追加]オプションを選択します。


3. [すべてのエクスポート先]タブでBigin by Zoho CRM を検索し、クリックします。


4. データのエクスポート先となるBigin by Zoho CRMの組織とタブを選択します。Bigin by Zoho CRMの次のいずれかのタブにデータをエクスポートできます。

  1. [連絡先]
  2. [取引先]
  3. [商品]



7. Bigin by Zoho CRMにエクスポートするデータの処理方法を決定するには、次のいずれかのオプションを選択します。
  1. [新しいデータのみ追加]:このオプションでは、新しくインポートされたデータのみをBigin by Zoho CRMに追加できます。
  1. [既存のデータのみ更新]:このオプションでは、選択した項目に一致する(項目に基づいて照合)Bigin by Zoho CRM内の既存のデータを更新できます。

  1. [データの追加と更新]:このオプションでは、選択した項目に一致するデータを更新し、選択した項目の値に一致しないデータを追加します。



  2. [既存のデータの削除]:この操作では、DataPrepで削除対象としてマークされたデータを追跡し、Bigin by Zoho CRM内の該当するデータを削除して、プラットフォームを最新の状態に保ちます。この操作は元に戻せません。

    Biginをエクスポート先として設定したステージにID列が含まれていることを確認してください。IDが一致すると、Bigin内のデータが削除されます。




8. [項目に基づいて照合]ドロップダウンから、データの照合に使用する一意かつ必須の項目を選択します。Bigin by Zoho CRMアカウントで、この項目が必須に設定され、重複値なしとして指定されていることを確認してください。

9. 既存のデータを更新する場合、[既存のデータを更新するときに項目を空にしない]こともできます。これにより、DataPrepの項目が空で、Biginのデータにすでに値がある場合でも、データ更新時のデータ損失を防ぐことができます。

10. [保存]をクリックして、エクスポート先の設定を保存します。

ターゲット照合の確認

Biginがエクスポート先として設定されているステージのDataPrep Studio ページに移動します。



右上のターゲット照合アイコンをクリックし、[ターゲットを表示]オプションを選択します。エクスポートの失敗を防ぐため、ターゲット照合が完了していることを確認してください。 ターゲット照合の詳細については、こちらをクリックしてください。



ターゲット照合を確認したら、まず手動実行でパイプラインの実行を試すことをお勧めします。手動実行が正常に動作することを確認した後、スケジュールを設定してパイプラインを自動化できます。実行の種類の詳細についてはこちらをご参照ください。
Info
情報:各実行はジョブとして保存されます。パイプラインの実行が行われると、データソースから取得したデータは、各ステージに適用した一連の変換を使用して準備され、その後エクスポート先にエクスポートされます。この一連の処理は、[ジョブ]ページに記録されます。

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. ターゲット照合エラーの概要を表示するには、[概要を表示]リンクをクリックします。概要には、モデル照合エラーの種類と、各エラーに関連付けられている列数が表示されます。必要なエラー列をクリックし、[適用]をクリックすると、特定のエラー列で絞り込むことができます。



ターゲット照合エラーの概要

  1. [ターゲット照合エラー]セクションには、エラーと各エラーに関連付けられている列数が表示されます。
  2. 上部のセクションには、エラーのカテゴリーと各カテゴリー内のエラー数が一覧表示されます。
  3. 各カテゴリーをクリックすると、パネル内でそのカテゴリーに関連するエラーを絞り込めます。
  4. 初期表示では、すべての列が表示されます。ただし、任意のエラーカテゴリーをクリックすると列の詳細を確認できます。また、[エラーのみ表示]チェックボックスを選択すると、エラー列のみを表示できます。
  5. ターゲット照合エラーの概要で選択したフィルターは、DataPrep Studioページのグリッドにも適用されます。

ターゲット照合エラー

ターゲット照合で発生するエラーは次のとおりです。
  1. 一致しない列:このオプションでは、ソースとターゲットで一致していないすべての列が表示されます。
    メモ:
    1. ターゲットの必須ではない列は、対応するソース列がある場合は照合することも、無視することもできます。
    2. Bigin以外のソースからソースデータをインポートした場合、ソースにある追加の列は、初期設定ではエクスポートに含まれません。ただし、これらの列を含める場合は、列名を変更して照合できます。
    3. Biginからソースデータをインポートした場合、ターゲットにないソースの列は、エクスポートを続行するために照合または削除する必要があります。ただし、追加の列(システム生成)はエクスポート時に無視されます。
    一致しない列オプションを使用する場合、[必須列のみを表示]オプションを切り替えることで、必須列(ターゲットで必須に設定されている列)があるかどうかを確認し、含めることができます。必須列のみを修正して、エクスポートに進むこともできます。


  1. データ型の不一致:このオプションでは、ターゲットの列とデータ型が一致しないソースの列が表示されます。
  2. データ形式の不一致:このオプションでは、ターゲットと日付、日時、時刻の形式が異なるソースの列が表示されます。
  3. 制約の不一致:このオプションでは、ターゲットの列のデータ型制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください。
  4. 必須列の不一致:このオプションでは、ターゲットでは必須に設定されているものの、ソースでは必須に設定されていない列が表示されます。
    メモ:必須列は、照合して必須に設定しない限り、エクスポート先にエクスポートできません。列の上にあるアイコンをクリックすると、必須に設定できます。また、データ型の変更変換の下にある[必須(not null)として設定]チェックボックスを使用して、列を必須に設定することもできます。
  5. データサイズ超過の警告:このオプションでは、ターゲットで許可されている最大サイズを超えるデータが含まれる列を抽出します。

3. エラーを修正した後、パイプラインビルダーページに移動し、パイプラインを実行してデータをエクスポートできます。手動実行が正常に機能することを確認したら、スケジュールを設定してパイプラインを自動化できます。実行の種類については、こちらをご参照ください。

4. 部分的なエクスポート失敗が発生した場合は、今すぐロールバック機能を使用して、Zoho CRMによってBiginに加えられた変更を元に戻すか、取り消すことができます。必要に応じて、成功したエクスポートもロールバックできます。ロールバックの詳細については、次のセクションを参照してください。

エクスポートのロールバック

部分的なエクスポート失敗が発生した場合、ロールバック 機能を使用して、Zoho CRMによってBigin タブに加えられた変更を元に戻すか、取り消すことができます。ロールバックにより、挿入されたデータの削除、更新されたデータの変更の取り消し、Bigin タブで削除されたデータの復元を行えます。

ロールバックの実行

部分的なエクスポート失敗が発生した場合は、今すぐロールバック機能を使用して、Biginに加えられた変更を元に戻すか、取り消すことができます。必要に応じて、成功したエクスポートもロールバックできます。

 

 

1. エクスポートをすぐにロールバックするには、[出力]タブの[今すぐロールバック]リンクをクリックします。




2. ロールバックの詳細を確認し、確認ダイアログで[ロールバック]をクリックします。



3. ロールバックの進行状況が表示されます。ロールバックの実行中は、他の操作を行わないでください。ロールバック処理は、開始後に元に戻すことはできません。



重要:
1. ロールバックできるのは最新のエクスポートのみです。つまり、[データ同期のロールバック] リンクは、処理済みデータを使用して実行された直近のエクスポートに対してのみ表示されます。
2. ロールバック処理は、開始後に元に戻すことはできません。ロールバックの実行中は、他の操作を行わないでください。

制限事項

1. エクスポート中にデータを照合するには、[項目に基づいて照合]で一意かつ必須の列のみを使用できます。

2. 一度に最大600,000件(600K)のデータをエクスポートできます。

3. Zoho DataPrepは、Bigin by Zoho CRMのワークフロートリガーに対応していません。

よくある質問

1. Bigin by Zoho CRMへのエクスポート中にターゲット照合が失敗した場合の対応

ターゲット照合エラーが原因でパイプラインの実行に失敗した場合は、次の手順で修正してください。
  1. ジョブの概要ページで、右上にある[パイプラインを編集]オプションをクリックします。パイプラインビルダーページに移動します。
      

Notes
メモ:スクリーンショットでは説明のためにZoho CRMが表示されています。同じ内容はすべてのコネクターに適用されます。

b. 最終ステージ(エクスポート先としてBigin by Zoho CRMを追加したステージ)を右クリックし、[データの準備]オプションを選択します。DataPrep Studioページが開きます。

      

c. データグリッドのすぐ上、右上にあるターゲット照合アイコンをクリックします。

d. [ターゲットを表示]オプションを選択します。これにより、Bigin by Zoho CRM タブがターゲットとして表示され、ソース列をそれに合わせて調整できます。エラーと警告は、赤色と黄色のアイコンで強調表示されます。
      
     
e. [すべての列]ドロップダウンをクリックし、[エラー列]オプションを選択します。次に、赤色または黄色のアイコンをクリックして、ステージ列をBigin by Zoho CRM タブの項目と照合します。

これにより、必要なデータ型と制約がステージ列に追加され、Bigin by Zoho CRMのターゲット列と一致するようになります。

Info
メモ:Bigin by Zoho CRMのターゲット列には、API名に基づく名前が付けられています。そのため、ステージ列にも同じ名前を付けてください。これは、API標準に従って、列を正しく検出し、Biginの項目に関連付けるために必要です。

エラー列がなくなり、ターゲットが正常に関連付けられたら、パイプラインの実行に進むことができます。

2. ターゲット照合中に表示される各アイコンの意味

ターゲット照合中に表示されるアイコンは、列の関連付けと検証のステータスを示します。

  • 灰色のアイコン→ ソースにある追加の列は、エクスポートに含まれません。

  • 黄色のアイコン(ソース列とターゲット列が一致)→ ターゲットのサイズ上限を超える値を列に格納できます。クリックすると制約を更新できます。

  • 黄色のアイコン(ターゲットにはあるがソースにはない列)→ これはターゲットの必須列ではありません。対応するソース列がある場合は、この列と照合することも、この警告を無視することもできます。

  • 赤色のアイコン→ これはターゲットの必須列ですが、照合できる列がソースに残っていません。データ内に一致する列が必要です。

  • 緑色のアイコン→ ターゲットが一致しています。


関連情報
パイプラインをスケジュールする方法
Zoho DataPrepで利用可能なコネクター