在Salesforce中更新记录

目录上

 概述

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

 支持的模块

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

 语法

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

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

 示例

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

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

    //获取待更新记录的 ID
    getResponse = salesforce.sales.getRecords("Zoho","SELECT Name,Id FROM Account WHERE Name='John'");
    recordListObj = getResponse.get("records");
    if (recordListObj != null)
    {
    recordList = recordListObj.toJSONList();
    id = "";
    for each recordObj in recordList
    {
    recmap = recordObj.toMap();
    id = recmap.get("Id");
    }
    if (id != "")
    {

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

    //将客户详情添加到映射变量
    Details.put("AnnualRevenue",1000);
    Details.put("Industry","Chemicals");

    //更新 Salesforce 客户模块中记录编号为 "id” 的客户
    SalesforceResponse = salesforce.sales.update("Zoho", "Account", "id", Details);
    }
    }

备注

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

响应格式

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

{"done":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. 在“函数”中选择 Update Record。
  8. 选择“连接名称”以便与 Salesforce 连接。单击 +创建 以创建新连接或从设置 - 连接页面创建新连接。
  9. 在 Salesforce 中选择所需的模块名称。
  10. 插入需要在 Salesforce 中更新记录的记录编号。
  11. 选择用于为更新请求保存键-值对的映射变量（或）单击“新建映射”为更新请求添加键-值对。 
  12. 指定响应变量，它将用于保存 Salesforce 返回的响应。
  13. 单击完成以插入调用函数任务。


在提交表单时，使用给定值在 Salesforce 中更新特定记录。响应变量将包含 Salesforce 返回的响应。