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

概要:

例:

CRM AのSuper Adminはjohn@xyz.comであり、CRM BのSuper Adminは設定@abc.com.auです。これらは別々のユーザーですので、Zoho CRMのConnection機能を利用し、Multi Org機能を使って連絡先をプッシュすることができます。

Serverless Functionsを選択する理由:

1. エクスポート-インポートオプションも利用できますが、これは一時的な解決策として適しています。しかし、今回の場合は、連絡先がCRM Aで作成されるたびに同期されるよう、接続を有効にしておく必要があります。
   
2. CRMで外部連携をカスタムサービスとして作成することも可能ですが、両方のZoho CRM組織が同じデータセンターにある場合、CRM AにログインしたままCRM Bへの接続を認証することはできません。ただし、異なるデータセンターにある場合は認証が可能です。
   

Solution:

Configuration / 設定:

権限と利用可能範囲  

1. 「管理 Extensibility」権限を持つユーザーは、外部連携の作成やカスタム関数の作成が可能です。
   
2. 「管理 自動化」権限を持つユーザーは、ワークフルールールの設定が可能です。
   
3. 「管理 テスト環境」権限を持つユーザーは、テスト環境の管理やこのケースのテストが可能です。
   

Destination CRM 設定:

1. string standalone.createContfromCRMB(String requestBody)
2. {
3. if(isNull(requestBody))
4. {
5. 返品する 'いいえ Content';
6. }
7. else
8. {
9. contMap = Map();
10. contMap.put('Last_Name',requestBody.取得する('Last_Name'));
11. contMap.put('メール',requestBody.取得する('メール'));
12. info 'contMap :' + contMap;
13. dataList= List();
14. dataList.追加する(contMap);
15. dataMap = Map();
16. dataMap.put('data', dataList);
17. createRec = invokeurl
18. [
19. url :'https://www.zohoapis.com/crm/v7/連絡先/upsert'
20. 種類 :POST
21. パラメーター:dataMap.toString()
22. connection:'zohocrm'
23. ];
24. info 'createRec :' + createRec;
25. 返品する createRec;
26. }
27. }

カスタム関数の設定（Destination CRM）:

メモ:

1. スクリプト内でIfelse()が使用されており、Destination CRMのカスタム関数がデータ内容を受信しない場合、「いいえContent」というメッセージが返されます。
   
2. 引数として、DataType値を「String」、変数名を「requestBody」として追加してください。
   
   

Serverless Function - APIキーの有効化:

サンプル記録:

これで、Endpoint URL を取得しました。この URL はカスタム関数内からワークフローに関連付けて呼び出すことができます。これは、データ元 CRM で連絡先の新規作成または編集時に、新しい連絡先を作成、または既存の連絡先を編集する際に実行されます。

データ元 CRM 設定 :

メモ:

1. 引数を追加して、ワークフロー実行時にデータから値を取得してください。下記のスクリーンショットに表示されているサンプル引数を参照できます。
   
2. マッピングには、Destination CRMで連絡先作成時に送信したいデータ値を必ず含めてください。
   
3. ワークフローから取得した値に基づき、Invoke URLのデータ内容でマッピングするための引数を追加してください。
   
4. 設定する引数が10個を超える場合は、データIDを渡し、getRecordbyId()を使用して連絡先を取得し、連携タスクのレスポンスから値をマッピングしてください。
   

動作デモ:

メモのポイント：

1. 上記のDelugeスクリプト内で、必要な項目API名とマッピングを含め、項目値を作成する連絡先にマッピングしてプッシュしてください。
   
2. カスタム関数スクリプト内でAPI通話を行う際は、ご自身のドメイン固有のZoho APIエンドポイントURLに必ず変更してください。
   

ヒント：よくあるエラーを回避するには  

1. スクリプト内で、正しいAPI名をタブ＆項目の両方で使用していることを確認してください。
   
   
2. 意図した出力が得られているか確認するため、Zoho CRM Function IDEのコンソールセクションで各変数の出力をチェックできるよう、info()ログの利用を推奨します。
   
   
3. 関数スクリプト内で外部連携を使用しているため、意図したAPI操作を実行するには必須スコープを接続に追加していることを確認してください。また、Deluge Invoke URLまたはIntegrationタスクに渡す際は外部連携のリンク名（例：crm_connection）を使用してください。
   
   
4. 一般的な例としてUS DCのAPIエンドポイントを使用していますが、異なるDC（例：IN、EU、CA、AUなど）のCRMアカウントをご利用の場合は、お使いのDCに合わせたAPIエンドポイントURLを利用することを推奨します。
   

1. 自動化機能（例：ワークフルールール）がこの使用ケースに関与しているため、意図した機能が動作しない場合は、ユーザーは関連付け済みの機能失敗理由を『設定 >> Developer Hub >> Functions >> 失敗』から確認できます。また、ユーザーは特定の作成済み関数に対してすべての関数実行の完了ログも追跡できます（つまり、My Functions >> 3点リーダー >> ログで確認可能）。この方法は、CRMデータのワークフルールール経由で関数が実行されたものの、データに対して意図した処理や更新が反映されなかった場合のシナリオでも役立ちます。このような場合、Zoho CRM内の関数ログから出力（情報ログ）や実行時のエラーを確認できます。
   

次のガイド記事を参照し、コード最適化のベストプラクティスおよびZoho CRM全体でカスタム関数を展開するさまざまな方法をご確認ください。

また、「ヨーロッパおよびイギリスのパートナー」の皆様はパートナー-サポート@eu.zohocorp.comまでご連絡ください。