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

Zoho DataPrep は、Zoho Creator コネクターを利用して、Zoho Creator からフォームデータをシームレスに取り込むことができます。Zoho Creator は、業務用のカスタムWebおよびモバイルアプリを迅速に作成できる強力なローコードアプリ開発プラットフォームです。このコネクターを使うことで、ETL操作の実行、データ移動の自動化、Zoho Creator と Zoho DataPrep 間でのスムーズなデータ統合が可能です。

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

1.既存のパイプラインを開くか、パイプラインを作成します。「ホーム」ページ、「Pipelines」タブまたは「Workspaces」タブから、データを追加オプションをクリックします。

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

2. 左側のペインでZoho Appsカテゴリを選択し、Zoho Creatorをクリックします。または、検索ボックスにて直接オプションを検索することも可能です。

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

Production- これは有効な本番バージョンのアプリケーションです。

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

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



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

情報: 新規および更新済みデータは、選択した日付を基準に、Added_TimeおよびModified_Time列（データインポート時にCreatorで作成されるシステム作成列）を使用して取得されます。

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

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

8. データのインポートが完了すると、Pipeline builderページが開きます。ここからETLパイプラインへの変換の適用を開始できます。ステージを右クリックし、Prepare dataオプションを選択すると、DataPrep Studioページでデータの準備が可能です。こちらをクリックすると、変換について詳しくご覧いただけます。



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

メモ: パイプラインに宛先を追加した後は、まず手動実行でETLパイプラインを試すことをおすすめします。手動実行が問題なく動作することを確認後、スケジュールを設定して、パイプラインとデータ移動の自動化が可能です。さまざまな実行タイプについてはこちらをご参照ください。

スケジュール   

 できること、Scheduleオプションを使用してパイプラインのスケジュールを設定することが可能です。また、スケジューリング時にCreatorアプリケーションからインクリメンタルデータをインポートすることもできます。インクリメンタルデータのインポートは、前回の同期以降に追加または更新されたデータのみを取り込む方法です。

スケジュール設定

1. パイプラインビルダーでScheduleオプションを選択します。

2. 繰り返し方法（毎時間、毎日、weekly、月間）を選択し、Perform 頻度ドロップダウンで頻度を設定します。「Perform 頻度」ドロップダウンの設定は、選択した繰り返し方法によって異なります。こちらをクリックして詳細をご確認ください。

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

インポートする configuration

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

5. ここをクリックリンクを選択して、インポートする configuration を設定します。

6. 必須のオプションをHow to インポートする data 差出人 データ元?ドロップダウンから選択します。このオプションで、すべてのデータ、更新済みデータおよび新規データのみ、新規データのみ、またはデータをインポートしない、のいずれかを選択できます。

インポートする すべて data

すべてのデータをインポートしたい場合は、データをインポートする必要がある日付をFrom項目で選択してください。このオプションを選択すると、指定した日付以降の利用可能なすべてのデータが、スケジュールされた頻度でインポートされます。

増分データ取得

更新済みおよび 新規データのみ

情報: 更新済みおよび新規データは、Modified_TimeおよびAdded_Time列を使って、最終インポート日時から取得されます。 

新規データのみ

新規データを最終インポート日時以降にインポートするには、ドロップダウンからOnly 新規 dataオプションを選択してください。

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

新規データが利用可能な値と等しくない場合は、既存データを使用します。 

増分インポート時、

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

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

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

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

重要： 

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

Schedule 設定

無効な値がある場合、エクスポートするを停止：このオプションを有効にすると、準備したデータに無効な値が含まれている場合、エクスポートが自動的に停止します。

順番エクスポート

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

このオプションを有効にしない場合、エクスポートは初期設定の順番で実行されます。

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

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

1）順番 exportsトグルをクリックします。

2）ドラッグ＆ドロップで宛先の順番を変更し、「保存」をクリックします。

メモ: 順番を再度並べ替える場合は、編集 順番リンクをクリックしてください。

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

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

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

10. Jobs 履歴ページで、該当する job IDをクリックすると、Job 概要ページに移動できます。

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

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

情報: できることは、Jobsページでスケジュールのステータスも後から表示することです。

メモ: パイプラインにさらに変更を加えた場合、変更内容は下書きバージョンとして保存されます。下書きオプションを選択し、パイプラインを変更反映用に設定してください。

