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

Zoho DataPrep では、Zoho Creator コネクタを使用して、Zoho Creator のフォームデータをシームレスに取り込むことができます。Zoho Creator は、ビジネス向けのカスタム Web アプリやモバイルアプリを迅速に構築できる、強力なローコードアプリケーション開発プラットフォームです。このコネクタを使用すると、ETL 処理の実行、データ移動の自動化、Zoho Creator と Zoho DataPrep 間のスムーズなデータ連携を行うことができます。

 Zoho Creator からデータをインポートするには

1.既存のパイプラインを開くか、create a pipelineリンクから新しいパイプラインを作成し、ホームページのパイプラインタブまたはワークスペースタブで、データを追加オプションをクリックします。

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

2. 左側ペインのZoho アプリカテゴリを選択し、Zoho Creatorをクリックします。検索ボックスから直接検索して選択することもできます。

3. 環境を選択ドロップダウンから、必要な環境を選択します。

本番- 実際に稼働している本番版のアプリケーションです。

5. すべてのデータをインポートするか、指定した日付以降のデータのみをインポートするかを選択できます。

a) 「すべてのデータをインポート」を選択した場合 - 選択したフォームで利用可能なすべてのデータがインポートされます。



b) 「特定の日付からデータをインポート」を選択した場合 - 選択したフォームで、指定した日付以降（当日を含む）に追加または更新されたすべてのデータがインポートされます。

情報: 新規および更新データは、Creator からデータをインポートする際に生成される（システム生成列）Added_Time列とModified_Time列を使用して、選択した日付以降のものが取得されます。

メモ: 他のアプリケーションやデータソースとの連携（統合データソース）によって作成されたフォームは、Zoho DataPrep にインポートできません。

7. 選択したフォームは上部に表示されます。インポートをクリックして、選択したフォームを Zoho DataPrep にインポートします。

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



9. データフローの作成と、各ステージへの必要な変換処理の適用が完了したら、ステージを右クリックしてデスティネーションを追加し、データフローを完了します。

メモ: パイプラインにデスティネーションを追加した後、まずは手動実行で ETL パイプラインを実行してみてください。手動実行で問題なく動作することを確認したら、スケジュールを設定して、パイプラインとデータ移動を自動化できます。さまざまな実行タイプについてはこちらをご覧ください。

スケジュール   

 パイプラインは、［スケジュール］オプションを使用して実行を予約できます。スケジュール設定時に、Creatorアプリケーションからインクリメンタルデータをインポートすることもできます。インクリメンタルデータのインポートとは、前回の同期以降に追加または更新されたレコードのみをインポートする方法です。

スケジュールの設定

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

2. 繰り返し方法（毎時、毎日、毎週、毎月）を選択し、実行間隔ドロップダウンで頻度を設定します。 実行間隔ドロップダウンの内容は、選択した繰り返し方法によって変わります。詳細はこちらをクリックして確認してください。

情報: 設定できる範囲は2～100です。初期値は2です。

インポート設定

メモ: パイプライン内のすべてのソースに対して、インポート設定の構成が必須です。インポート設定を行わないと、スケジュールを保存できません。

5. こちらをクリックリンクを選択して、インポート設定を行います。

6. ［ソースからデータをどのようにインポートしますか？］ドロップダウンから、必要なオプションを選択します。このオプションでは、すべてのデータをインポートする、更新および新規データのみをインポートする、新規データのみをインポートする、またはデータをインポートしない、のいずれかを選択できます。

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

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

インクリメンタルデータの取得

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

情報: 更新済みデータと新規データは、前回のインポート時刻以降のModified_Time列とAdded_Time 列を基準に取得されます。 

新規データのみ

前回のインポート時刻以降に追加された新規データのみをインクリメンタルにインポートするには、ドロップダウンから［新規データのみ］オプションを選択します。

情報: 新しいデータは、前回のインポート時刻以降の Added_Time 列を基準に取得されます。

新しいデータがない場合は既存データを使用する: 

増分インポート中に、

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

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

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

7. Saveをクリックして、データセットのインポートをスケジュールします。

重要: 

• すでに Creator でスケジュールを設定している場合、インポート設定セクションでEdit scheduleオプションをクリックして新しいスケジュールを設定すると、以前の設定に基づいてデータが再読み込みされます。

