从 Zoho Desk 提取记录

目录

获取记录

zoho.support.getRecords() 任务用于从 Zoho Desk 的任何受支持模块将记录提取到 Zoho Creator 应用程序。

支持的模块

  • 工单
  • 客户
  • 联系人
  • 合同

语法

<response> = zoho.support.getRecords(<moduleName>, <portal>, <department>, <fromIndex>, <toindex>);

其中,
<response> 是 list:map() 数据类型的响应,由 Zoho Desk 返回。
<moduleName> 是需要从中提取记录的 Zoho Desk 模块的名称。例如,“Requests”指的是工单模块。Creator 支持的 Zoho Desk 模块是“工单”、“客户”、“联系人”和“合同”。
<portal> 是 Zoho Desk 门户的名称,<department> 指的是门户中需要从中提取记录的部门。
<fromIndex>(可选) - 默认值 - 1
<toIndex>(可选)默认值 - 20 

注:

  • 上面列出的所有参数都是必需的,From Index 和 To Index 除外。如果未使用 From Index 和 To Index 参数或仅使用了其中任意一个,则默认将仅提取 20 个记录。使用 From Index 和 To Index 参数一次最多可提取 200 个记录。 

示例

response = zoho.support.getRecords("Requests", "zohotest", "database"); // 提取所有记录
response = zoho.support.getRecords("Requests", "zohotest", "database", 3, 8); // 提取索引 3 和 8 之间的所有记录

其中,
response 是 list:map() 数据类型的响应,由 Zoho Desk 返回。
Requests 是需要从中提取记录的 Zoho Desk 模块的名称。
zohotest 是 Zoho Desk 门户的名称,database 指的是门户中需要从中提取记录的部门。
数字 3 和 8 表示开始索引结束索引

响应格式

Zoho Desk 返回的响应将为下面给出的格式:

{
"Phone":"null",
"Subject":"null",
"Contact Name":"Max",
"CASEID":"60922000000055001",
"Request Id":"102",
"CONTACTID":"60922000000055002",
"DEP_ID":"60922000000006907",
"Email":"max@zillum.com",
"Ticket Id":"102",
"Department":"testing",
"Due Date":"null",
"URI":"/support/testing/ShowHomePage.do#Cases/dv/9042969c7524123f408f97465efbb15242acf79f93f757e8"
},
{
"Phone":"1 888 900 9646",
"Subject":"Welcome to Zoho Desk.You've got a sample Request!",
"Contact Name":"Lawrence",
"CASEID":"60922000000044038",
"Request Id":"101",
"CONTACTID":"60922000000044036",
"DEP_ID":"60922000000006907",
"Email":"support@zillum.com",
"Ticket Id":"101",
"Department":"testing",
"Due Date":"2014-04-23 07:47:00",
"URI":"/support/testing/ShowHomePage.do#Cases/dv/9042969c7524123f6b145cad551dccf983f3768859c3ef35"
}

如果由于不正确的参数值导致执行失败,则响应将为以下格式:

{"message":"Invalid User","code":"4861"