从 Salesforce 提取记录

目录

 概述

salesforce.sales.getRecords() 任务用于从 Salesforce 帐户的任何受支持模块提取记录到 Zoho Creator 应用程序。例如，您可以从 Salesforce 模块（例如，线索、联系人、客户等）提取记录。若要将 Zoho Creator 与 Salesforce 连接，请从设置 - 连接页面添加新连接。 

 支持的模块

  • 线索
  • 联系人
  • 客户
  • 服务支持
  • 解决方案
  • 产品
  • 营销

 语法

<salesforceResponse> = salesforce.sales.getRecords(<salesforceConnectionName>, <salesforceModuleName>, <criteria>, <ColumnsToBeSelected>);

其中，
<salesforceResponse> 是作为响应返回的映射变量。它包含需要提取记录的详细信息。
<salesforceConnectionName> 指的是用于连接 Zoho Creator 和 Salesforce 的连接名称。从设置 - 连接页面创建新连接。
<salesforceModuleName> 指的是要在其中创建记录的 Salesforce 模块的名称。
<criteria> 是可选参数，系统将基于它来提取记录。条件必须为如下格式：<attribute name> = <value>。例如，"Name = 'Henry'"
<columnsToBeSelected> 是可选参数，指定了要选择的属性名称。

 示例

下面给出了从 Salesforce 客户模块提取记录的示例脚本。您可以通过将此脚本添加到所需的表单动作块，从 Zoho Creator 表单执行此脚本。例如，若要从客户模块提取记录，

  1. 从仪表板页面选择表单。
  2. 转至所需的表单动作块。
  3. 将脚本添加到编辑器区域。
  4. 单击保存脚本以保存脚本定义。

    //从 Salesforce“客户”模块返回记录列表
    SalesforceResponse = salesforce.sales.getRecords("CRM", "Account");

    //返回 Name = "Henry” 的记录列表
    SalesforceResponse = salesforce.sales.getRecords("CRM", "Account","Name = 'Henry'");

    //从 Salesforce“客户”模块返回名称 ="Henry” 的记录的名称、ID 和行业
    fieldList = List();
    fieldList.add("Name");
    fieldList.add("Id");
    fieldList.add("Industry");
    SalesforceResponse = salesforce.sales.getRecords("CRM", "Account", "Name = 'Henry'",fieldList);

备注

  • 您可通过单击显示在脚本构建器右上角的自由流程脚本链接（或）使用脚本构建器中的拖放功能将脚本直接添加到编辑器区域。

响应格式

Salesforce 返回的响应将为下面给出的格式：

{
"done":true,
"records":"[{\"Name\":\"Henry\",\"Id\":\"00190000010bZ88AAE\",\"attributes\":
{\"type\":\"Account\",\"url\":\"/services/data/v20.0/sobjects/Account/00190000010bZ88AAE\"},\"Industry\":\"Chemicals\"}]",
"totalSize":1
}

如果由于不正确的查询导致执行失败，则响应将为以下格式：

{
"message":"\nSELECT * FROM Account where Name='John'\n ^\nERROR at Row:1:Column:7\nunexpected token: '*'",
"errorCode":"MALFORMED_QUERY"
}

 使用脚本构建器

若要使用脚本构建器中的拖放功能添加脚本，

  1. 从仪表板页面选择表单。
  2. 转至所需的表单动作块。
  3. 单击页面右上角的脚本构建器。
  4. 将调用函数拖放到编辑器框中。 
  5. 选择集成任务。 
  6. 在“服务”中选择 Salesforce。 
  7. 在“函数”中选择 Get Records。
  8. 选择“连接名称”以与 Salesforce 连接。单击 +创建 以创建新连接或从设置 - 连接页面创建新连接。
  9. 在 Salesforce 中选择需要从中提取记录的模块名称。
  10. 基于将提取的记录指定条件。这是可选参数。  
  11. 指定要提取的列。这是可选参数。
  12. 指定响应变量，它将用于保存 Salesforce 返回的响应。
  13. 单击完成以插入调用函数任务。


在提交表单时，基于给定模块名称和条件从 Salesforce 提取特定记录。响应变量将包含 Salesforce 返回的响应。