Zohoディレクトリへのデータエクスポート［プライベートプレビュー］

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

Zoho DataPrepは、データをZoho Directoryへエクスポートすることに対応しています。Zoho Directoryは、複数の商品への認証やアクセス権限の管理を行えるアイデンティティおよびアクセス管理ソフトウェアです。

メモ: この連携は現在、非公開プレビューに含まれており、現時点ではZoho DataPrepで全ユーザーが利用できるわけではありません。

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

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

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

3. すべてのdestinationsタブでZoho Directoryを検索するか、Zohoアプリカテゴリーで選択します。

4. Zoho Directory内で組織を選択し、データをエクスポートしたい組織を指定します。

5. 保存して、宛先の設定を完了します。

ターゲットの一致を確認

ZohoDirectoryが宛先として設定されているステージのDataPrep Studio ページに移動します。

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

現在、ターゲットマッチングの確認中の場合は、まずパイプラインを手動実行で試すことをおすすめします。手動実行で問題なく動作することを確認したら、スケジュールを設定してパイプラインを自動化できます。各実行タイプの詳細はこちらをご参照ください。

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

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

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

メモ:

1. 各データ型と照合する値を持つ行のみがエクスポート済みとなります。

2. データの種類が一致しない行はエクスポート済みにならず、エラーの詳細はメールおよび通知パネルでお知らせします。

3. email_id 列は一意である必要があります。ユーザーデータは一意のメールIDに基づいてZoho Directoryへエクスポート済みとなります。

4. 無効または欠落したメールIDを含むデータセットは、Zoho Directoryへエクスポート済みできません。email_id列に無効な値や欠損値が含まれていないことを、スケジューリング前に必ずご確認ください。

5. その他の列は、無効な値や欠損値があってもZoho Directoryへエクスポート済みとなります。

Zoho Directoryへのエクスポート時のターゲット照合

ターゲット照合は、データがエクスポート済み先に送信される前に行われます。ターゲット照合は、データモデルの不一致によるエクスポートする失敗を防止する、DataPrepの便利な機能です。ターゲット照合を利用することで、必須のZoho Directoryテーブルをターゲットとして設定し、データ元データセットの列をターゲットのZoho Directoryタブ項目と照合するように揃えることができます。これにより、高品質なデータをZoho Directoryへシームレスにエクスポートすることが可能になります。

メモ: Target matching failure はエクスポート失敗とは異なります。Target matching は、実際にデータがエクスポート先へ送信される前に行われます。これにより、スキーマやデータモデルのエラーによるエクスポート失敗を事前に防ぐことができます。target matchingの詳細はこちらをご参照ください。

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

1. Zoho Directory でエクスポート中にtarget照合チェックが失敗した場合、DataPrep Studioページへ移動し、右上のtarget matchingアイコンをクリックし、targetの表示オプションを選択します。targetのデータモデルが既存データ元データセットの上部に表示されます。

データ元データセット内の列は、該当する場合は自動的にtargetデータセットの列と照合されます。

2. Target matchingでは、照合済み列と未照合列に異なるアイコンや提案が表示されます。これらの提案をクリックして、既存列をtarget列に素早く修正できます。エラーを修正しやすいよう、Zoho Directory内のtargetタブがデータのtargetとして紐付けられています。DataPrep Studioページでデータとテーブルのマッピングや不一致箇所のエラーを確認できます。エラーアイコンにカーソルを合わせると詳細を確認でき、クリックして個別にエラーを解決できます。

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

3. 表示する概要 リンクをクリックして、ターゲット照合エラーの概要を表示します。概要には、各モデルの照合エラーおよび各エラーに関連付けられているカラム数が表示されます。必要なエラーカラムをクリックし、適用するをクリックして、特定のエラーカラムだけを絞り込んで表示できます。

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

Target 照合するエラーセクションでは、エラーと各エラーに関連付けられている列の番号が表示されます。
上部のセクションには、エラーカテゴリーごとにエラー数とともに一覧表示されます。
各カテゴリーをクリックすると、パネル内でそのカテゴリーに関連するエラーのみをフィルター表示できます。
初期設定の表示では、すべての列が表示されますが、任意のエラーカテゴリーをクリックすることで、該当する列を詳細に確認したり、エラーのみ表示のチェックボックスを選択してエラー列だけを表示できます。
Target 照合するエラー概要でのフィルター選択は、DataPrep Studioページのグリッドにも反映されます。

Target照合エラー

Target照合で発生するエラーについて、以下で説明します。

未照合列：このオプションでは、データ元およびTargetデータセットで未照合となっているすべての列が表示されます。

情報：未照合列フィルターを使用する際は、必須列のみ表示を切り替えることで、必須（mandatory）として設定された列が存在するかどうかを確認し、それらを含めることができます。必須列のみを修正してエクスポートを続行することも可能です。

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

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

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

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

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