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

Zoho DataPrepは、データをZoho Directoryへエクスポートする機能をサポートしています。Zoho Directoryは、複数の商品の認証およびアクセス管理を実現するアイデンティティ＆アクセス管理ソフトウェアです。

メモ: このインテグレーションは現在、非公開プレビューに含まれており、現時点ではZoho DataPrepのすべてのユーザーにご利用いただけません。.

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

1. エクスポートする nowオプションを、エクスポートするメニューから、DataPrep Studioページでクリックします。

2. すべての宛先タブでZoho Directoryを検索するか、Zohoアプリカテゴリー内から選択できます。

3. Zoho Directoryでデータをエクスポートしたい組織を選択します。

4. 次をクリックしてエクスポート概要を表示します。概要には、宛先、組織名、エクスポート対象データ数、ターゲット照合結果などの詳細が含まれます。

5. ターゲット照合チェックに失敗した場合は、ターゲット照合手順を完了し、エラーを修正してください。ターゲット照合チェックに合格した場合は、そのままZoho Directoryへのデータエクスポートを続行できます。

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

6. 「エクスポートする」をクリックして、データをZoho Directoryにエクスポートすることができます。。

クイックヒント：エクスポートする処理をバックグラウンドで実行したい場合は、「閉じる」をクリックしてください。エクスポートするの進行状況は通知パネルで確認でき、完了時にはお知らせが届きます。

7. エクスポートするが完了すると、エクスポートする概要ウィジェットに、挿入、更新、削除されたデータの番号や、場合によってはエクスポートに失敗した件数が表示されます。.

8. エクスポートするをスケジュールするには、Schedule this エクスポートする?オプションを選択します。.

エクスポートするのスケジューリング手順：

• 繰り返し方法（頻度『N』時間、毎日、毎週1回、毎月1回）を選択し、Perform 頻度ドロップダウンで頻度を設定します。

• また、タイムゾーンも選択できます。データのエクスポートには、初期設定でローカルタイムゾーンが選択されています。

• 「保存」をクリックします。

クリック こちらをクリックすると、Scheduleエクスポートに関する詳細をご覧いただけます。

メモ:

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

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

3. email_id列は一意である必要があります。ユーザーデータは、固有のメールIDに基づきZoho Directoryへエクスポートされます。 

 

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

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

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

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

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

1. Zoho Directory でターゲット照合チェックが失敗した場合、エクスポート時にエラーの詳細を表示リンクをエクスポート概要パネルからクリックして、エラーの概要を確認できます。

2. Target 照合エラーパネルには、さまざまなモデル照合エラーと、それぞれのエラーに関連する列数が表示されます。

アドバイス:初期設定では表示するオプションでエラー列のみが表示されますが、表示 only エラーのチェックボックスを外すことで、すべての列を表示できます。 

ターゲットマッチング時のエラーについて、下記で説明します。

1. Unmatched columns : このオプションでは、データ元およびターゲットデータセット内で一致しないすべての列が表示されます。

Unmatched columns フィルターを使用する際は、表示 only mandatory columnsを切り替えて、必須列があるかどうかを確認し、含めることができます。

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

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

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

5. 必須列の不一致 : このオプションは、ターゲットで必須となっている列をフィルターします。

6. データサイズ超過の警告 : このオプションは、ターゲットで許可されている最大サイズを超えたデータが含まれる列をフィルターします。

3. Fix errors ボタンを使い、Target 照合する errors ペインに表示された列レベルの問題を修正するために、データセットに戻ることができます。

1. 「Target 照合する errors」セクションには、エラーと各エラーに関連付けられている列の番号が表示されます。

2. 画面上部のセクションには、エラーカテゴリーごとにそのエラー数が一覧表示されます。

3. 各カテゴリーをクリックすると、パネル内でそのカテゴリーに関連するエラーのみをフィルター表示できます。

