Zoho DataPrep用Zoho Directoryコネクター［プライベートプレビュー］
Zoho DataPrep では、データを Zoho Directory にエクスポートできます。Zoho Directory は、複数のプロダクトへの認証とアクセスを一元管理できる ID・アクセス管理ソフトウェアです。
メモ: この連携は現在プライベートプレビューのため、現時点ではすべての Zoho DataPrep ユーザーは利用できません。
Zoho Directory へデータをエクスポートする手順
2. Pipeline Builderページで、データフローの作成と各ステージへの必要な変換の適用が完了したら、ステージを右クリックし、Add Destinationオプションを選択します。
3. All destinations タブで Zoho Directory を検索するか、Zoho Apps カテゴリから選択します。
4. Zoho Directory 内で、データをエクスポートしたいOrganization を選択します。
5. Saveで送信先の設定を保存します。
パイプラインを実行する前にターゲットマッチングを確認する
1. Zoho Directory を送信先に設定したステージのDataPrep Studio ページに移動します。
6. 手動実行がエラーなく成功した場合、データは正常にエクスポートされます。手動実行が失敗し、以下のターゲットマッチエラーが表示された場合は、ターゲットマッチングの手順を完了して修正してください。
メモ:
1. 値がそれぞれのデータ型と一致している行のみがエクスポートされます。
2. データ型が一致しない行はエクスポートされず、エラーの詳細はメールおよび通知パネルで通知されます。
3. email_id 列は一意である必要があります。ユーザーのレコードは、一意のメールアドレスに基づいて Zoho Directory にエクスポートされます。
4. 無効または欠損しているメールアドレスを含むデータセットは、Zoho Directory にエクスポートできません。Zoho Directory へのスケジュール設定 を行う前に、email_id 列に無効な値や欠損値が含まれていないことを確認してください。
5. その他の列については、無効な値や欠損値が含まれていても Zoho Directory にエクスポートされます。
Zoho Directory へのエクスポート時のターゲットマッチング
ターゲットマッチチェックが失敗した場合
1. Zoho Directory へのエクスポート中にターゲットマッチチェックが失敗した場合は、DataPrep Studio ページに移動し、右上のターゲットマッチングアイコン をクリックして、ターゲットを表示オプションを選択します。ターゲットのデータモデルが、既存のソースデータセットの上部に表示されます。
ソースデータセットの列は、自動的にターゲットデータセットの列に一致するように整列されます（一致が見つかった場合）。
3. サマリーを表示リンクをクリックすると、ターゲットマッチエラーのサマリーを確認できます。サマリーには、さまざまなモデルマッチエラーと、それぞれのエラーに関連付けられている列数が表示されます。必要なエラーカテゴリをクリックし、適用をクリックすると、特定のエラー列だけを絞り込んで表示できます。
ターゲットマッチエラーのサマリー
- ［ターゲットマッチエラー］セクションには、エラーの種類と、それぞれのエラーに関連付けられている列数が表示されます。
- 上部のセクションには、エラーカテゴリと各カテゴリ内のエラー数が一覧表示されます。
- 各カテゴリをクリックすると、そのカテゴリに関連するエラーだけをパネル内に絞り込んで表示できます。
- デフォルトビューでは、すべての列が表示されますが、任意のエラーカテゴリをクリックして列を詳しく確認したり、エラーのみ表示チェックボックスを選択して、エラー列だけを表示したりできます。
- ［ターゲットマッチエラーのサマリー］で行ったフィルターの選択内容は、DataPrep Studio ページのグリッドにも適用されます。
ターゲットマッチングのエラーの種類
ターゲットマッチングで発生するエラーの内容は、以下のとおりです。
-
未一致の列: このオプションでは、ソースデータセットとターゲットデータセットの両方で、一致していないすべての列が表示されます。
情報: 一致しない列フィルターを使用する場合、必須列のみを表示を切り替えて、必須列（必須として設定されている列）が不足していないか確認し、必要に応じて追加できます。必須列のみを修正して、そのままエクスポートを続行することもできます。-
データ型の不一致: このオプションは、ソースデータセット内で、ターゲットの列とデータ型が一致しない列を抽出して表示します。
-
データ形式の不一致: このオプションは、ソースデータセット内で、ターゲットデータセットとデータ形式が異なる列を抽出して表示します。
-
制約の不一致: このオプションは、ターゲットの列に設定されているデータ型の制約と一致しない列を抽出して表示します。列に制約を追加する方法については、こちらをクリックしてください。
-
必須列の不一致: このオプションは、ターゲット側で必須に設定されているものの、ソース側では必須に設定されていない列を表示します。
必須列は、一致させて必須として設定しない限り、宛先にエクスポートできません。列の上部にあるアイコンをクリックして、その列を必須として設定できます。
-
データサイズ超過の警告: このオプションは、ターゲットで許可されている最大サイズを超えるデータを含む列を抽出して表示します。
4.エラーを修正したら、パイプラインビルダーページに移動し、パイプラインを実行してデータをエクスポートできます。手動実行で問題なく動作することを確認したら、スケジュールを設定してパイプラインを自動化できます。さまざまな実行タイプについてはこちらをご覧ください。
制限事項
-
ユーザーのレコードは、一意のメールアドレスに基づいて Zoho Directory にエクスポートされます。メールアドレスがすでに Zoho Directory に存在する場合は、そのデータが更新されます。存在しない場合は、新しいユーザーが追加されます。
-
エクスポート中に、1 つのデータセット内に同一のメールアドレスが 2 件含まれている場合、1 件目のみが更新され、2 件目は失敗してエクスポート処理が停止します。そのため、重複したメールアドレスを防ぐには、事前に重複排除変換を適用することを推奨します。
-
エクスポート時に許可されるのは、必須 12 列のみです。Zoho Directory へデータセットをエクスポートする際は、不要な追加列を削除する必要があります。必須列は次のとおりです:
-
first_name
-
last_name
-
email_id
-
display_name
-
user_status
-
timezone
-
language_code
-
address-street_address
-
address-city
-
address-state
-
country_code
-
address-country
-
ユーザーが Zoho Directory の項目の管理オプションを使用して項目を追加した場合、その項目も一致させる必要がある必須列として一覧に表示されます。
-
Zoho Directory にデータをエクスポートした後は、変更を元に戻したり取り消したりすることはできません。
-
一度にエクスポートできるレコード数は最大 10,000 件です。
よくある質問
1. Zoho Directory へのエクスポート時にターゲットマッチが失敗した場合はどうすればよいですか？
- Job summary ページ右上の Edit pipeline オプションをクリックします。Pipeline builder ページが開きます。
関連情報