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. 自動採番（Auto_number）項目
4. 画像項目
5. ファイル項目
6. 編集不可項目 - view_type - edit : false
7. Field_read_only 項目
8. API 名が「Participants」のカスタム項目
9. 次のようなシステム定義項目: Created By、Modified by、Created time、Modified time、Change_Log_Time_s
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
すべてのレコードの Parent Id を一括で取得する手順:
1) Zoho CRM から親タブをインポートします。
2) サブフォームにエクスポートしたい CSV ファイルをインポートします。
2) Join を使用して、サブフォームにエクスポートしたい CSV ファイルを、親タブと一致する項目で結合します。
3) 結合後のデータセットで、サブフォームの id 列が取得されます。この id 列を Duplicate で複製し、ターゲットマッチチェックを通過するために名前を「Parent_Id」に変更します。
4) CSV ファイルを、Zoho CRM でデータをエクスポートしたい サブフォーム にエクスポートします。Zoho CRM へのエクスポートの詳細については、Zoho CRM へのエクスポートをご覧ください。
5. ルックアップ型の列を含むファイルを DataPrep から Zoho CRM にエクスポートする方法
If a 項目 has a value in the lookup datatype in Zoho CRM, it will have a unique id when importing and exporting to Zoho CRM through DataPrep. However, while exporting as a file to Zoho CRM, the dataset should contain a column named in the format to エクスポート data to that unique 項目 with lookup datatype.
この列には任意の数の異なる値を含めることができますが、列名は必ずこの特定の形式に従う必要があります。
たとえば: The Account Name 項目 in the Contact タブ is a unique 項目 with lookup datatype of the Accounts タブ in Zoho CRM.
Therefore, to エクスポート a file to the Contacts タブ with Account Name as lookup datatype, the file must contain a column in the format of <Account_Name.Account_Name>
Account_Name is the 項目 API name of Contact タブ and Account_Name is the 項目 API name of the Account タブ.
この列には任意の数の異なる値を含めることができますが、列名は必ずこの特定の形式に従う必要があります。
たとえば: The Account Name 項目 in the Contact タブ is a unique 項目 with lookup datatype of the Accounts タブ in Zoho CRM.
Therefore, to エクスポート a file to the Contacts タブ with Account Name as lookup datatype, the file must contain a column in the format of <Account_Name.Account_Name>
Account_Name is the 項目 API name of Contact タブ and Account_Name is the 項目 API name of the Account タブ.
メモ: Zoho CRM の任意のタブにあるマルチセレクト参照項目へのデータのエクスポートはサポートされていません。
6. How to エクスポート a file that contains a currency column to Zoho CRM through DataPrep?
Zoho CRM にファイルをエクスポートする際は、通貨列を含むデータセットには、$, £ などの通貨記号を含まない値のみが含まれていることを確認してください。記号付きの値をエクスポートした場合、DataPrep で通貨列に加えた変更は Zoho CRM に反映されません。Zoho CRM は特殊文字ではなく数値のみを認識します。そのため、通貨値を含む列は数値または小数のデータ型にしておいてください。
7. After importing files from other sources into DataPrep and exporting them to Zoho CRM, is it possible to rollback the updated records?
いいえ。この場合、ロールバックできるのは挿入されたレコードのみです。他のソースから DataPrep にデータを取り込み、その後 Zoho CRM にエクスポートした場合、更新レコードのロールバックはサポートされません。更新レコードのロールバックは、Zoho CRM -> Zoho DataPrep -> Zoho CRM のケースでのみサポートされます。
8. What should be done if エクスポート to Zoho CRM fails due to invalid mapping?
エクスポート時に「Invalid mapping, Invalid api_name」などのエラーで失敗する場合は、次の手順でトラブルシューティングしてください。
-
「一致条件となる項目」の選択が Zoho CRM で一意か確認する。
「一致条件となる項目」オプションで選択した項目が、Zoho CRM 上で一意項目として設定されていることを確認してください。
-
宛先を設定した後に、一致させた列名が変更されていないか確認する。
「一致条件となる項目」オプションは、宛先追加時点の列名に固定されます。後続のパイプラインで列名が変更された場合（たとえば、あるステージで「campaign member id」となっている列が、ターゲットマッチング中に「campaign_member_id」に変更された場合）、宛先設定には元の列名が保持され、更新後の名前にはなりません。この不一致が、エクスポート時の「Invalid api_name」エラーの原因になります。
これが原因か確認するには、「一致条件となる項目」で選択されている列名が、その項目の現在の CRM API 名（アンダースコアや大文字・小文字を含めて）と完全に一致しているかを確認してください。
-
宛先を削除して再追加して修正する。
列名の変更が原因の場合は、既存の宛先設定を削除し、再度追加してください。再追加する際は、「一致条件となる項目」を選択する前に、パイプライン側の列名が CRM の API 名と一致していることを確認します。これにより、内部参照が正しい最新の列名にリセットされます。 -
外部項目タイプがサポート対象か確認する
選択した外部項目が User などのサポートされないタイプである場合にも、このエラーが発生することがあります。一致に使用する外部項目には、テキストや数値などの単純な値が含まれている必要があります。User 型などの項目は、エクスポート時の一致には使用できません。
Single Line（テキスト）や数値など、サポートされている項目タイプを使用してください。User 型の外部項目は使用しないでください。
9. What should I do when the target match fails while exporting to Zoho CRM?
パイプラインの実行がターゲットマッチエラーで失敗した場合は、次の手順で修正してください。
- 「ジョブサマリー」ページ右上の[パイプラインを編集]オプションをクリックします。パイプラインビルダーページが開きます。
b. 最終ステージ（Zoho CRM を宛先として追加したステージ）を右クリックし、[データを準備]オプションを選択します。DataPrep Studioページが開きます。
d. [ターゲットを表示]オプションを選択します。Zoho CRM のタブがターゲットとして表示され、ソース列をそれに合わせてマッピングできます。エラーと警告は赤と黄色のアイコンで表示されます。
e. [すべての列]ドロップダウンをクリックし、[エラー列]オプションを選択します。その後、赤または黄色のアイコンをクリックして、ステージ列を Zoho CRM タブの項目にマッピングします。
これにより、Zoho CRM のターゲット列に合わせて、ステージ列に必要なデータ型や制約が追加されます。
メモ: CRM から取得したターゲット列は、API 名に基づいた名前になっています。そのため、ステージ列も同じ名前にしておいてください。これにより、システムが API 仕様に従って列を正しく検出し、CRM 項目にマッピングできます。
ターゲットが正常にマッピングされ、エラー列がなくなったら、パイプラインを実行できます。
インポート from Zoho CRM
1. Why is my タブ not listed in DataPrep?
インポート時、タブ名は Zoho CRM の API 名に基づいて DataPrep に表示されます。表示名を変更していても影響はありません。
2. Which columns are used for initial インポート in Zoho CRM?
初回インポートでは、Zoho CRM のCreated_Time 列とModified_Time 列に基づいてデータが取り込まれます。
3. How does Incremental fetch work in Zoho CRM インポート?
増分取得では、Created_Time 列とUser_Modified_Time 列を使用して、前回のインポート以降に新規作成・更新されたデータをそれぞれ取得します。
メモ: History_tracking タブでは、User_Modified_Time 列のみが使用されます。
データセットのインポートをスケジュールすると、インポート時刻または最後にスケジュールされた時刻が記録されます。初回はすべてのデータが取得されます。以降は、同期が成功するたびに最終同期時刻が新しい値に更新され、その時刻以降に作成または更新されたレコードのみがインポートされます。Zoho CRM 側に新規または更新データがない場合は、何もインポートされません。データが同期されなかった場合でも、試行が行われたため同期時刻は更新されます。次回のサイクルでは、この同期時刻以降に作成または更新されたレコードが取得されます。
4. Is it possible to connect Multiple Zoho CRM accounts to one Zoho DataPrep account?
現時点ではサポートされていません。1 つの DataPrep アカウントで複数の Zoho CRM アカウントからデータをインポートできるよう、今後対応を予定しています。
現在は、1 つの Zoho CRM アカウント内の複数組織からデータをインポートできます。
ただし、複数の Zoho CRM アカウントからデータをインポートする場合は、それぞれの Zoho CRM アカウントと同じ ID でサインインした別々の DataPrep アカウントが必要です。
現在は、1 つの Zoho CRM アカウント内の複数組織からデータをインポートできます。
ただし、複数の Zoho CRM アカウントからデータをインポートする場合は、それぞれの Zoho CRM アカウントと同じ ID でサインインした別々の DataPrep アカウントが必要です。
5. Why is the multi select lookup 項目 not listed as columns in the dataset after インポート?
The multi select lookup 項目 is not supported for both インポート and エクスポート. So, you cannot インポート data from a multi select lookup 項目 in Zoho CRM to DataPrep and similarly you cannot エクスポート data to a multi select lookup 項目 in Zoho CRM from DataPrep.