在Zoho CRM 中更新记录

目录上

概述

为了更加高效的处理工作，Zoho Creator 和 Zoho CRM 已集成在一起。我们在 Zoho Creator 中开发了任务，以便在 Zoho CRM 中执行自动操作，而不是手动执行。例如，您只需在 Zoho Creator 中提交带有相关详细信息的表单，即可更新 Zoho CRM 中的记录。这可使用 Zoho Creator 中的 zoho.crm.updateRecord() 任务来实现。

用例场景

假设我们有一个存储线索信息的 Zoho Creator 表单。若要更新 Zoho CRM 中的现有线索详情，您可执行 zoho.crm.updateRecord() 任务。当使用更新的信息提交表单时，指定的记录会更新。有关如何执行此任务的更多详情在下面说明。

语法

<response>=zoho.crm.updateRecord(<module_name>, <record_ID>, <New values as map object>);

其中，

参数  描述

<response> 

是 Zoho CRM 作为映射返回的响应。

<module_Name> 

是将在其中更新记录的 CRM 模块的名称，它是字符串数据类型。下面是支持的模块列表。

线索

商机

产品

联系人

市场推广

供货商

客户

服务支持

报价

销售订单

采购订单

发货单

<record_Id>

是需要更新的记录的 id，它是数字数据类型。

<New values as map object>

具有更新值的键值对 

示例 1：通过指定线索记录 ID 来更新此线索

让我们假定我们的 Zoho Creator 表单包含以下字段：

  • 线索（Zoho CRM 线索字段类型）
  • 公司名称（Zoho CRM 线索字段类型）
  • 名称（单行字段类型）
  • 电话号码（数字字段类型）
  • 邮箱地址（电子邮件字段类型）

将以下脚本添加到添加时 > 成功时块以更新指定线索 ID 的详细信息。

leadinfo = {"Company":input.Company_Name, "Last Name":input.Name, "Phone":input.Telephone, "Email":input.Email_Address}; response = zoho.crm.updateRecord("Leads",input.Lead_ID,leadinfo);

其中，

leadinfo
包含键值对，其中键是 Zoho CRM 标签名称，值是更新的字段输入。
响应
是 Zoho CRM 作为映射返回的响应。提取的记录将包含在响应中。在此处查看示例响应。
"Leads"
是将要从中更新记录的 Zoho CRM 线索模块的标签名称，它是字符串数据类型。
input.Lead_ID
指的是表单字段（线索）输入。

示例 2：通过指定报价 ID 来更新包含产品详细信息的报价

假设我们有一个 Zoho Creator 表单，它用于存储报价及其产品详细信息。表单包含以下字段：

  • 主题（单行字段类型）
  • 客户（Zoho CRM 客户字段类型）
  • 产品详细信息（子表单字段类型）包含产品（Zoho CRM 产品字段类型）和数量（数字字段类型）。

将以下脚本添加到表单的添加时 > 成功时部分以更新现有报价记录：

quoteDetails = map(); quoteDetails.put("Subject", input.Subject); quoteDetails.put("ACCOUNTID", input.Account_ID); productsList = List:Map(); for each product in input.Product_Details { Product_Details = map(); Product_Details.put("Product Id", product.Product_ID); Product_Details.put("Quantity", product.Quantity); productsList.add(productDetails); } quoteDetails.put("Products", productsList); response = zoho.crm.updateRecord("Quotes", QuotesID, quoteDetails);

其中，

quoteDetailsproductDetails
是 Zoho CRM 作为映射返回的响应。提取的记录将包含在响应中。在此处查看示例响应。
"Subject" "ACCOUNTID" "Product Id" "Quantity" "Products"
是字符串数据类型的 Zoho CRM 字段标签。
input.Subject input.ACCOUNT_ID
是 Zoho Creator 字段输入。
input.Product_Details
是子表单字段输入。
product
表示每个子表单条目或记录。
product.Product_ID product.Quantity
是每个子表单条目或记录的唯一子表单字段输入。
productsList
是包含子表单字段输入映射值的列表变量。
"Quotes"
是将在其中更新记录的 CRM 模块，它是字符串数据类型。
响应
是 Zoho CRM 作为映射返回的响应。在此处查看示例响应。

示例 3：更新客户中的附件

假设我们有一个带有文件上传字段的表单。若要更新 Zoho CRM 客户模块中的附件，请在表单的添加时 -> 成功时部分添加以下脚本。

response = zoho.crm.attachFile(("Accounts"), 1560679000000413019, input.File_Upload);

其中，

响应
是 Zoho CRM 作为映射返回的响应。在此处查看示例响应。
响应
是 Zoho CRM 作为映射返回的响应。提取的记录将包含在响应中。在此处查看示例响应。
"Accounts"
表示 Zoho CRM 中的客户模块，它是字符串数据类型。
1560679000000413019
是客户模块中的记录的 ID，附件在其中更新。
input.File_Upload
指的是表单中的“文件上传”字段的输入值。

响应格式

返回的响应是如下格式：

{"message":"Record(s) updated successfully","Created Time":"2016-03-17 12:35:00","Modified By":"Creator Support Test","Id":"1560679000000413009","Modified Time":"2016-03-28 12:37:44","Created By":"Creator Support Test"}

 

限制

CRM 任务仅可在专业版和超级版下的帐户中执行。对于免费版下的帐户，请升级以使用 CRM 任务。有关更多详情，请向下滚动至价格页面上的集成和 Web 数据。

脚本构建器

您也可以使用脚本构建器来定义 zoho.crm.updateRecord() 任务。导航至您的应用程序的工作流并拖放 Deluge 任务 > 其它下面的 Call Function。选择集成任务并填写必要的信息。

相关链接

  • 若要提取指定的键所映射到的字符串值，请使用 get()
  • 若要从提取的记录中获取值，请使用 getJSON()
  • 若要将 json 字符串转换为列表格式，请使用 toJSONList()。