スケジュールを設定した後は、 次の操作が可能です： スケジュールの一時停止 または スケジュールの再開、スケジュールの編集および スケジュールの削除を、スケジュール有効オプション（パイプラインビルダー内）から行えます。

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

Zoho Creatorへデータをエクスポートする方法

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

2. Pipeline Builderページで、データフローの作成と必要な変換処理を各ステージに適用した後、ステージを右クリックしてDestinationの追加オプションを選択できます。

 

3. すべてのdestinationsタブでZoho Creatorを検索するか、Zoho Appsカテゴリでフィルターし、クリックします。

 

 

4. エクスポートしたいデータの必須environmentを、選択する environmentドロップダウンから選択します。

利用可能なenvironmentsは以下の通りです：

Development（BETA） - 初期設定では、アプリケーションを作成するとDevelopment environmentに追加されます。このenvironmentでアプリケーションの編集が可能です。このセクションにより、ユーザーは開発環境で稼働中のアプリケーションへアクセスできます。

Stage（BETA） - Development environmentで変更を加えた後、Stage environmentでアプリケーションのテストが可能です。これは、開発と本番の間、最終的な変更を配布する前の中間手順です。

Production - これは有効な本番バージョンのアプリケーションです。

5. Zoho CreatorでデータをエクスポートしたいWorkspace、ApplicationおよびFormsを選択します。

メモ: 統合データ データ元 を使用して作成されたフォームへのデータエクスポートは、次の値と等しくない場合はサポートされていません。

6. 下記の設定のいずれかを選択し、Zoho Creator へエクスポートされるデータの処理方法を決定します。

• 新規データのみ追加: このオプションを選択すると、Zoho Creator から新たにインポートされたデータのみ追加できます。
  

• 既存データのみ更新: このオプションを使用すると、選択した項目に基づいて照合されたZoho Creator内の既存データのみを更新できます。
  

• 追加および更新の両方: このオプションでは、指定された選択項目と一致するデータは更新され、一致しないデータは新たに追加されます。

 

 

7. データ差出人を照合するために、ユニークかつ必須の項目を 選択してください。照合するベースの項目ドロップダウンから選択します。項目が必須として設定され、重複なしとしてマークされていることを、Zoho Creatorフォームでご確認ください。こちらをクリックして詳細をご覧ください。

8. 初期設定では、Creatorワークフローを無効にするオプションが有効になっています。これにより、データがCreatorへエクスポートされた際にワークフローが実行されるのを防ぎます。また、無効にする設定を選択することも可能です。

9. データをインポート元と同じフォームへエクスポートする場合、エクスポート対象のデータと一致しないZoho Creator内のデータを削除することができます。

例えば、Candidatesフォームからデータをインポートし、重複を削除した場合、同じCandidatesフォームへ戻す際に、Zoho Creator内の重複データを削除することができます。

削除前にデータを確認するリンクから確認することも可能です。

10. 保存 先の設定を保存します。

ターゲットの一致を確認

Zoho Creator を宛先として設定したステージのDataPrep Studioページへ移動します。

画面右上のターゲットマッチングアイコンをクリックし、「表示ターゲット」オプションを選択します。ターゲットマッチングが完了していることを確認してください。未完了の場合、エクスポート時に失敗することがあります。こちらをクリックするとターゲットマッチングの詳細をご確認いただけます。

次に、ターゲットマッチングの確認後、まずは手動実行でパイプラインをテストすることをおすすめします。手動実行で問題がないことを確認できたら、スケジュールを設定して自動化することができます。各実行方法の詳細はこちらをご覧ください。

情報: 各実行はジョブとして保存されます。パイプラインを実行すると、データソースから取得済みのデータが各ステージで申請済みの変換処理を経て整形され、目的地へエクスポート済みとなります。この完了した処理はジョブページに記録されます。

11. 手動実行がエラーなく完了した場合、データは正常にエクスポート済みとなります。手動実行で下記のターゲット照合するエラーが発生した場合は、ターゲットマッチング手順を完了して修正してください。

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

 

情報 : エクスポートするの一部失敗やその他の問題が発生した場合、ジョブ概要ページの出力セクションからエクスポートするをロールバックするオプションも利用できます。ロールバック方法はこちら。

 

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

Target matchingは、データがエクスポート済みになる前に実行されます。ターゲットマッチングは、DataPrepの便利な機能で、データモデルの不一致によるエクスポートする失敗を防ぎます。ターゲットマッチングを利用すると、必須のZoho Creatorフォームをターゲットとして設定し、データ元のデータセット列をターゲットのZoho Creatorフォームに照合することができます。これにより、高い品質のデータをZoho Creatorへシームレスにエクスポートすることが可能です。

