概述

为了更加高效的处理业务，Zoho Creator 和 Zoho CRM 已集成在一起。我们在 Zoho Creator 中开发了集成任务，以便在 Zoho CRM 中执行自动操作，代替手动执行。让我们来看一个创建记录的例子。您可以在 Zoho Creator 表单中添加记录（通过提交表单）并让它同时添加到 Zoho CRM 中，而无需第二次在 CRM 中重新输入数据。这可通过使用 Zoho Creator 中的 zoho.crm.create() 任务来实现。

用例场景

比如说，我们有一个 Zoho Creator 注册表单，用户通过提交表单来表明他们对特定产品的兴趣。若要同时在我们的 Zoho CRM “线索”模块中创建线索，您可以执行 Creator 表单的“成功时”表单动作中的 zoho.crm.create() 任务。每当提交该表单时，将在 Zoho CRM 中创建一个记录，并具有相关的详细信息。有关如何执行此任务的更多详情在下面说明。

语法

<variable>=zoho.crm.create(<module_name>,<field_values>,[<duplicate_check>]);

其中，

示例 1：在 Zoho CRM 中创建线索

让我们看一个通过在 Zoho Creator 中提交表单，从而在 Zoho CRM 中创建线索的例子。假设我们有一个 Creator 表单，包括以下字段：

• 名称（单行字段类型）
• 公司名称（单行字段类型）
• 电话（数字字段类型）
• 电子邮件地址（电子邮件字段类型）
• 邮政信箱（数字字段类型）
• 国家/地区（单行字段类型）

该表单用于记录有兴趣购买产品的潜在客户的详细信息。若要同时在 Zoho CRM 线索模块中创建此记录，请在表单的添加时 -> 成功时块中添加以下脚本。

leadinfo = {"Company":input.Company_Name,"Last Name":input.Last_Name,"Phone":input.Phone,"Email":input.Email_Address,"PO Box":input.PO_Box,"Country":input.Country};

response = zoho.crm.create("Leads",leadinfo);

其中，

leadinfo

"Company" "Last Name" "Phone" "Email" "PO Box" "Country"

input.Company_Name input.Name input.Telephone input.Email_Address input.PO_Box input.Country

"Leads"

响应

示例 2：创建带有客户名称、产品列表和主题的报价

让我们看一个通过在 Zoho Creator 中提交表单，从而在 Zoho CRM 中创建报价（包含客户名称、产品列表和主题）的例子。假设我们有一个 Zoho Creator 表单，包括以下字段：

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

在提交表单时，若要同时在 Zoho CRM 报价模块中创建报价，请将以下脚本添加到 Creator 表单的添加时 > 成功时块中，然后单击保存。

quoteDetails=Map(); quoteDetails.put("Subject",input.Subject_field); quoteDetails.put("ACCOUNTID",input.CRM_ACCOUNT_ID);productsList=List:Map(); for eachproductininput.Product_Details { productDetails=Map(); productDetails.put("Product Id",product.CRM_PRODUCT_ID); productDetails.put("Quantity",product.Quantity); productsList.add(productDetails); } quoteDetails.put("Products",productsList);

response=zoho.crm.create("Quotes",quoteDetails);

其中，

quoteDetails productDetails

"Subject" "ACCOUNTID" "Product Id" "Quantity" "Products"

input.Subject_field input.CRM_ACCOUNT_ID input.Email_Address

input.Product_Details

product

product.CRM_Product_ID product.Quantity

productsList

"Quotes"

响应

示例 3：将附件上传到 Zoho CRM

比如说，我们有一个 Zoho Creator 表单用于存储线索，除了其他字段类型，还包括一个文件上传字段类型。CRM 中的附件在语法和响应中的标签名称都是 Attachment。若要在 CRM 中上传附件，可将以下脚本添加到添加时 > 成功时块中。

leadinfo={"Company":input.Company,"Last Name":input.Name,"Email":input.Email,"Attachment":input.File_upload};

response=zoho.crm.create("Leads",leadinfo);

其中，

leadinfo

"Company" "Last Name" "Email" "Attachment"

input.Company input.Name input.Email input.File_upload

"Leads"

响应

示例 4：使用联系人和客户查找在 CRM 中创建任务

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

• 所有者姓名（单行字段类型）
• 所有者 ID（数字字段类型）
• 主题（单行字段类型）
• 说明（多行字段类型）
• CRM 客户（Zoho CRM 客户字段类型）
• CRM 联系人（Zoho CRM 联系人字段类型）

若要在 CRM 中创建任务，请在表单的添加时 -> 成功时块中添加以下脚本。

taskInfo={"Task Owner":input.Owner_Name,"Subject":input.Subject,"Description":input.Description,"SEMODULE":"Accounts","SEID":input.CRM_Account_ID,"CONTACTID":input.CRM_Contact_ID};

response=zoho.crm.create("Tasks",taskInfo);

其中，

taskinfo

"Task Owner" "Subject" "Description" "SEMODULE" "SEID" "CONTACTID"

input.Owner_Name input.Subject input.Description input.CRM_Account_ID input.CRM_Contact_ID

"Accounts"

"Tasks"

响应

示例 5：在线索中添加备注

比如说我们有一个包含以下字段的 Creator 表单：

• CRM 线索（Zoho CRM 线索字段类型）
• 备注标题（单行字段类型）
• 备注说明（多行字段类型）

将以下脚本添加到表单的添加时 > 成功时块，以便将备注附加到指定线索：

notesMap={"entityId":input.Zoho_Lead_ID, "Note Title":input.Note_Title,"Note Content":input.Note_Description};

response=zoho.crm.create("Notes",notesMap);

其中，

notesMap

"entityId" "Note Title" "Note Content"

input.Zoho_Lead_ID input.Note_title input.Note_Description

"Notes"

响应

示例 6：创建事件

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

• 主题（单行字段类型）
• 事件开始时间（日期-时间字段类型）
• 事件结束时间（日期-时间字段类型）

若要在事件模块创建一个具有表单输入值的记录，将以下脚本添加到表单的添加时 > 成功时部分：

eventinfo={"Subject":input.Subject,"Start DateTime":input.Event_StartTime,"End DateTime":input.Event_EndTime };

response=zoho.crm.create("Events",eventinfo);

其中，

eventinfo

"Subject" "Start Date Time" "End Date Time"

input.Subject input.Event_StartTime input.Event_EndTime

"Events"

响应

示例 7：在自定义模块中创建记录

假设我们有一个 Zoho Creator 表单，且在 Zoho CRM 中有一个自定义模块，它们都包含以下字段：

• 名称（单行字段类型）
• 电话（数字字段类型）
• 电子邮件（电子邮件字段类型）

若要在自定义模块创建一个具有表单输入值的记录，将以下脚本添加到表单的添加时 > 成功时部分：

custominfo={"Name":input.Name,"Phone":input.Phone,"Email":input.Email };

response=zoho.crm.create("CustomModule1",custominfo);

其中，

custominfo

"Name" "Phone" "Email"

input.Name input.Phone input.Email

"CustomModule1"

响应

响应格式

返回的响应是如下格式：

若要获取新创建记录的 ID，请执行以下脚本：

currentid=response.get("Id").toLong();

如果不管因为什么原因导致记录创建失败，返回以下格式的失败响应。如需了解有关错误代码的更多信息，请单击此处。

限制

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

脚本构建器

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

相关链接

• 若要提取指定的键所映射到的字符串值，请使用 get()
• 若要从提取的记录中获取值，请使用 getJSON()