从 Zoho Subscriptions 检索个别记录
概述
使用 Zoho Creator 中的 zoho.subscriptions.retrieve() Deluge 任务，您可以从 Zoho Subscriptions 的受支持模块中提取个别记录，一次提取一个。您可以使用 Zoho Creator 中的不同工作流选项以使此过程自动化。需要使用此任务提取个别客户详细信息、交易详细信息、订阅详细信息等。例如，您可以在 Zoho Creator 中执行“表单动作”以提取特定客户的详细信息或客户的任何特定订阅详情。
支持的模块
- 客户
- 订阅
- 托管页面
- 活动
语法
<response> = zoho.subscriptions.retrieve(<module>, <orgID>, <ID> );
其中，
<response> 是作为响应返回的映射变量。它包含已提取记录的详细信息。
<module> 是需要从中提取记录的 Zoho Subscriptions 模块的名称。例如，"Customers” 指的是客户模块。
<orgID> 指的是 Zoho Subscriptions 中指定的机构ID。若要查看您的机构ID，请单击 Zoho Subscriptions 主页右上角的<您的机构名 >> 管理机构。点击此处以了解有关机构ID 的更多信息。
<ID> 指的是您想要提取的记录的 ID。
注：
- 上面列出的所有参数都是必需的。
示例
1) 从 Zoho Subscriptions 的托管页面模块检索记录
在此示例中，我们通过将代码添加到 Zoho Creator 表单并提交表单以从托管页面模块提取记录。表单包含字段“记录 ID”。在提交表单时，使用提交的数据从 Zoho Subscriptions 检索特定的记录。
- 将以下脚本添加在 Zoho Creator 表单的“成功时”部分
response = zoho.subscriptions.retrieve("hostedpages", "12345678", input.Record_ID);
- 提交表单将会从指定的模块和机构ID 提取指定的记录。
其中，
"hostedpages” 和 "12345678” 分别指的是模块名称和机构ID。
input.Record_ID 指的是 Zoho Creator 表单字段。
响应格式
下面是由 Zoho Subscriptions 返回至 Zoho Creator 的响应格式：
{
"custom_fields":"[]",
"message":"success",
"status":"fresh",
"hostedpage_id":"2-1a76024dc81f1bb6dd4a78d3a5c6f2b16cf56ec5a5b67151097ba494318be79b8a3668c64f1e146cd07b01e06e3e282a",
"action":"new_subscription",
"expiring_time":"2015-03-10T11:53:07+0530",
"code":0,
"created_time":"2015-03-10T10:53:07+0530",
"url":"https://subscriptions.zoho.com/hostedpage/2-1a76024dc81f1bb6dd4a78d3a5c6f2b16cf56ec5a5b67151097ba494318be79b8a3668c64f1e146cd07b01e06e3e282a/checkout"
}
如果为了某种原因，执行失败，则错误响应将为以下格式：
Error Response for - Invalid Record ID