从 Zoho Books 提取记录

目录

 概述

使用 Zoho Creator 中的 zoho.books.getRecords() Deluge 任务，您可以从 Zoho Books 提取相关记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。使用搜索关键词从 Zoho Books 中的联系人、发货单和付款模块提取记录。例如，使用搜索关键词在 Zoho Creator 中执行“表单动作”以便从 Zoho Books 提取联系人。或在 Zoho Creator 中配置计划程序以从 Zoho Books 提取特定发货单。

 支持的模块

  • 联系人
  • 发货单
  • 客户付款
  • 产品
  • 报价单
  • 经常性发货单
  • 费用

 语法

<response> = zoho.books.getRecords (<module>, <orgID>,<search>);

其中，
<response> 是作为响应返回的映射变量。它包含新创建记录的详细信息。

<module> 是需要从中更新记录的 Zoho Books 模块的名称。例如，“Contacts”指的是联系人模块。Creator 支持的 Zoho Books 模块是“联系人”、“发货单”和“客户付款”。

<orgID> 指的是在 Zoho Books 中指定的您机构编号。若要查看您的机构编号，请单击 Zoho Books 主页右上角的<您的组织名 >> 管理组织。

<Search> 包括 Zoho Books 模块中的标签名称，以及我们搜索的相应关键词。例如，contact_name=zoho。在这里，contact_name 是 Zoho Books 模块中的标签名称，“zoho”是它的值，使用这个值来执行搜索。

注：

  • 上面列出的所有参数都是必需的。  
  • “startswith”和“contains”是可在搜索参数中使用的两个额外变体。例如，contact_name_startswith 和 contact_name_contains。

 示例

1) 使用搜索从 Zoho Books 提取联系人

在本示例中，通过将代码添加到 Zoho Creator 表单来提取 Zoho Books 联系人模块的记录。在表单提交时，会提取与指定搜索关键词相关的记录。

  • 将以下脚本添加在 Zoho Creator 表单的“成功时”部分
response = zoho.books.getRecords("contacts", "12345678","contact_name=john");
  • 提交表单将从 Zoho Books 提取其 contact_name 为“John”的记录。

其中，
contacts 是 Zoho Books 模块的名称，记录将需要从中提取。
12345678是示例机构编号。使用您的机构编号替换它。
contact_name=john 是搜索参数，其中 contact_name 是 Zoho Books 模块中的标签名称，“john”是它的值，使用这个值来执行搜索。

 响应格式

以下代码用于 getRecords() 任务，

response = zoho.books.getRecords("contacts", "35201411","contact_name=Zoho Creator"); 
info response;

生成以下响应格式，

{
"message":"success",
"page_context":{
"search_criteria":[
{
"search_text":"Zoho Creator",
"comparator":"equal",
"column_name":"contact_name"
}
],
"per_page":200,
"sort_column":"contact_name",
"has_more_page":false,
"page":1,
"report_name":"Contacts",
"applied_filter":"Status.All",
"sort_order":"A"
},
"code":0,
"contacts":[
{
"phone":"",
"currency_id":"1782000000000099",
"payment_terms":0,
"contact_id":"1782000000045001",
"status":"active",
"payment_terms_label":"Due On Receipt",
"is_linked_with_zohocrm":false,
"outstanding_receivable_amount":0,
"first_name":"",
"unused_credits_payable_amount":0,
"source":"api",
"email":"",
"unused_credits_receivable_amount":0,
"company_name":"",
"outstanding_payable_amount":0,
"last_modified_time":"2015-02-18T15:01:39+0530",
"last_name":"",
"contact_name":"Zoho Creator",
"contact_type":"none",
"created_time":"2015-02-18T15:01:39+0530",
"currency_code":"INR",
"mobile":""
}
]
}

如果给定查询未生成任何匹配的结果，则响应将为以下格式：

Response for - No match for the given query

{
"message":"success",
"page_context":{
"search_criteria":[
{
"search_text":"ParkaS",
"comparator":"equal",
"column_name":"contact_name"
}
],
"per_page":200,
"sort_column":"contact_name",
"has_more_page":false,
"page":1,
"report_name":"Contacts",
"applied_filter":"Status.All",
"sort_order":"A"
},
"code":0,
"contacts":[

]
}