form.handleupdates
功能说明
描述
通过句柄的方式，批量更新表单中的已有数据（支持附件与图片类型字段的字段操作），此种方式支持事务操作。
支持部分mysql函数，请查看文档【支持的SQL函数】
函数原型
form.handleupdates(hd,formAlias,datas)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| hd | 整型 | 通过 form.open() 得到的句柄 |
| formAlias | 字符型 | 表单别名，可以在表单设计界面中的”表单属性”中获取（支持跨应用操作数据，格式为："appid@表别名"） |
| datas | 数组：列表型 | 需要更新/修改的多行数据（最多500条数据，注意这里指的是更新条件，不是对数据库的影响结果） |
返回值
| 类型 | 描述 |
|---|---|
| 整型 | 执行成功返回执行sql语句影响到的行数 执行失败返回-1（失败时不会回滚事务，因为是句柄操作，事务回滚由用户控制，但是记录错误信息） 条件不匹配导致更新无效时返回0 |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1409 | 表单数据库的操作句柄不存在 |
| 1300 | 参数不是数组类型 |
| 1305 | 参数不是关联数组 |
| 1506 | 连接数据库失败 |
| 1502 | 取表单字段失败 |
| 1514 | 系统字段,不能进行操作 |
| 1594 | 不允许操作回收站的表单 |
| 1508 | 非法字段别名 |
| 1504 | 不存在的字段 |
| 1582 | 非法的表达式 |
| 1505 | 不支持的函数 |
| 1560 | 表单中没有可操作的数据，请检查参数是否正确 |
| 1587 | 查询超出范围 |
| 1533 | 数据库执行失败 |
| 1539 | 非法的属性值 |
| 1586 | 文件不存在 |
| datas | 更新数据 |
| wheres | 表单查询条件 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
字段的数值更新支持动态表达式
| 表达式类型 | 支持的运算符号 | 算式 | 示例 |
|---|---|---|---|
| 单值表达式 | ! | !数字1 | {"exp":"!$数字1"} |
| 四则运算表达式 | + - * / % | 数字1 + 数字2 | {"exp":"$数字1+$数字2"} |
| 数字1 + ABS(数字2) - 3 | {"exp":"$数字1+#ABS($数字2)*3"} |
- exp：运算表达式（$表示字段，#表示函数）
示例
def test():
# 普通数据更新
datas={}
datas["$单行文本"]="单行文本1"
datas["$多行文本"]="多行文本1"
wheres1="$单行文本='文本内容1'"
wheres2="$单行文本='文本内容2'"
alls=[{"datas":datas,"wheres":wheres1},{"datas":datas,"wheres":wheres2}] # 组合成多行数据
hd=form.open()
ret=form.handleupdates(hd,"测试表单",alls)
form.close(hd)
print(ret)
# 字段的动态表达式示例,例如:对数字字段自增+1
datas={}
datas["$数字"]={"exp":"$数字+1"}
alls=[{"datas":datas,"wheres":wheres1},{"datas":datas,"wheres":wheres2}] # 组合成多行数据
hd=form.open()
ret=form.handleupdatedatas(hd,"测试表单",alls)
form.close(hd)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无