从Zoho Subscriptions获取记录
概述
使用 Zoho Creator 中的 zoho.subscriptions.getList() Deluge 任务,您可从在 Zoho Subscriptions 的受支持模块中提取记录。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。在需要时使用此任务提取客户详细信息、交易详细信息、订阅详细信息等。例如,在 Zoho Creator 中执行“表单动作”,以便一次性提取和查看您机构的所有交易详细信息。
支持的模块
- 客户
- 订阅
- 托管页面
- 活动
- 交易
语法
<response> = zoho.subscriptions.getList(<module>, <orgID>, <per_page>, <page>);
其中,
<response>是作为响应返回的映射变量。它包含已提取记录的详细信息。
<module> 是需要从中提取记录的 Zoho Subscriptions 模块的名称。例如,"Customers” 指的是客户模块。
<orgID> 指的是 Zoho Subscriptions 中指定的机构ID。若要查看您的机构ID,请点击 Zoho Subscriptions 主页右上角的<您的机构名 >> 管理机构。点击此处以了解有关机构ID 的更多信息。
<per_page> 是要在每个页面检索的记录数。
<page> 是应检索的页面的索引编号。
注:
- 除 <per_page> 和 <page> 之外,上面列出的所有参数都是必需的。
示例
1) 使用 Zoho Creator 表单从 Zoho Subscriptions 提取交易详细信息
在此示例中,我们通过将代码添加到 Zoho Creator 表单并提交表单来提取交易详细信息。表单包含“模块名称”和“机构ID”字段。在提交表单时,使用提交的数据在 Zoho Subscriptions 中创建记录。
- 将以下脚本添加在 Zoho Creator 表单的“成功时”部分
response = zoho.subscriptions.getList(input.Module_Name, input.Org_ID);
- 提交表单将会从指定的模块和机构ID 提取所有记录。
其中,
"input.Module_Name” 和 "input.Org_ID" 指的是 Zoho Creator 表单字段。
响应格式
下面是由 Zoho Subscriptions 返回至 Zoho Creator 的响应格式:
{
"message":"success",
"transactions":[
{
"amount":1000,
"status":"sent",
"reference_id":"INV-000002",
"type":"invoice",
"date":"2015-03-10",
"transaction_id":"115888000000046015"
},
{
"amount":100,
"status":"sent",
"reference_id":"INV-000001",
"type":"invoice",
"date":"2015-03-10",
"transaction_id":"115888000000047015"
}
],
"page_context":{
"per_page":200,
"sort_column":"date",
"has_more_page":false,
"page":1,
"applied_filter":"TransactionType.All",
"sort_order":"D"
},
"code":0
}
如果为了某种原因,执行失败,则错误响应将为以下格式:
Error Response for - Module Name misspelt