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

Zoho DataPrep では、データを Zoho Directory にエクスポートできます。Zoho Directory は、複数のプロダクトへの認証とアクセスを一元管理できる ID・アクセス管理ソフトウェアです。

メモ: この連携は現在プライベートプレビューのため、現時点ではすべての Zoho DataPrep ユーザーは利用できません。

 Zoho Directory へデータをエクスポートする手順

3. All destinations タブで Zoho Directory を検索するか、Zoho Apps カテゴリから選択します。

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

5. Saveで送信先の設定を保存します。

パイプラインを実行する前にターゲットマッチングを確認する

エクスポートの失敗を防ぐため、パイプラインを実行する前に必ずターゲットマッチングを完了してください。 こちらをクリック して、ターゲットマッチングの詳細をご確認ください。

1. Zoho Directory を送信先に設定したステージのDataPrep Studio ページに移動します。

2. 右上のターゲットマッチングアイコンをクリックし、表示されるメニューからShow target オプションを選択します。

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. サマリーを表示リンクをクリックすると、ターゲットマッチエラーのサマリーを確認できます。サマリーには、さまざまなモデルマッチエラーと、それぞれのエラーに関連付けられている列数が表示されます。必要なエラーカテゴリをクリックし、適用をクリックすると、特定のエラー列だけを絞り込んで表示できます。
 

ターゲットマッチエラーのサマリー

ターゲットマッチングのエラーの種類

ターゲットマッチングで発生するエラーの内容は、以下のとおりです。

1. 未一致の列: このオプションでは、ソースデータセットとターゲットデータセットの両方で、一致していないすべての列が表示されます。

情報: 一致しない列フィルターを使用する場合、必須列のみを表示を切り替えて、必須列（必須として設定されている列）が不足していないか確認し、必要に応じて追加できます。必須列のみを修正して、そのままエクスポートを続行することもできます。

2. データ型の不一致: このオプションは、ソースデータセット内で、ターゲットの列とデータ型が一致しない列を抽出して表示します。

3. データ形式の不一致: このオプションは、ソースデータセット内で、ターゲットデータセットとデータ形式が異なる列を抽出して表示します。

4. 制約の不一致: このオプションは、ターゲットの列に設定されているデータ型の制約と一致しない列を抽出して表示します。列に制約を追加する方法については、こちらをクリックしてください。

5. 必須列の不一致: このオプションは、ターゲット側で必須に設定されているものの、ソース側では必須に設定されていない列を表示します。
   
   

   必須列は、一致させて必須として設定しない限り、宛先にエクスポートできません。列の上部にある アイコンをクリックして、その列を必須として設定できます。

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

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 へのエクスポート時にターゲットマッチが失敗した場合はどうすればよいですか？

パイプラインの実行がターゲットマッチエラーで失敗した場合は、次の手順で修正してください。

1. Job summary ページ右上の Edit pipeline オプションをクリックします。Pipeline builder ページが開きます。
   

      

メモ: 画面例として Zoho CRM が表示されていますが、同じ操作はすべてのコネクタで有効です。

b. 最終ステージ（宛先として Zoho Directory を追加したステージ）を右クリックし、Prepare Data オプションを選択します。DataPrep Studio ページが開きます。

      

c. データグリッドのすぐ上、右上にあるターゲットマッチングアイコン をクリックします。

d. Show target オプションを選択します。Zoho Directory タブがターゲットとして表示され、ソース列をそれに合わせて揃えられるようになります。エラーと警告は赤と黄色のアイコンで強調表示されます。

      

     

e. All columns ドロップダウンをクリックし、Error columns オプションを選択します。次に、赤または黄色のアイコンをクリックして、ステージ列を Zoho Directory タブの項目にマッチさせます。

これにより、ステージ列に必要なデータ型と制約が追加され、Zoho Directory のターゲット列と一致するようになります。

メモ: Zoho Directory のターゲット列名は API 名に基づいています。そのため、ステージ列にも同じ名前を付けてください。これにより、システムが API 標準に従って列を正しく検出し、Directory 項目にマッピングできるようになります。

ターゲットへのマッピングが完了し、エラー列がなくなったら、パイプラインを実行できます。

関連情報

パイプラインをスケジュールする方法 

ターゲットマッチングの詳細.