【Zoho CRM】帳票サブフォームのカスタム項目の更新について

【Zoho CRM】帳票サブフォームのカスタム項目の更新について
Alert
本件でご紹介したカスタム関数のコードについては、あくまでサンプルのものでございます。
カスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。本サポート窓口では承りかねます。

1. はじめに

Zoho CRMの帳票系のタブにある商品サブフォームにつきまして、カスタム項目を追加できるようになりました。しかし、こちらの項目の更新につきましてはカスタム関数のみでは更新できかねます。カスタム関数内でAPIを呼ぶ必要ございます。APIをカスタム関数で呼ぶには下記の手順を踏んでいただく必要がございます。

2. 手順

2.1 手順１：APIコネクションの作成

下記FAQを参考に、Zoho CRMのAPIを呼び出すためのコネクションを作成します。
https://support.zoho.jp/portal/ja/kb/articles/zoho-crm-how-to-create-connection

上記FAQの手順５）にて下記のようなコードを生成できればOKです。

  1. update = invokeurl
  2. [
  3. url : ""
  4. type :PUT
  5. parameters: params
  6. connection:"crmconnection"
  7. ];

2.2 手順２：引数の設定

引数は次の２つです。[Edit Argument]から設定可能です。
  1. recordId：見積書／発注書／受注書／請求書のID (Int)
  2. moduleName：固定値 (String)
    1. 見積書タブのデータを更新する場合："Quotes"
    2. 発注書タブのデータを更新する場合："Purchase_Orders"
    3. 受注書タブのデータを更新する場合："Sales_Orders"
    4. 請求書タブのデータを更新する場合："Invoices"


2.3 手順３：コード作成

  1. apiNamesOfItemsList = {"Quotes": "Quoted_Items", "Invoices": "Invoiced_Items", "Purchase_Orders": "Purchase_Items", "Sales_Orders": "Ordered_Items"};

  3. record = zoho.crm.getRecordById(moduleName, recordId);
  4. products = ifnull(record.get("Product_Details"),"");

  6. pdlist = List();
  7. for each product in products
  8. {
  9. mp = product;
  10. // デフォルトの項目を転記
  11. mp.put("Product_Name", product.get("product"));
  12. mp.put("Quantity", product.get("quantity"));
  13. mp.put("Total_After_Discount", product.get("total_after_discount"));
  14. mp.put("Net_Total",product.get("net_total"));
  15. mp.put("List_Price",product.get("list_price"));
  16. mp.put("Total",product.get("total"));
  17. mp.put("Description",product.get("product_description"));
  18. mp.put("Line_Tax",product.get("line_tax"));

  20. // カスタム項目
  21. // mp.put("unit","個");
  22. // mp.put("項目のapi名", [値] );

  24. pdlist.add(mp);
  25. }
  26. info pdlist;

  28. dataList = List();
  29. data = Map();
  30. data.put(apiNamesOfItemsList.get(moduleName),pdlist);
  31. dataList.add(data);
  32. param = Map();
  33. param.put("data",dataList);
  34. update = invokeurl
  35. [
  36. url :"https://www.zohoapis.com/crm/v2.1/" + moduleName + "/" + recordId.toString()
  37. type :PUT
  38. parameters:param + ""
  39. connection:"（手順5のコネクション名をここに追記ください）"
  40. ];
  41. info update;
カスタムボタンの場合は最後に return ""; を追記ください

3. テスト例

見積書の帳票サブフォームのカスタム項目「単位」(unit)の列に「個」という値を入れる

＜更新前＞


＜関数のコンソール＞


＜更新後＞