通过 ID 从 Salesforce 获取记录

目录

 概述

salesforce.sales.getRecordById() 任务用于通过指定记录的唯一编号，从 Salesforce 帐户中任何支持的模块获取记录。例如，您可从 Salesforce 中的线索模块获取具有给定记录编号的线索记录。若要将 Zoho Creator 与 Salesforce 连接在一起，请从设置 - 连接页面创建新连接。 

 支持的模块

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

 语法

<salesforceResponse> = salesforce.sales.getRecordById(<salesforceConnectionName>, <salesforceModuleName>, <recordID>);

其中，
<salesforceResponse> 是作为响应由 Salesforce 返回的映射变量。它包含已提取记录的详细信息。
<salesforceConnectionName> 指的是用于将 Zoho Creator 与 Salesforce 连接在一起的连接名称。从设置 - 连接页面创建新连接。
<salesforceModuleName> 指的是要在其中提取记录的 Salesforce 模块的名称。
<recordID> 是 Salesforce 中需要提取的记录编号。

 示例

下面是一个示例脚本，说明如何从 Salesforce 客户模块获取具有给定记录编号的记录。您可以通过将此脚本添加到所需的表单动作块，从 Zoho Creator 表单执行此脚本。例如，若要基于记录编号从客户模块提取记录，

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

      salesforceResonse = salesforce.sales.getRecordById("Zoho", "Account", "00190000010bRIMAA2");
      //返回 recordID = "00190000010bRIMAA2” 的记录列表

备注

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

 响应格式

Quickbooks 返回的响应将为下面给出的格式。

{ "UpsellOpportunity__c":null,
"ParentId":null,
"Phone":null,
"TickerSymbol":null,
"SLAExpirationDate__c":null,
"Type":null,
"OwnerId":"00590000002l9KTAAY",
"LastModifiedDate":"2014-08-06T09:58:31.000+0000",
"ShippingState":null,
"AnnualRevenue":1000,
"BillingState":null,
"NumberofLocations__c":null,
"LastActivityDate":null,
"NumberOfEmployees":null,
"BillingPostalCode":null,
"SLASerialNumber__c":null,
"SystemModstamp":"2014-08-06T09:58:31.000+0000",
"ShippingCity":null,
"Description":null,
"BillingCountry":null,
"Site":null,
"ShippingCountry":null,
"LastModifiedById":"00590000002l9KTAAY",
"Website":null,
"ShippingStreet":null,
"AccountNumber":null,
"Fax":null,
"BillingStreet":null,
"SLA__c":null,
"Active__c":null,
"CustomerPriority__c":null,
"MasterRecordId":null,
"Name":"feb",
"BillingCity":null,
"Rating":null,
"CreatedById":"00590000002l9KTAAY",
"CreatedDate":"2014-08-06T09:58:31.000+0000",
"IsDeleted":false,
"Id":"00190000010xPIuAAM",
"Ownership":null,
"attributes":"{" type":"Account",
"url":"/services/data/v20.0/sobjects/Account/00190000010xPIuAAM"
}","ShippingPostalCode":null,
"Sic":null,
"Industry":"Chemicals"
}

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

{
"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 Record By ID。
      8. 选择“连接名称”以便与 Salesforce 连接。单击 +创建 以创建新连接或从设置 - 连接页面创建新连接。
      9. 选择 Salesforce 中的模块名称。
      10. 插入需要提取的记录的记录编号。
      11. 指定响应变量，它将用于保存 Salesforce 返回的响应。
      12. 单击完成以插入调用函数任务。


在提交表单时，基于给定记录编号从 Salesforce 提取特定记录。响应变量将包含 Salesforce 返回的响应。