从 Quickbooks 获取记录

目录

 概述

intuit.quickbooks.getRecords() 任务用于直接通过 Zoho Creator 应用程序从 QuickBooks 帐户的任何受支持模块获取记录。例如，您可从 quiockbooks 中的客户模块获取具有给定显示名称的客户列表。若要将 Zoho Creator 与 QuickBooks 连接在一起，请从设置 - 连接页面创建新连接。 

 支持的模块

  • 客户
  • 供货商
  • 产品
  • 发货单
  • 客户
  • 员工
  • 部门

 语法

<quickbooksResponse> = intuit.quickbooks.getRecords(<quickbooksConnectionName>, <quickbooksModuleName>,<quickbooks CompanyId> , <criteria>, <columnsToBeSelected>);

其中，
<quickbooksResponse> 是作为响应返回的映射变量。它包含新创建记录的详细信息。
<quickbooksConnectionName> 指的是用于连接 Zoho Creator 和 Quickbooks 的连接名称。从设置 - 连接页面创建新连接。
<quickbooksModuleName> 指的是要在其中创建记录的 Quick Books 模块的名称。
<quickbooksCompanyId> 指的是由 Quickbooks 为每个帐户生成的唯一 编号。您可在 Quickbooks 帐户您的公司 -> 帐户和设置 -> 账单和订购 -> 公司 Id 下面找到。
<criteria> 是可选参数，记录将基于该参数来提取。条件必须为如下格式：<attribute name> = <value>。例如，"DisplayName = 'Henry'"
<columnsToBeSelected> 是可选参数，它指定待选择的属性名称。
请参阅 Quickboks API 指南以了解为每个模块指定的属性。 

 示例 - 从 Quickbooks 获取记录

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

//返回客户模块中的所有记录
getResponse = intuit.quickbooks.getRecords("Zoho", "Customer", "1241802285");

//返回显示名称为“Henry”的记录列表
getResponse = intuit.quickbooks.getRecords("Zoho", "Customer", "1241802285", "DisplayName='Henry'");

//返回显示名称为“Henry”的记录的 FamilyName 和 编号 

fieldList = List();

fieldList.add("FamilyName");
fieldList.add("Id");
getResponse = intuit.quickbooks.getRecords("Zoho", "Customer", "1241802285", "DisplayName = 'Henry'",fieldList);

 示例 - 获取记录编号

queryResponse = (getResponse .get("QueryResponse")).toMap();
queryResponseList = queryResponse.get("Customer").toJSONList();

//迭代列表中的每个值

for each rec in queryResponseList
{
recMap = rec.toMap();
id = recMap.get("Id");
info id ;
}

备注

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

 响应格式

下面给出了 Quickbooks 为 getRecords 任务返回的响应。
intuit.quickbooks.getRecords("Zoho", "Customer", "1241802285", "DisplayName='Henry'");

{
“time":"2014-08-06T04:45:08.234-07:00",
"QueryResponse":"{" Customer":"[{" ShipAddr":{
"Line3":"123 street",
"Long":"-122.0960826",
"Line2":"Building 1",
"Line1":"Intuit",
"Lat":"37.4306346",
"Id":"7"
},
"PreferredDeliveryMethod":"Email",
"BalanceWithJobs":0,
"DisplayName":"Henry",
"FullyQualifiedName":"Henry",
"BillWithParent":false,
"Job":false,
"Active":true,
"MetaData":{
"CreateTime":"2014-08-01T02:29:29-07:00",
"LastUpdatedTime":"2014-08-01T02:35:45-07:00"
},
"Taxable":false,
"BillAddr":{
"Long":"-77.02225539999999",
"Line1":"450 7th StreetnWashington DC",
"Lat":"38.8958239",
"Id":"6"
},
"domain":"QBO",
"SyncToken":"1",
"PrintOnCheckName":"Hudson",
"CurrencyRef":{
"name":"Indian Rupee",
"value":"INR"
},
"Id":"5",
"FamilyName":"Hudson",
"Balance":0,
"sparse":false
}
]","maxResults":1,
"startPosition":1
}
}

如果为了某种原因，执行失败，则响应将为以下格式：

ERROR RESPONSE - For Invalid Parameter Name

{
"Error":"[{
"Detail":"Property Name:Can not instanti specified is unsupported or invalid",
"Message":"Request has invalid or unsupported property",
"code":"2010"
}]"
}

 使用脚本构建器

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

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


响应变量将包含由 Quickbooks 以列表格式返回的响应。