メモ: Target matching failure はエクスポート失敗とは異なります。Target matching は、実際にデータが宛先へエクスポートされる前に行われます。これにより、エクスポート失敗の原因となる可能性のあるスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を未然に防ぎます。target matching の詳細はこちら。

 target 照合チェックが失敗した場合

1. Zoho Creator でのエクスポート時に target 照合チェックが失敗した場合は、DataPrep Studio ページに移動し、右上の target matching アイコンをクリックし、target を表示オプションを選択します。target のデータモデルが既存のデータ元データセットの上部に表示されます。データ元データセット内の列は、自動的に target データセットの列に一致するように調整されます（該当する場合）。

メモ: すべての列は初期設定でグリッドに表示されます。ただし、すべての列リンクをクリックすることで、必須オプションのみをフィルターして表示できます。

3. 表示する 概要リンクをクリックして、対象の照合するエラーの概要を表示します。概要には、さまざまなモデルの照合するエラーと、各エラーに関連付けられたカラムの番号が表示されます。必須エラーカラムをクリックし、適用するをクリックして、特定のエラーカラムに絞り込むことができます。

Target 照合する エラー概要

Target matching errors

• 不一致カラム : このオプションは、ターゲットのカラムと一致しないカラムをデータ元データセットからフィルターします。
  
  
  
  情報 : 不一致カラムフィルターを利用する際は、必須カラムのみ表示を切り替えて、必須カラム（必須として設定されているカラム）が存在するか確認し、それらを含めることができます。また、必須カラムのみを確定してエクスポートを続行することも可能です。
  

• データの種類不一致 : このオプションは、ターゲットのカラムと一致しないデータの種類を持つカラムをデータ元データセットからフィルターします。

• データ形式不一致 : このオプションは、ターゲットデータセットのカラムと異なるデータ形式を持つカラムをデータ元データセットからフィルターします。

• 制約不一致 : このオプションは、ターゲットのカラムのデータの種類制約と一致しないカラムをフィルターします。カラムに制約を追加する方法については、こちらをクリックしてください。

• 必須列の不一致：このオプションを選択すると、ターゲットで必須となっているが、データ元では必須に設定されていない列が表示されます。

  
  
  メモ: 必須列は、照合済みかつ必須に設定されていなければ、宛先にエクスポート済みにはできません。列を必須に設定するには、上記のアイコンをクリックしてください。

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

メモ: Creatorフォーム内に複数の複製するデータが存在する場合、一意の項目に基づき、最後の複製するデータのみが更新され、それ以外はスキップ済みとなります。 deduplicate変換をZoho DataPrepでエクスポート前に実施することで、重複を回避することを推奨します。

5. 部分的なエクスポートする失敗が発生した場合、Rollback now機能を使用して、Zoho Creatorフォームへの変更を元に戻す、またはキャンセルすることができます。必要に応じて、成功したエクスポートするについてもロールバックが可能です。ロールバックの詳細は次のセクションをご参照ください。

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

部分的なエクスポートする失敗が発生した場合、Rollback機能を利用して、Zoho Creatorフォームへの変更を元に戻す、またはキャンセルすることが可能です。ロールバックは、挿入されたデータの削除、更新データの変更の取り消し、削除されたデータの復元をサポートします。

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

今すぐロールバック

部分的なエクスポートする失敗が発生した場合、Rollback now機能を使用して、Zoho Creatorフォームへの変更を元に戻す、またはキャンセルすることができます。必要に応じて、成功したエクスポートするについてもロールバック可能です。

1. Outputタブ内のRollback nowリンクをクリックして、エクスポートするを今すぐロールバックします。ロールバックの詳細を確認し、確認ダイアログでRollbackをクリックしてください。

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

重要:

• ロールバックできるのは、最新のエクスポートのみです。つまり、Rollback nowリンクは、処理済みデータを使用して出力された最新のエクスポートにのみ表示されます。

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

 制限事項

1. 一度にインポートできるデータは最大500万件です。

4. 一度に最大100万件のデータをエクスポートできます。

関連情報

パイプラインのスケジュール方法

Target Matchingについてさらに詳しく

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

Zoho DataPrepがCreatorデータでさまざまなユースケースを実現する方法を見る.