トラブルシューティング - Zoho CRMのFAQ
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Zoho CRMへのエクスポート
1. Zoho CRMにファイルとしてエクスポートする際に列を含めるには
Zoho CRMへのファイルのエクスポートを正常に行うには、DataPrepの列名がZoho CRMのタブの対応する項目のAPI名と完全に一致している必要があります。一致していない場合、追加の列はエクスポートに含まれません。
これらの列を含めるには、列名をZoho CRMのタブの項目のAPI名と一致するように変更する必要があります。これにより、データがZoho CRMの正しい項目に適切に関連付けられて転送されます。
例：以下のスクリーンショットでは、名の列名は First Name です。
一方、Zoho CRMのリードタブでの項目のAPI名は First_Name です。そのため、名の列をエクスポートに含めるには、列名を First_Name に変更する必要があります。
例：以下のスクリーンショットでは、名の列名は First Name です。
一方、Zoho CRMのリードタブでの項目のAPI名は First_Name です。そのため、名の列をエクスポートに含めるには、列名を First_Name に変更する必要があります。
名前変更後、名の列は対象項目と一致します。
エラーを修正すると、データセットをZoho CRMにエクスポートできる状態になります。
列名を変更した際に、その列に一致する項目が見つからない場合は、候補から手動で選択してください。
2. DataPrepからZoho CRMにエクスポートされない項目列はどれですか？
Zoho CRMからDataPrepにデータをインポートすると、多数のシステム生成列がインポートされます。ただし、エクスポート時には、これらの列は除外されます。
次の項目はエクスポートできません。また、DataPrepでこれらに加えた変更はZoho CRMに反映されません。
1. 複数選択ルックアップ項目
2. 数式項目
3. 自動採番項目
4. 画像項目
5. ファイル項目
6. タグ
7. 編集不可項目 - view_type - edit : false
8. Field_read_only項目
9. API名が「Participants」のカスタム項目
10. Created By、Modified by、Created time、Modified time、Change_Log_Time_sなどのシステム定義項目。
詳細については、Zoho CRMの制限に関するドキュメントを参照してください。
詳細については、Zoho CRMの制限に関するドキュメントを参照してください。
3. DataPrepはワークフロー自動化に対応していますか？
いいえ。DataPrepでステータスに変更を加えてZoho CRMにエクスポートした場合、ワークフロー自動化は機能しません。
Zoho CRMでルールがトリガーされると、ワークフロールールにより、メール通知の送信、タスクの割り当て、データの特定の項目の更新が自動化されます。ただし、DataPrepで変更を行ってからエクスポートした場合、そのトリガーはエクスポートではサポートされません。
Zoho CRMでルールがトリガーされると、ワークフロールールにより、メール通知の送信、タスクの割り当て、データの特定の項目の更新が自動化されます。ただし、DataPrepで変更を行ってからエクスポートした場合、そのトリガーはエクスポートではサポートされません。
そのため、DataPrepからデータをエクスポートした後、Zoho CRMで変更内容をすべて手動で更新する必要があります。
4. DataPrepを通じてZoho CRMのサブフォームにファイルをエクスポートするには
DataPrepを通じてZoho CRMのサブフォーム項目にデータをインポート／エクスポートする場合、データセットには一意の親ID列が標準で含まれます。
ただし、Zoho CRMのサブフォームにファイルとしてエクスポートする際は、適切なサブフォームにデータをエクスポートできるよう、データセットにサブフォームの一意の親ID値を持つ Parent_Id という名前の列が含まれていることを確認してください。
メモ：サブフォームの親IDは、Zoho CRMのアドレスバーでタブ名の後に表示されます。
例：2098831000000465052
例：2098831000000465052
すべてのデータの親IDを一度に取得する手順：
Zoho CRMの項目にルックアップデータ型の値がある場合、DataPrepを通じてZoho CRMとの間でインポート／エクスポートするとき、その値には一意のIDが割り当てられます。ただし、Zoho CRMにファイルとしてエクスポートする際に、そのルックアップデータ型の一意の項目へデータをエクスポートするには、データセットに形式の名前の列が含まれている必要があります。
列には任意の数の異なる値を含めることができますが、列名はこの特定の形式に従う必要があります。
たとえば、Zoho CRMの［Account Name］項目は、［Contact］タブにある、［Accounts］タブのルックアップデータ型の一意の項目です。
そのため、［Account Name］をルックアップデータ型として含むファイルを［Contacts］タブにエクスポートするには、ファイルに <Account_Name.Account_Name>
の形式の列が含まれている必要があります。
Account_NameはContactタブの項目API名で、Account_NameはAccountタブの項目API名です。
列には任意の数の異なる値を含めることができますが、列名はこの特定の形式に従う必要があります。
たとえば、Zoho CRMの［Account Name］項目は、［Contact］タブにある、［Accounts］タブのルックアップデータ型の一意の項目です。
そのため、［Account Name］をルックアップデータ型として含むファイルを［Contacts］タブにエクスポートするには、ファイルに <Account_Name.Account_Name>
の形式の列が含まれている必要があります。
Account_NameはContactタブの項目API名で、Account_NameはAccountタブの項目API名です。
メモ：Zoho CRMのどのタブでも、複数選択ルックアップ項目へのデータのエクスポートには対応していません。
6. DataPrepを通じて通貨列を含むファイルをZoho CRMにエクスポートするにはどうすればよいですか？
Zoho CRMにファイルをエクスポートする際は、通貨列を含むデータセットの値に$、£などの通貨記号が含まれていないことを確認してください。記号を含む値をエクスポートすると、DataPrepで通貨列に加えた変更がZoho CRMに反映されません。Zoho CRMでは、特殊文字ではなく数値のみが認識されます。そのため、通貨値の列は数値または小数データ型にしてください。
7. 他のソースからDataPrepにファイルをインポートしてZoho CRMにエクスポートした後、更新されたデータをロールバックできますか？
いいえ。この場合、ロールバックできるのは挿入されたデータのみです。他のソースからDataPrepに取り込んだデータについては、更新されたデータのロールバックには対応していません。対応しているのは、Zoho CRM→Zoho DataPrep→Zoho CRMの場合のみです。
8. 無効なマッピングが原因でZoho CRMへのエクスポートに失敗した場合はどうすればよいですか？
エクスポートが「Invalid mapping, Invalid api_name」などのエラーで失敗した場合は、次の手順でトラブルシューティングを行ってください。
-
［項目に基づいて照合］で選択した項目がZoho CRMで一意であることを確認します。
［項目に基づいて照合］オプションで選択した項目が、Zoho CRMで一意の項目として設定されていることを確認してください。
-
宛先の設定後に、照合対象の列名が変更されていないか確認します。
［項目に基づいて照合］オプションでは、宛先を追加した時点の列名が固定されます。後からパイプライン内で列名が変更された場合（たとえば、ステージで「campaign member id」と表示されていた列がターゲット照合中に「campaign_member_id」に変更された場合）、宛先設定には更新後の名前ではなく元の名前が保持されています。この不一致により、エクスポート時に「Invalid api_name」エラーが発生します。
これが原因かどうかを確認するには、［項目に基づいて照合］で選択した列が、その項目の現在のCRM API名と完全に一致しているかどうかを確認します（アンダースコアや大文字／小文字の区別を含む）。
-
宛先を削除して再追加することで修正します。
列名の変更が原因の場合は、既存の宛先設定を削除して再度追加します。再追加する際は、［項目に基づいて照合］で選択する前に、パイプラインの列名がCRM API名と一致していることを確認してください。これにより、内部参照が正しい現在の列名にリセットされます。 -
外部項目の種類がサポート対象であることを確認します
選択した外部項目がUserなどのサポートされていない種類の場合、このエラーが発生することがあります。照合に使用する外部項目には、テキストや数値などの単純な値が含まれている必要があります。Userのような項目は、エクスポート時の照合には対応していません。
単一行（テキスト）や数値など、サポートされている項目の種類を使用してください。User型の外部項目は使用しないでください。
9. Zoho CRMへのエクスポート中にターゲット照合が失敗した場合はどうすればよいですか？
パイプラインの実行がターゲット照合エラーで失敗した場合は、次の手順で修正してください。
- ジョブの概要ページで、右上の［パイプラインを編集］オプションをクリックします。パイプラインビルダーページが表示されます。
b. 最後のステージ（Zoho CRMを宛先として追加したステージ）を右クリックし、［データの準備］オプションを選択します。DataPrep Studioページが開きます。
d. ［ターゲットを表示］オプションを選択します。これにより、Zoho CRMタブがターゲットとして表示され、ソース列をそれに合わせて調整できます。エラーと警告は、赤色と黄色のアイコンで強調表示されます。
e. ［すべての列］ドロップダウンをクリックし、［エラー列］オプションを選択します。次に、赤色または黄色のアイコンをクリックして、ステージ列をZoho CRMタブの項目と照合します。
これにより、ステージ列に必要なデータ型と制約が追加され、Zoho CRMのターゲット列と一致するようになります。
メモ：CRMのターゲット列名はAPI名に基づいています。そのため、ステージ列にも同じ名前を付けてください。これは、システムがAPI仕様に従って列を検出し、CRM項目に正しくマッピングするために必要です。
ターゲットが正常にマッピングされ、エラー列がなくなったら、パイプラインを実行できます。
Zoho CRMからのインポート
1. DataPrepにタブが表示されないのはなぜですか？
インポート時、タブ名は表示名の変更に関係なく、Zoho CRMのAPI名に基づいてDataPrepに表示されます。
2. Zoho CRMでの初回インポートにはどの列が使用されますか？
初回インポート時、Zoho CRMのデータはZoho CRM内のCreated_Time列とModified_Time列に基づいてインポートされます。
3. Zoho CRMのインポートで差分取得はどのように機能しますか？
差分取得では、Created_Time列とUser_Modified_Time列を使用して、前回のインポート時刻以降に新規作成されたデータと変更されたデータをそれぞれ取得します。
メモ：History_trackingタブでは、User_Modified_Time列のみが使用されます。
データセットにインポートのスケジュールが設定されると、インポート時刻または前回のスケジュール時刻が記録されます。初回はすべてのデータが取得されます。同期が成功するたびに、前回の同期時刻が新しい値に更新され、その同期時刻以降に作成または変更されたすべてのデータがインポートされます。Zoho CRMに新規または変更されたデータがない場合、データはインポートされません。データが同期されなかった場合でも、同期が試行されたため、同期時刻は更新されます。次のサイクルでは、この同期時刻以降に作成または変更されたデータが取得されます。
4. 複数のZoho CRMアカウントを1つのZoho DataPrepアカウントに接続できますか？
現在は対応していません。1つのDataPrepアカウントで複数のZoho CRMアカウントからデータをインポートできるようにする予定です。近日中に提供される予定です。
現在は、1つのZoho CRMアカウント内の異なる組織からデータをインポートできます。
ただし、複数のZoho CRMアカウントからデータをインポートする場合は、各Zoho CRMアカウントと同じIDでサインインした個別のDataPrepアカウントが必要です。
現在は、1つのZoho CRMアカウント内の異なる組織からデータをインポートできます。
ただし、複数のZoho CRMアカウントからデータをインポートする場合は、各Zoho CRMアカウントと同じIDでサインインした個別のDataPrepアカウントが必要です。
5. インポート後、複数選択ルックアップ項目がデータセットの列として表示されないのはなぜですか？
複数選択ルックアップ項目は、インポートとエクスポートのどちらにも対応していません。そのため、Zoho CRMの複数選択ルックアップ項目からDataPrepにデータをインポートすることはできません。同様に、DataPrepからZoho CRMの複数選択ルックアップ項目にデータをエクスポートすることもできません。