在Salesforce中创建记录

目录

 概述

salesforce.sales.create() 任务用于直接从 Zoho Creator 应用程序将记录添加到您的 Salesforce 帐户中的任何受支持模块。例如，您可为销售创建线索、创建预期销售的联系人、为这些销售创建客户或市场活动等。若要将 Zoho Creator 与 Salesforce 连接，从设置 - 连接页面添加新连接。 

 支持的模块

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

 语法

<salesforceResponse> = salesforce.sales.create(<salesforceConnectionName>, <salesforceModuleName>, <params>);

其中，
<salesforceResponse> 是作为响应返回的映射变量。它包含新创建记录的详细信息。
<salesforceConnectionName> 指的是用于连接 Zoho Creator 和 Salesforce 的连接名称。从设置 - 连接页面创建新连接。
<salesforceModuleName> 指的是要在其中创建记录的 Salesforce 模块的名称。
<params> 是保存键值对的映射变量。映射键是标签名称，采用 Salesforce API 中指定的格式。映射值是从 Zoho Creator 应用程序提交的字段值。

 示例 - 创建记录

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

  1. 从仪表板页面选择表单。
  2. 单击设置 - 添加时 - 成功时的动作。
  3. 将脚本添加到编辑器区域。
  4. 单击保存脚本以保存脚本定义。

    // 声明映射变量以保存帐户详细信息
    Details = map();

    //将客户详情添加到映射变量
    Details.put("Name","John");
    Details.put("BillingCity","Chicago");
    Details.put("Type","Prospect");
    Details.put("Industry","Chemicals");

    //在 Salesforce 客户模块中创建连接名称为“Zoho”的客户
    salesforceResponse = salesforce.sales.create("Zoho", "Account", Details);

备注

  • 您可通过单击显示在脚本构建器右上角的自由流程脚本链接（或）使用脚本构建器中的拖放功能将脚本直接添加到编辑器区域。
  • 在上面的示例中，我们直接在报价内指定了参数值。若要从 Zoho Creator 表单提取参数值，请指定表单中使用的字段名称。例如，如果 Billing_city 是字段 Deluge 名称，应按以下格式指定键值对：("Billingcity", Billing_city)

响应格式

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

{"id":"00190000010xPIuAAM","errors":"[]","success":true}

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

{
"message":"Cannot deserialize instance of currency from VALUE_STRING value thousand at [line:1, column:2]",
"errorCode":"JSON_PARSER_ERROR"
}

 使用脚本构建器

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

  1. 从仪表板页面选择表单
  2. 单击设置 - 添加时 - 成功时的动作
  3. 单击页面右上角的脚本构建器。
  4. 将调用函数拖放到编辑器框中。 
  5. 选择集成任务。 
  6. 在“服务”中选择 Salesforce。 
  7. 在“函数”中选择创建记录。
  8. 选择“连接名称”以便与 Salesforce 连接。单击 +创建以创建新连接或从设置 - 连接页面创建新连接。
  9. 在 Salesforce 中选择所需的模块名称。
  10. 选择用于为创建请求保存键-值对的映射变量（或）单击“新建映射”为创建请求添加键-值对。 
  11. 指定响应变量，它将用于保存 Salesforce 返回的响应。
  12. 单击完成以插入调用函数任务。


在提交表单时，记录会添加到 Salesforce 中的所选模块。响应变量将包含 Salesforce 返回的响应。 

备注

  • 根据所选的模块，显示的键-值对将会不同。