スケジュール設定

データに無効な値がある場合はエクスポートを停止: このオプションを有効にすると、準備済みデータに無効な値が残っている場合にエクスポートを停止します。

エクスポート順序

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

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

メモ: このオプションは、パイプラインに 2 つ以上の出力先を追加している場合にのみ表示されます。

エクスポート先の順序を並べ替えるには

1) Order exportsトグルをクリックします。

2) 出力先をドラッグ＆ドロップして順序を変更し、Saveをクリックします。

メモ: 順序を再度変更する場合は、Edit order リンクをクリックします。

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

各スケジュール実行はジョブとして保存されます。パイプラインがスケジュールされると、データソースからデータが取得され、各ステージで適用した一連の変換によってデータが準備され、その後、データ連携を通じて出力先へ定期的にエクスポートされます。この一連の処理は、ジョブ履歴に記録されます。

9. 特定のパイプラインのジョブ一覧を表示するには、パイプラインビルダーでの三点リーダーアイコンをクリックし、ジョブ履歴メニューを選択して、パイプラインのジョブステータスを確認します。

10. 必要な ジョブIDをジョブ履歴ページでクリックすると、そのジョブのジョブサマリーに移動します。

ジョブサマリーでは、パイプラインフロー内で実行されたジョブの履歴を確認できます。Click こちら詳細をご覧ください。

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

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

メモ: パイプラインにさらに変更を加えた場合、その変更はドラフト版として保存されます。[Draft] オプションを選択してパイプラインを「準備完了」にすると、スケジュールに変更内容が反映されます。

スケジュールを設定した後は、必要に応じて スケジュールを一時停止 またはスケジュールを再開したり、スケジュールを編集および スケジュールを削除することができます。これらはパイプラインビルダーのスケジュール有効オプションから操作できます。

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

Zoho Creator にデータをエクスポートするには

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

2. パイプラインビルダーページで、データフローの作成と各ステージへの必要な変換の適用が完了したら、ステージを右クリックして、出力先を追加オプションを選択します。

 

3. [すべての出力先] タブで Zoho Creator を検索するか、Zoho アプリカテゴリで絞り込み、Zoho Creator をクリックします。

 

 

4. [環境を選択] ドロップダウンから、データをエクスポートしたい環境を選択します。

利用可能な環境は次のとおりです。

Development（ベータ） - アプリケーションを作成すると、デフォルトで Development 環境に追加されます。この環境でアプリケーションに対して必要な編集を行うことができます。このセクションでは、開発環境で実行中のアプリケーションにユーザーがアクセスできるようにします。

ステージ (BETA)- 開発環境で変更を行った後、本番環境に反映する前の中間ステップとして、ステージ環境でアプリケーションをテストできます。

本番- 実際に稼働しているアプリケーションの本番バージョンです。

5. Zoho Creator でデータをエクスポートしたいワークスペース、アプリケーション、およびフォームを選択します。

メモ: 統合データソースを使用して作成されたフォームへのデータのエクスポートはサポートされていません。

6. Zoho Creator へのエクスポートデータをどのように処理するか、次のいずれかのオプションを選択します。

• 新規レコードのみ追加: このオプションでは、Zoho Creator に新しくインポートされたレコードのみを追加できます。
  

• 既存レコードのみ更新: このオプションでは、選択した項目（項目に基づいて照合）に一致する Zoho Creator 内の既存レコードを更新できます。
  

• レコードの追加と更新の両方: このオプションでは、指定した選択項目に一致するレコードを更新し、一致しないレコードは新規レコードとして挿入します。

 

 

7. [Match based on 項目] ドロップダウンから、データを照合するための 一意 かつ 必須の項目を選択します。Zoho Creator フォームで、その項目が必須に設定され、重複値なしとしてマークされていることを確認してください。 詳しくは こちらをご覧ください。

8. 既定では、Creator のワークフローを無効にするオプションが有効になっています。これにより、データを Creator にエクスポートする際にワークフローがトリガーされるのを防ぎます。この設定を無効にすることもできます。

9. インポート元と同じフォームにデータをエクスポートする場合、一致しないレコードを Zoho Creator から削除することを選択できます。

たとえば、Candidatesフォームからレコードをインポートして重複を削除した場合、同じCandidatesフォームにエクスポートし直す際に、Zoho Creator からそれらの重複レコードを削除することを選択できます。

