从 Zoho CRM 获取相关记录
概述
为了更加高效的处理业务，Zoho Creator 和 Zoho CRM 已集成在一起。我们在 Zoho Creator 中开发了任务，以便在 Zoho CRM 中执行自动操作，否则需要手动执行。例如，您可从 Zoho CRM 提取与特定模块相关的动态记录并将它们填入 Zoho Creator 表单字段以采取进一步行动。例如，附加到特定线索的备注或链接到特定客户的联系人可使用父模块记录的 ID 来提取。这可使用 Zoho Creator 中的 zoho.crm.getRelatedRecords() 任务来实现。
用例场景
假设我们有一个 Zoho Creator 表单，销售经理使用它来查看附加到每个线索的备注。在本例中，可执行 getRelatedRecords() 任务以基于所选线索提取并显示备注。有关如何执行此任务的进一步详情在下面说明。
语法
<response>=zoho.crm.getRelatedRecords(<module_name>, <parent_module_name>, <record_id>, [<from_index>],[<to_index>]);
其中，
| 参数 | 描述 | ||||||||||||
<response> |
是 Zoho CRM 作为列表返回的响应。 |
||||||||||||
<module_name> |
是将从其中提取记录的 CRM 模块的名称，它是字符串数据类型。例如，“备注”指的是指定父模块下面的备注模块。下面是支持的模块列表。除了这些，还有其他动态模块取决于所选的父模块。
|
||||||||||||
<parent_module_name> |
是子模块所属的模块，它是字符串数据类型。例如，“备注”可能属于“线索”父模块。下面是支持的模块列表。
|
||||||||||||
<record_id> |
是需要提取的父模块记录的 ID。它是数字数据类型。 |
||||||||||||
<from_index> （可选） |
是需要提取的记录的开始索引。它是数字数据类型。 |
||||||||||||
<to_index> （可选） |
是需要提取的记录的末尾索引。它是数字数据类型。 |
注：
- 如果只提及一个索引，它将被视为 fromIndex。在本例中，将提取 20 个记录，从指定的索引开始。
- 如果两个索引都未提及，则将提取最后添加的 20 个记录。
- 在任何给定时间，最多可提取 200 个记录。
- 索引编号从 1 开始。
示例 1：从线索模块提取备注
在本示例中，我们将通过指定记录 ID，以便从 Zoho CRM 线索记录中提取备注。假设我们有一个带 LeadID 字段（Zoho CRM 线索字段类型）的 Zoho Creator 表单。若要从所选线索提取备注，请在所需的表单动作块中添加以下脚本：
notesinfo = zoho.crm.getRelatedRecords("Notes", "Leads", input.LeadID);
其中，
notesinfo
"Notes"
"Leads"
input.LeadID
示例 2：从客户模块提取联系人
在本示例中，我们将通过指定记录 ID，以便从 Zoho CRM 客户模块的记录中提取联系人。假设我们有一个带 AccountID 字段（Zoho CRM 客户字段类型）的 Zoho Creator 表单。若要从所选客户中提取联系人，请在所需的表单动作块中添加以下脚本：
contactsinfo = zoho.crm.getRelatedRecords("Contacts", "Accounts", input.AccountID, 1, 3);
其中，
contactinfo
"Contacts"
"Accounts"
input.AccountID
1 和 3
示例 3：提取与自定义模块相关的事件
在本示例中，我们将通过指定记录 ID，从自定义模块记录中提取事件。为达到此目的，请将以下脚本添加到所需的表单动作块：
eventsinfo = zoho.crm.getRelatedRecords("Events", "CustomModule1", customModuleID, 1, 3);
其中，
eventsinfo
"Events"
"CustomModule1"
customModuleID
1 和 3
注：
- 自定义模块默认命名为 CustomModuleX（其中 X 是数字）。在语法中指定相同的自定义模块名称格式。
响应格式
返回的响应是如下格式：
"Account Name":"Creator Help Doc",
"Add to QuickBooks":"false",
"ACCOUNTID":"1560679000000413019",
"Created By":"Creator Support Test",
"MODIFIEDBY":"1560679000000084003",
"CONTACTID":"1560679000000413013",
"Created Time":"2016-03-17 16:32:00",
"Modified By":"Creator Support Test",
"SMOWNERID":"1560679000000084003",
"Contact Owner":"Creator Support Test",
"Email Opt Out":"false",
"SMCREATORID":"1560679000000084003",
"Last Activity Time":"2016-03-22 15:33:05",
"Last Name":"vds ds",
"First Name":"zxcs",
"Modified Time":"2016-03-22 15:33:05"
},
{
"Account Name":"Creator Help Doc",
"Add to QuickBooks":"false",
"ACCOUNTID":"1560679000000413019",
"Created By":"Creator Support Test",
"MODIFIEDBY":"1560679000000084003",
"CONTACTID":"1560679000000383001",
"Created Time":"2016-02-25 22:13:00",
"Modified By":"Creator Support Test",
"SMOWNERID":"1560679000000084003",
"Mobile":"56789765432",
"Contact Owner":"Creator Support Test",
"SMCREATORID":"1560679000000084003",
"Email Opt Out":"false",
"Last Activity Time":"2016-03-22 15:33:42",
"Last Name":"rtyu",
"First Name":"ret",
"Modified Time":"2016-03-22 15:33:42"
}
限制
CRM 任务仅可在专业版和超级版的帐户中执行。对于免费版帐户，请升级以使用 CRM 任务。有关更多详情，请向下滚动至价格页面上的集成和 Web 数据。
脚本构建器
您也可以使用脚本构建器来定义 zoho.crm.getRelatedRecords() 任务。导航至您的应用程序的工作流并拖放 Deluge 任务 > 其它下面的 Call Function。选择集成任务并填写必要的信息。
相关链接
- 若要提取指定的键所映射到的字符串值，请使用 get()
- 若要从提取的记录中获取值，请使用 getJSON()
- 若要将 json 字符串转换为列表格式，请使用 toJSONList()。