在 Zoho CRM 中搜索记录

目录上

概述

为了更加高效的处理业务，Zoho Creator 和 Zoho CRM 已集成在一起。我们在 Zoho Creator 中开发了任务，以便在 Zoho CRM 中执行自动操作，代替手动执行。例如，您可通过指定条件以在 Zoho CRM 中搜索记录并将它们填入 Zoho Creator 表单字段以采取进一步行动。您可以指定想要在其中搜索记录的模块的名称，还可指定可选的开始和结束索引编号。这可使用 Zoho Creator 中的 zoho.crm.searchRecords() 任务来实现。

用例场景

假设我们需要从自定义模块提取邮箱地址为 john@zillum.com 的所有记录。这可通过使用 searchRecords() 任务并带上指定条件和模块名称来实现。有关如何执行此任务的更多详情在下面说明。

语法

<response>=zoho.crm.searchRecords(<module_name>, <criteria>, [<from_index>],[<to_index>]);

其中，

参数  描述

<response> 

是 Zoho CRM 作为列表返回的响应。

<module_name> 

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

线索

商机

产品

联系人

市场推广

供货商

客户

服务支持

报价

销售订单

采购订单

发货单

<criteria> 

是以下格式的条件语句：(<colName> | <operator> | <colValue>)。<colName> 表示 CRM 字段标签名称，<colValue> 表示其各自的值。<operator> 包括以下项：

  • equals（或）=
  • <>
  • contains(*srcString*)
  • starts with(srcString*)
  • ends with(*srcString)
  • doesn't contain
  • <（或）is before
  • >（或）is after
  • <=（或）lesser than or equals
  • =>（或）greater than or equals

注：

  • 如果一列包含空值，zoho.crm.searchRecords 不在 <> 语句中报告它们。

<from_index>

（可选）

是需要提取的记录的开始索引。它是数字数据类型。

<to_index>

  （可选）

是需要提取的记录的末尾索引。它是数字数据类型。

注：

  • 如果只提到 fromIndex，则从提到的开始索引开始提取 20 个记录。
  • 如果只提到 toIndex，则以指定的结束索引为止提取 20 个记录。
  • 如果两个索引都未提及，则将提取前 20 个记录。
  • 在任何给定时间，最多可提取 200 个记录。

示例 1：在自定义模块中搜索带有特定邮箱地址的记录

假设我们需要从名称为 CustomModule1 的自定义模块提取邮箱地址为 john@zillum.com 的所有记录。要达到此目的，请将以下脚本添加到 Zoho Creator 表单的所需表单动作块中：

response=zoho.crm.searchRecords("CustomModule1", "(Email|=|john@zillum.com)");

其中，

响应
是 Zoho CRM 作为映射返回的响应。提取的记录将包含在响应中。在此处查看示例响应。
"CustomModule1"
是将要从中搜索记录的 Zoho CRM 自定义模块的标签名称，它是字符串数据类型。
"(Email|=|john@zillum.com)"
是条件。

示例 2：搜索以特定字母开头的客户

假设我们需要提取以字母“A”开头的所有客户。要达到此目的，请将以下脚本添加到 Zoho Creator 表单的所需表单动作块中：

response=zoho.crm.searchRecords("Accounts", "(Account Name|starts with|A*)");

其中，

响应
是 Zoho CRM 作为映射返回的响应。提取的记录将包含在响应中。在此处查看示例响应。
"Accounts"
是将要从中搜索记录的 Zoho CRM 客户模块的标签名称，它是字符串数据类型。
"(Account Name|starts with|A*)"
是条件。

响应格式

返回的响应是如下格式：

{
"SIC Code":"0",
"Account Owner":"Test",
"Employees":"0",
"Account Name":"Test",
"Account Number":"0",
"Created By":"Test",
"ACCOUNTID":"231356000000043001","MODIFIEDBY":"231356000000034003",
"Annual Revenue":"0",
"Created Time":"2010-07-06 10:15:01",
"Modified By":"Test",
"SMOWNERID":"231356000000084003",
"SMCREATORID":"231356000000034003",
"Modified Time":"2011-11-21 10:00:14"
}

限制

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

脚本构建器

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

相关链接