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

Zoho DataPrepでは、Zoho Creator コネクターを使用して、Zoho Creatorのフォームデータをシームレスに取り込むことができます。Zoho Creatorは、ビジネス向けにカスタムWebおよびモバイルアプリを迅速に作成できる強力な低い-コードアプリケーション開発プラットフォームです。このコネクターを利用することで、ETL処理の実行、データ移動の自動化、Zoho CreatorとZoho DataPrep間のデータ統合を円滑に行えます。

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

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

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

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

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

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

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

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



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

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

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

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

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



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

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

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

2. Pipeline Builderページで、データフローの作成および各ステージへの必要な変換の適用が完了したら、任意のステージを右クリックし、Destinationの追加オプションを選択します。

 

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

 

 

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

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

Development（BETA） - 初期設定では、アプリケーションを作成するとDevelopment environmentに追加されます。このenvironmentでアプリケーションの編集を行うことができます。このセクションでは、ユーザーがdevelopment environmentで実行中のアプリケーションにアクセスできます。

Stage（BETA） - Development environmentで変更を加えた後、Stage environmentでアプリケーションのテストを行うことができます。これはdevelopmentとproductionの間の中間的な手順であり、変更内容の最終確認が可能です。

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

5. エクスポート先となるZoho CreatorのWorkspace、ApplicationおよびFormsを選択してください。

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

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

• 新規データのみ追加：このオプションを使用すると、Zoho Creatorへ新たにインポートされたデータのみを追加することができます。
  

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

• 追加と更新を両方行う：このオプションでは、選択した項目に照合するデータは更新し、照合しない項目値の場合は新規に追加されます。

 

 

7. 一意かつ必須の項目を選択し、「照合する based オン 項目」ドロップダウンからデータを照合してください。項目が必須に設定され、複製不可としてマークされていることをZoho Creatorフォームでご確認ください。詳細はこちらをご覧ください。

8. 初期設定では、Creatorワークフローを無効にするオプションが有効になっています。これにより、データがCreatorにエクスポートされる際にワークフローが実行されるのを防止します。必要に応じて無効化を解除することもできます。

9. インポート元と同じフォームにデータをエクスポートする場合、エクスポート対象データと照合しないZoho Creatorのデータを削除することも可能です。

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

また、「削除対象データの確認」リンクを使用して、削除前にデータを確認することもできます。

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

ターゲットのマッチングを確認

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

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

現在、ターゲットマッチングの確認後、まずは手動実行でパイプラインの動作確認を行うことをおすすめします。手動実行が正常に完了したら、スケジュールを設定してパイプラインの自動化が可能です。さまざまな実行タイプについてはこちらをご参照ください。

情報: 各実行はジョブとして保存されます。パイプライン実行時、データソースから取得済みのデータが各ステージで申請済みの一連の変換処理によって整形され、その後、データが指定先へエクスポート済みとなります。この完了したプロセスはジョブページで確認できます。

11. 手動実行がエラーなく成功した場合、データは正常にエクスポート済みとなります。もし以下のターゲット照合するエラーで手動実行が失敗した場合は、ターゲットマッチング手順を完了することで修正できます。

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

 

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

 

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

ターゲットマッチングは、データが宛先にエクスポート済みとなる前に行われます。ターゲットマッチングは、データモデルの不一致によるエクスポートする失敗を防ぐためのDataPrepの便利な機能です。ターゲットマッチングを利用することで、目的のZoho Creatorフォームをターゲットとして設定し、データ元データセットの列をターゲットのZoho Creatorフォームに合わせて照合できます。これにより、高品質なデータをスムーズにZoho Creatorへエクスポートすることが可能です。

メモ: ターゲットマッチングの失敗はエクスポートする失敗とは異なります。ターゲットマッチングは、データが実際にエクスポート済みとなる前に行われます。これにより、スキーマやデータモデルのエラーが事前に検出され、エクスポートする失敗を未然に防ぐことができます。ターゲットマッチングの詳細はこちら。

 ターゲット照合するチェックが失敗した場合

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

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

3. 概要を表示リンクをクリックして、ターゲット照合するエラーの概要を表示します。概要では、さまざまなモデルの照合エラーと、それぞれのエラーに関連付けられている列数が表示されます。必須エラー列をクリックし、適用するをクリックすることで特定のエラー列のみをフィルタリングできます。

ターゲット照合するエラー概要

Target 照合するエラー

• 一致しない列：このオプションは、データ元データセット内でターゲットの列と一致しない列をフィルタリングします。
  
  
  
  情報：一致しない列のフィルターを使用する場合、必須列のみを表示を切り替えて、必須として設定された列が含まれているかどうかを確認できます。必須列のみを修正してエクスポートを続行することも可能です。
  

• データの種類の不一致：このオプションは、データ元データセット内でターゲットの列とデータ型が一致しない列をフィルタリングします。

• データ形式の不一致：このオプションは、データ元データセット内でターゲットデータセットとデータ形式が異なる列をフィルタリングします。

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

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

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

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

メモ: Creatorフォームで複数の複製するデータが存在する場合、一意の項目に基づき、最後の複製するデータのみが更新され、他の複製するデータはスキップされます。重複を避けるため、Creatorへのエクスポート前にdeduplicatetransformをZoho DataPrepでご利用いただくことを推奨します。

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

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

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

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

Rollback now

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

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

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

重要：

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

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

 制限事項

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

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

関連情報

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

ターゲットマッチングの詳細はこちら

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

Zoho DataPrepがCreatorデータでさまざまな使用例を実現する方法をご覧ください.