记录删除——CSV格式
百会Creator的CSV
- RPC Web API支持客户端通过HTTP POST方法在百会Creator表单中删除数据。所有满足约束条件的数据将被删除。您可以使用"AND"或"OR"操作符指定多重的标准。同时您将从调用的方法中得到一个格式化的XML回复。
哪些人可以删除记录？
只有拥有有效的API key的应用程序拥有者可以在百会Creator表单中删除记录。
要求的网址
下面一行为以CSV格式书写的用于添加、删除、更新记录要求加入的链接网址：
http://creator.zoho.com/api/csv/<ownerName>/write/apikey=[APIKEY]&ticket=[Ticket]
要求的参量
要求的参量为一系列确定的用逗号隔开的值，格式如下：
<Application
Name>,<Form Name>,<Operation Type>
<Criteria Column Name >,<operator>,<value>,<AND or OR>
上例中，
<Application
Name> ：将有记录被删除的应用的名称。
<Form Name> ：将有记录被删除的表单的名称。
<Operation Type> ：删除数据的操作类型是"Delete"。
<Criteria Column Name > ：用于确定被删除数据标准的名称。
<operator> ：用于标准中使用的操作符。csv格式支持以下操作符：
- Equals
- NotEqual
- Before
- After
- LessThan
- GreaterThan
- LessThanOrEqual
- GreaterThanOrEqual
- Contains
- NotContains
- StartsWith
- EndsWith
<AND or OR> ：AND或OR操作符，用以确定多个标准。
注意事项：
- 用于表单名称、项目名称和应用名称的Deluge脚本名称必须精确确定。请参见http://creator.zoho.com/api/reference查看清单，其中包含已开发的应用、应用中的表单名称和项目名称，以及相应的deluge命名。
- 设定的标准以英文句号(.)表示结束。
- 各行之间需要加添一行空行用以区分开。
- 项目值若带有特殊字符，请加双引号标注。
- 复合参量必须使用双引号注明，并用逗号隔开。
- equals, not equal to, before, after等操作符也可以用于日期项目中。
表单示例
(
POST 格式方法
)
<formmethod="POST" action="http://creator.zoho.com/api/csv/write/apikey=[APIKEY]&ticket=[Ticket]">
<input type="hidden" name="CSVString" value="CSV String in the format as specified in the Request format">
<input type="submit" value="Sumit CSV String">
</form>
请求示例
以下的请求示例均使用了上述的介绍方法：
a. 单独标准的请求示例：
Sample,Employee_Form,Delete
Name,equals,"John",.
b. 使用AND操作符形成多重标准的请求示例：
Sample,Employee_Form,Delete
Name,equals,"John",AND
Joining_Date,equals,15-Aug-2007,.
应答格式
应答参数各值由逗号隔开，每行参量精确定义如下：
<Form
Name>,<Operation>
<Name of
the form>,<delete>
<Status><Criteria>
<Success/Failure><Criteria>
如果在应答格式中出现错误，对应的错误代码及错误信息将显示出来。请参考此专题Error codes and
description，获悉错误代码显示列表相关信息。
当记录添加进数据库后，应答信息将显示数据及提示信息如"Success"。
应答示例
以下为应用上述方法完成的一份应答示例：
Form Name, Operation
dateForm,delete
Status,Criteria
Success,[Name EQUAL jose]