[削除対象レコードを確認] リンクを使用して、削除前にレコードを確認することもできます。

10. エクスポート先の設定を保存します。

パイプラインを実行する前にターゲットマッチングを確認する

Zoho Creator をエクスポート先に設定したステージの DataPrep Studio ページに移動します。

右上のターゲットマッチングアイコンをクリックし、[ターゲットを表示] オプションを選択します。エクスポートエラーを防ぐために、必ずターゲットマッチングを完了してください。 詳しくは こちらでターゲットマッチングについて確認できます。

Now, after checking the target matching, you may want to try executing your pipeline using a manual run at first. Once you make sure the manual run works, you can then set up a schedule to automate the pipeline. Learn about the different types of runs こちら.

Info: 各実行はジョブとして保存されます。パイプライン実行が行われると、データソースから取得したデータに対して、各ステージで適用した一連の変換が実行され、その後データがエクスポート先に出力されます。この一連の処理はすべて ジョブ ページに記録されます。

11. 手動実行がエラーなく成功すると、データは正常にエクスポートされます。手動実行が失敗し、以下のターゲットマッチングエラーが表示された場合は、ターゲットマッチングの手順を完了して修正してください。

ターゲットマッチングは、データモデルの不一致によるエクスポート失敗を防ぐための、DataPrep の便利な機能です。ターゲットマッチングの詳細についてはこちらをご覧ください。 

 

情報 : ジョブサマリーページの出力セクションから、部分的な失敗やその他の問題が発生したエクスポートをロールバックすることもできます。 ロールバックの方法はこちら。

 

Zoho Creator へのエクスポート時のターゲットマッチング

Taターゲットマッチングは、データが出力先にエクスポートされる前に実行されます。ターゲットマッチングは、データモデルの不一致によるエクスポート失敗を防ぐ、DataPrep の便利な機能です。ターゲットマッチングを使用すると、必要な Zoho Creator フォームをターゲットとして設定し、ソースデータセットの列をターゲットの Zoho Creator フォームに合わせて調整できます。これにより、高品質なデータを Zoho Creator にシームレスにエクスポートできます。

メモ: ターゲットマッチングの失敗は、エクスポートの失敗ではありません。ターゲットマッチングは、データが実際に出力先へエクスポートされる前に実行されます。この段階で、エクスポート失敗の原因となり得るスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を防ぎます。 ターゲットマッチングの詳細はこちら。

 ターゲットマッチチェックが失敗した場合

1. Zoho Creator へのエクスポート中にターゲットマッチチェックが失敗した場合は、DataPrep Studio ページで右上のターゲットマッチングアイコン をクリックし、ターゲットを表示オプションを選択します。ターゲットのデータモデルが、既存のソースデータセットの上部に表示されます。ソースデータセット内の列は、該当する場合、自動的にターゲットデータセットの列に合わせて整列されます。

メモ: すべての列はデフォルトでグリッドに表示されますが、すべての列リンクをクリックして、必要なオプションに絞り込むことができます。

3. サマリーを表示リンクをクリックすると、ターゲットマッチエラーの概要を確認できます。サマリーには、さまざまなモデルマッチエラーの種類と、それぞれに関連付けられている列数が表示されます。必要なエラーの種類をクリックし、適用をクリックすると、特定のエラー列だけを絞り込んで表示できます。

ターゲットマッチエラーのサマリー

ターゲットマッチングのエラーの種類

• 未一致の列: ソースデータセット内で、ターゲットの列と一致していない列を絞り込んで表示します。
  
  
  
  情報 : 未一致の列フィルターを使用している場合は、必須列のみ表示を切り替えて、必須列（必須として設定されている列）が不足していないか確認し、必要に応じて追加できます。必須列だけを修正して、そのままエクスポートを続行することも可能です。
  

• データ型の不一致: ソースデータセット内で、ターゲットの列とデータ型が一致していない列を絞り込んで表示します。

• データ形式の不一致: ソースデータセット内で、ターゲットデータセットとデータ形式が異なる列を絞り込んで表示します。

• 制約の不一致: ターゲットの列に設定されているデータ型の制約と一致していない列を絞り込んで表示します。列に制約を追加する方法については、こちらをクリックしてください。