4. 初期設定ではすべての列が表示されますが、任意のエラーカテゴリーをクリックすることで、対象の列を詳しく確認したり、「表示 only errors」チェックボックスをオンにしてエラーがある列のみを表示することも可能です。

5. 「Target 照合する errors」パネルで選択したフィルターは、「DataPrep Studio」ページのグリッドにも適用されます。

4. エラー修正後は、データをZoho Directoryへエクスポートする作業を続行できます。.

5. エクスポートが完了すると、「エクスポートする 概要」ウィジェットに挿入・更新・削除されたデータの件数や、場合によってはエクスポートに失敗した件数が表示されます。

6. 「Schedule this エクスポートする?」オプションを選択して、エクスポートのスケジュール設定が可能です。

エクスポートをスケジュールするには、

• 「繰り返し」方法（頻度'N'時間ごと、毎日、週1回、月1回）を選択し、「Perform 頻度」ドロップダウンで頻度を設定します。

• データのエクスポートに使用する「タイムゾーン」も選択できます。初期設定ではローカルタイムゾーンが選択されています。

• 「保存」をクリックします。

スケジュールエクスポートの詳細については、こちらをご覧ください。



7. 削除データや失敗したデータがある場合、ダウンロードアイコンをクリックすると、それらをダウンロードして内容を確認できます。

データエクスポートのスケジュール方法   

「Schedule エクスポートする」オプションを使用して、scheduleデータをエクスポートできます。

1. Schedule エクスポートするオプションを、エクスポートするメニューの中から「DataPrep Studio」ページで選択します。

2. 新規 scheduleボタンをクリックして、エクスポート用の新しいスケジュールを作成します。

メモ:

ここから既存のスケジュールの一時停止・再開、編集、共有、削除も行えます。

3. Schedule config セクションで、繰り返し方法（頻度「N」時間、頻度 day、週1回、月1回）を選択します。繰り返しの時間を選択し（つまり、頻度を設定）、Perform 頻度オプションを使用します。



4. タイムゾーンをデータのエクスポート用に選択します。初期設定では、ご利用中のローカルタイムゾーンが選択されています。

5. 次をクリックし、Zoho Directory を すべて destinations タブで検索するか、Zohoアプリ カテゴリーから選択できます。

6. Zoho Directoryでデータをエクスポートしたい組織 を選択します。



7. 次 をクリックして、エクスポートする概要セクションにターゲット照合結果を表示します。

8. ターゲット照合チェックに失敗した場合は、ターゲット照合の手順を完了し、エラーを修正してください。ターゲット照合チェックに合格した場合は、Zoho Directoryへのデータエクスポートを続行できます。

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

9. エクスポートする ボタンをクリックし、エクスポートするのスケジュールを設定します。

制限事項

• ユーザーデータは、一意のメールIDに基づいてZoho Directoryにエクスポートされます。メールアドレスがZoho Directoryに既に存在する場合、データが更新されます。存在しない場合は、新しいユーザーが追加されます。
  

• エクスポート時に、データセット内に同じメールIDが2つ含まれている場合、最初のものが更新され、2つ目は失敗してエクスポート処理が停止します。そのため、事前にdeduplicate変換を適用し、メールIDの重複を防ぐことを推奨します。

• エクスポートする際には、必須12列のみが許可されます。Zoho Directoryにデータセットをエクスポートする際は、追加の列を削除してください。必須列は以下の通りです：
  
  

• first_name

• last_name

• email_id

• display_name

• user_status

• timezone

• language_code

• 住所-street_address

• 住所-市区町村

• 住所-状態

• country_code
  

• 住所-国
  

• ユーザーがZoho Directoryで管理 項目オプションを使って項目を追加した場合、その項目も必須列として照合済みリストに表示されます。
  

• データをZoho Directoryにエクスポートした後は、変更を元に戻すことやキャンセルすることはできません。
  

• 一度に最大10,000件のデータをエクスポートできます。。

関連情報

データエクスポートのスケジュール方法 

スケジュールの管理
Target Matchingについて詳しくはこちら