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

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

 Zoho Creatorからのデータのインポート

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

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

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

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

本番- これはアプリケーションの公開中の本番バージョンです。

5. すべてのデータをインポートするか、過去の日付以降のデータをインポートするように設定できます。

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



b）特定の日付以降のデータをインポートする場合 - 選択した日付以降（当日を含む）に、選択したフォームに記録されたすべてのデータ（追加および変更されたデータ）がインポートされます。

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

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

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

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



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

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

スケジュール   

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

スケジュールの設定

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

2. ［繰り返し方法］（時間単位、日単位、週単位、月単位）を選択し、［実行間隔］ドロップダウンで頻度を設定します。［実行間隔］ドロップダウンの選択肢は、繰り返し方法に応じて変わります。詳細については、こちらをクリックしてください。

情報：範囲は2～100です。初期値は2です。

インポートの設定

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

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

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

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

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

増分データの取得

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

情報：変更データおよび新規データは、Modified_Time列とAdded_Time列を使用して、前回のインポート時刻以降のデータとして取得されます。 

新規データのみ

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

情報：新しいデータは、Added_Time列を使用して、前回インポートした時刻以降のデータとして取得されます。

［新しいデータがない場合は既存のデータを使用］： 

差分インポート中は、

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

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

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

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

重要：

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

スケジュール設定

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

エクスポート順の設定

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

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

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

エクスポート先の順序の並べ替え

1）［エクスポート順の設定］の切り替えボタンをクリックします

2）ドラッグ＆ドロップしてエクスポート先の順序を変更し、［保存］をクリックします。

メモ：順序を再度並べ替える場合は、［順序の編集］リンクをクリックします。

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

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

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

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

［ジョブの概要］には、パイプラインフローで実行されたジョブの履歴が表示されます。こちらをクリックすると、詳細を確認できます。

スケジュールを設定した後、次の操作を選択できます：［スケジュールの一時停止］または［スケジュールの再開］、［スケジュールの編集］、［スケジュールの削除］。これらはパイプラインビルダーの［スケジュール有効］オプションを使用して実行できます。

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

Zoho Creatorへのデータのエクスポート

1. 既存のパイプラインを開くか、パイプラインを作成します。これらは、［ホーム］ページ、［パイプライン］タブ、または［ワークスペース］タブから行えます。データは50種類以上のソースから取り込めます。

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

 

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

 

 

4. データをエクスポートする環境を、［環境の選択］ドロップダウンから選択します。

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

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

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

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へのエクスポート時のターゲット照合

メモ：ターゲット照合の失敗は、エクスポートの失敗ではありません。ターゲット照合は、データが実際にエクスポート先へエクスポートされる前に行われます。これにより、エクスポート失敗の原因となるスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を防止できます。ターゲット照合の詳細。

 ターゲット照合チェック失敗時の対応

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

メモ：初期設定では、すべての列がグリッドに表示されます。ただし、［すべての列］リンクをクリックすると、必要なオプションで絞り込めます。

3. ターゲット照合エラーの概要を表示するには、［概要を表示］リンクをクリックします。概要には、各モデル照合エラーと、それぞれのエラーに関連する列数が表示されます。必要なエラー列をクリックし、［適用］をクリックすると、特定のエラー列で絞り込めます。

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

ターゲット照合エラー

• ［未一致の列］：このオプションでは、ターゲット内の列と一致しないソースデータセット内の列を絞り込みます。
  
  
  
  情報：［未一致の列］フィルターを使用する場合、［必須列のみ表示］を切り替えて、必要な必須列（必須列として設定されている列）があるかどうかを確認し、それらを含めることができます。必須列のみを修正して、エクスポートに進むこともできます。
  

• ［データ型の不一致］：このオプションでは、ターゲット内の列とデータ型が一致しないソースデータセット内の列を絞り込みます。

• ［データ形式の不一致］：このオプションでは、ターゲットデータセット内の列とデータ形式が異なるソースデータセット内の列を絞り込みます。

• ［制約の不一致］：このオプションでは、ターゲット内の列のデータ型制約と一致しない列を絞り込みます。列に制約を追加する方法については、こちらをクリックしてください。

• ［必須列の不一致］：このオプションでは、ターゲットでは必須に設定されているものの、ソースでは必須に設定されていない列が表示されます。

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

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

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

5. エクスポートが部分的に失敗した場合、今すぐロールバック機能を使用して、Zoho Creatorフォームに加えられた変更を元に戻すかキャンセルできます。必要に応じて、成功したエクスポートもロールバックできます。ロールバックの詳細については、次のセクションを参照してください。

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

エクスポートが部分的に失敗した場合、ロールバック機能を使用して、Zoho Creatorフォームに加えられた変更を元に戻すかキャンセルできます。ロールバックにより、挿入されたデータを削除し、更新されたデータの変更を取り消し、削除されたデータをZoho Creatorフォームに復元できます。

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

今すぐロールバックの実行

エクスポートが部分的に失敗した場合、今すぐロールバック機能を使用して、Zoho Creatorフォームに加えられた変更を元に戻すかキャンセルできます。必要に応じて、成功したエクスポートもロールバックできます。

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

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

重要。

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

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

 制限事項

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

小数

はい

はい

パーセント

はい

はい

通貨

はい

はい

自動番号

はい

はい

日付

はい

はい

日時

はい

はい

ドロップダウン

いいえ

はい

ラジオボタン

いいえ

はい

複数選択

いいえ

はい

チェックボックス

いいえ

はい

決定ボックス

いいえ

はい

URL

いいえ

はい

画像

いいえ

はい

ファイルのアップロード

いいえ

はい

数式

いいえ

いいえ

署名

いいえ

はい

ユーザー

はい

はい

電話

いいえ

はい

セクション

いいえ

はい

名前

いいえ

はい

住所

いいえ

はい

時刻

はい

はい

ルックアップ

いいえ

はい

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の項目に正しくマッピングするために必要です。

対象が正常にマッピングされ、エラー列がなくなったら、パイプラインの実行に進むことができます。

2. 対象の照合中に表示される各アイコンの意味

対象の照合中に表示されるアイコンは、列のマッピングと検証の状態を示します。

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

• 黄色のアイコン（ソース列と対象列が一致済み）→ この列には、対象のサイズ制限を超える値を格納できます。制約を更新するにはクリックしてください。

• 黄色のアイコン（対象に存在するがソースにはない列）→ これは対象の必須列ではありません。この列を利用可能なソース列と照合するか、この警告を無視できます。

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

• 緑色のアイコン→ 対象の照合が完了しています。

関連情報

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

対象の照合の詳細

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

Creatorのデータを使ったさまざまなユースケースの実現に、Zoho DataPrepがどのように役立つかを確認できます。