form.handleinserts
功能说明
描述
通过句柄的方式，批量插入数据到数据库中（支持附件与图片类型字段的字段操作），此方式支持事务操作。
支持部分mysql函数，请查看文档【支持的SQL函数】
函数原型
form.handleinserts(hd,formAlias,datas,submitter="")参数
| 名称 | 类型 | 描述 |
|---|---|---|
| hd | 整型 | 通过 form.open() 得到的句柄 |
| formAlias | 字符型 | ： 表单的别名，可以在表单设计界面中的”表单属性”中获取（支持跨应用操作数据，格式为："appid@表别名"） |
| datas | 数组：列表型 | ： 需要插入的多行数据（最多支持500条数据） |
| submitter | 字符型 | 数据提交人的userid，默认为空表示为当前云应用的默认用户 |
返回值
| 类型 | 描述 |
|---|---|
| 整型 | 执行成功返回执行sql语句影响到的行数 执行失败返回-1（失败时不会回滚事务，因为是句柄操作，事务回滚由用户控制，但是记录错误信息） 条件不匹配导致插入无效时返回0 |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1300 | 参数不是数组类型 |
| 1306 | 数组中有元素不是索引数组 |
| 1321 | 数据大小超出限制 |
| 1313 | 参数非法 |
| 1305 | 参数不是关联数组 |
| 1506 | 连接数据库失败 |
| 1502 | 取表单字段失败 |
| 1514 | 系统字段,不能进行操作 |
| 1594 | 不允许操作回收站的表单 |
| 1524 | 数据不能为空 |
| 1504 | 不存在的字段 |
| 1514 | 系统字段,不能进行更新操作 |
| 1583 | 非法的字段类型 |
| 1582 | 非法的表达式 |
| 1533 | 数据库执行失败 |
| 1539 | 非法的属性值 |
| 1586 | 文件不存在 |
| datas | 更新数据 |
| wheres | 表单查询条件 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
hd=form.open()
print(hd)
for i in range(0,10):
datas={}
datas["$单行文本"]="单行文本 "+str(i)
datas["$多行文本"]="多行文本 "+str(i)
alls=[datas,datas,datas] # 组合成多行数据
if(form.handleinserts(hd,"测试表单",alls)==-1):
error=getlasterror(1)
print("error:"+str(error)+"\t"+str(i))
break
form.close(hd)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无