• 必須列の不一致: ターゲット側で必須に設定されているものの、ソース側では必須に設定されていない列を表示します。

  
  
  メモ: 必須列は、一致させて必須として設定しない限り、出力先にエクスポートできません。列の上にある アイコンをクリックして、その列を必須に設定できます。

4. エラーを修正したら、パイプラインビルダーページに移動し、パイプラインを実行してデータをエクスポートします。手動実行で問題なく動作することを確認したら、スケジュールを設定してパイプラインとデータ移動を自動化できます。実行タイプの詳細についてはこちらをご覧ください。

メモ: Creator フォーム内に重複レコードが複数ある場合、一意の項目に基づいて更新されるのは最後の重複データのみで、その他の重複レコードはスキップされます。重複を回避するため、Creator へエクスポートする前に Zoho DataPrep の 重複排除 (deduplicate)変換を使用することをおすすめします。

5. エクスポートが一部失敗した場合は、今すぐロールバック機能を使用して、Zoho Creator フォームに対して行われた変更を取り消すことができます。必要に応じて、正常に完了したエクスポートに対してもロールバックを実行できます。ロールバックの詳細は次のセクションをご覧ください。

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

エクスポートが一部失敗した場合は、ロールバック機能を使用して、Zoho Creator フォームに対して行われた変更を取り消すことができます。ロールバックを行うと、挿入されたレコードの削除、更新されたレコードの変更の取り消し、削除されたレコードの復元を行い、Zoho Creator フォームを元の状態に戻すことができます。

パイプラインの実行後、ジョブ概要ページの［出力］タブからロールバックを実行できます。

今すぐロールバック

エクスポートが一部失敗した場合は、今すぐロールバック機能を使用して、Zoho Creator フォームに対して行われた変更を取り消すことができます。必要に応じて、正常に完了したエクスポートに対してもロールバックを実行できます。

1. ［出力］タブで 今すぐロールバックリンクをクリックして、エクスポートをすぐにロールバックします。ロールバックの詳細を確認し、確認ダイアログで ロールバックをクリックします。

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

重要:

• ロールバックできるのは直近のエクスポートのみです。つまり、今すぐロールバックリンクは、処理済みデータを使用して実行された最新のエクスポートに対してのみ表示されます。

• ロールバック処理は開始後に元に戻すことはできません。ロールバックの実行中は、ほかの操作を行わないでください。

 制限事項

1. 一度にインポートできるレコード数は最大 500 万件です。

4. 一度にエクスポートできるレコード数は最大 100 万件です。

よくある質問

1. Zoho Creator へのエクスポート時にターゲットマッチが失敗した場合はどうすればよいですか？

パイプラインの実行がターゲットマッチエラーで失敗した場合は、次の手順で修正してください。

1. [ジョブの概要]ページ右上の[パイプラインを編集]オプションをクリックします。[パイプラインビルダー]ページが開きます。
   

      

メモ: 画面例として Zoho CRM が表示されていますが、同じ操作がすべてのコネクタに適用されます。

b. 最終ステージ（Zoho Creator を出力先として追加したステージ）を右クリックし、[データを準備]オプションを選択します。[DataPrep Studio]ページが開きます。

      

c. データグリッド右上にあるターゲットマッチングアイコン をクリックします。

d. [ターゲットを表示]オプションを選択します。Zoho Creator タブがターゲットとして表示され、ソース列をそれに合わせて整列できます。エラーと警告は赤と黄色のアイコンで強調表示されます。

      

     

e. [すべての列]ドロップダウンをクリックし、[エラー列]オプションを選択します。次に、赤または黄色のアイコンをクリックして、ステージ列を Zoho Creator タブの項目に一致させます。

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

メモ: Creator のターゲット列名は API 名に基づいています。そのため、ステージ列も同じ名前にしてください。これは、システムが API 仕様に従って Creator の項目と列を正しく検出・マッピングするために必要です。

ターゲットが正常にマッピングされ、エラー列がなくなったら、パイプラインを実行して問題ありません。

関連情報

パイプラインをスケジュールする方法

ターゲットマッチングの詳細

Zoho Creator からデータをインポートする方法

Zoho DataPrep を使用して Creator データでさまざまなユースケースを実現する方法をご覧ください。