从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

{"message":"Invalid URL Passed","code":5}