form.handleselectdata
功能说明
描述
通过句柄的方式，查询指定表单存放在数据库中的数据。（支持图片/附件/手写签名的文件操作）
支持部分mysql函数，请查看文档【支持的SQL函数】
函数原型
form.handleselectdata(hd,formAlias,fields,wheres=None,type=0)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| hd | 整型 | 通过 form.open() 得到的句柄 |
| formAlias | 字符型 | 表单别名，可以在表单设计界面中的”表单属性”中获取（支持跨应用取数据，格式为："appid@表别名"） |
| fields | 数组：列表型 | 查询字段，为表单的字段的别名，可以在表单设计的字段属性中获取，支持表单字段和子表单字段同时查询（子表单字段只能属于同一个子表单），["*"]表示查询所有字段。具体参考示例 |
| wheres | 数组：字典型 | 查询条件，条件为数组格式，默认为空具体格式请点击 查询条件和排序规则 |
| type | 整数型 | 默认为0 0：以列名的方式返回查询结果的全部数据 1：以索引的方式返回查询结果的全部数据 2：以列名的方式返回查询到的第一条记录 3：以索引的方式返回查询到的第一条记录 4：以集合的方式返回查询结果的全部数据（集合特性默认去重） |
- wheres 数据格式：
{ "ORDER":[ { "name":"单行文本", "mode":"desc" }, { "name":"多行文本", "mode":"asc" } ], "AND":[ { "name":"单行文本", "val":"111", "exp":"like" }, { "name":"单行文本", "val":[ "111", "222" ], "exp":"between" } ], "GROUP":[ "单行文本" ], "LIMIT":[ 0, 20 ] }
| 名称 | 描述 |
|---|---|
| AND | 指定where元素的连接方式（OR的格式和AND相同，具体格式请点击 |
| ORDER | 指定结果集的排序方式 |
| GROUP | 指定结果集的过滤字段 |
| LIMIT | 指定结果集的过滤行数 |
| name | 字段别名 |
| val | 字段对应的值，可以为单个或多个值 |
| exp | 连接字段 name 和 val 的表达式 |
| mode | 指定排序规则，"asc" 表示顺序排列，"desc" 表示倒序排列 |
返回值
| 类型 | 描述 |
|---|---|
| 数组：列表型、字典型、集合型 | 根据参数中的type类型返回不同的格式的数组 |
| 参数 | 类型 | 描述 |
|---|---|---|
| 0 | 列表型 | 以列名的方式返回查询结果的全部数据 |
| 1 | 列表型 | 以索引的方式返回查询结果的全部数据 |
| 2 | 字典型 | 以列名的方式返回查询到的第一条记录 |
| 3 | 列表型 | 以索引的方式返回查询到的第一条记录 |
| 4 | 集合型 | 以集合的方式返回查询结果的全部数据（集合特性默认去重） |
- 数据格式：
[ { "deleteTime":"", "createTime":"2019-01-05 15:05:07", "updateTime":"2019-01-11 11:00:38", "单行文本":"abc", "多行文本":"def", "creator":{ "nickname":"bobo", "id":"547a48c50eccde5ac8c0883b" }, "deleter":"", "_id":"5e5057a78d478a699e99a7d8" }, { "deleteTime":"", "createTime":"2019-01-11 11:00:49", "updateTime":"2019-01-11 11:00:49", "单行文本":"abc2", "多行文本":"def2", "creator":{ "nickname":"bobo", "id":"547a48c50eccde5ac8c0883b" }, "deleter":"", "_id":"58d0e3930170170b8953877e" } ]
| 名称 | 描述 |
|---|---|
| _id | 单条数据id |
| creator | 数据的创建者 |
| createTime | 数据的创建时间 |
| deleter | 数据的删除者 |
| deleteTime | 数据的删除时间 |
| nickname | 数据的创建者对应的昵称 |
| id | 数据的创建者对应的userid |
子表单字段和外层字段同时查询时的结果集:
- 注意当子表单数据条数 > 外层数据条数时将自动填充数据补齐空白部分，如下图所示：
原始数据为： |单行文本|单行文本_子表单| |-|-| |11|33| | |44| 查询结果为： |单行文本|单行文本_子表单| |-|-| |11|33| |11|44|
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1409 | 表单数据库的操作句柄不存在 |
| 1300 | 参数不是数组类型 |
| 1305 | 参数不是关联数组 |
| 1313 | 参数非法 |
| 1506 | 连接数据库失败 |
| 1502 | 取表单字段失败 |
| 1594 | 不允许操作回收站的表单 |
| 1560 | 表单中没有可操作的数据，请检查参数是否正确 |
| 1302 | 赋值失败 |
| 1513 | 条件字段不为关联数组 |
| 1508 | 非法字段别名 |
| 1504 | 不存在的字段 |
| 1582 | 非法的表达式 |
| 1505 | 不支持的函数 |
| 1587 | 查询超出范围 |
| 1504 | 不存在的字段 |
| 支持的sql函数（只支持大写） | COUNT、MAX、MIN、AVG、SUM、NOW |
| 支持的sql比较关键字（只支持大写） | AND、OR、ORDER、GROUP（group by）、LIMIT |
其他：
- 所有表单查询api的结果集行数最多返回500条数据。
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
# name(字段别名), val(字段对应的值), exp(条件表达式) 为条件专有名称
# where组合表达式格式为: AND = [{"name" :"单行文本","val" :"单行文本1","exp" :"="},{"name" :"单行文本2","val" :"单行文本2","exp" :"="}]
#当条件只有1个时写法为：AND=[{"name":"单行文本"，"val":"单行文本1","exp":"="}]
# 普通字段查询
# 查询全部数据使用 ["*"]
hd=form.open()
fields=["单行文本"]
res=form.handleselectdata(hd,"测试表单",fields)
# 普通字段和子表单字段同时查询
where={"AND":[{"name":"单行文本","val":["11"],"exp":"in"},{"name":"单行文本_子表单","val":["33","44"],"exp":"in"}]}
res=form.handleselectdata(hd,"测试表单",["单行文本","单行文本_子表单"],where)
print(res)
# select `单行文本` from `测试表单` LIMIT 0,500
fields=["单行文本"]
_limit=[0,500]
where={"LIMIT"=_limit}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
# select MAX(`单行文本`) from `测试表单`
# #开头表示sql函数, 支持的函数名称详情见备注
fields=["#MAX(单行文本)"]
res=form.handleselectdata(hd,"测试表单",fields)
print(res)
# select `单行文本` from `测试表单` where 单行文本 IN (1,2,3) AND 单行文本1 NOT IN (4,5,6)ONDER BY 单行文本 DESC
fields=["单行文本"]
_and=[{"name":"单行文本","val":[1,2,3],"exp":"="},{"name":"单行文本1","val":[4,5,6],"exp":"NOT IN"}]
_order=[{"name":"单行文本","mode":"desc"}]
where={"ORDER":_order,"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
# select `单行文本` from `测试表单` where 单行文本1 IS NULL AND 单行文本2 IS NOT NULL
fields=["单行文本"]
_and=[{"name":"单行文本1","val":"None","exp":"="},{"name":"单行文本2","val":"None","exp":"NOT IN"}]
where={"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
# select `单行文本` from `测试表单` where 单行文本 > '单行文本1' AND 单行文本 < '单行文本2';
fields=["单行文本"]
_and=[{"name":"单行文本","val":"单行文本1","exp":">"},{"name":"单行文本","val":"单行文本2","exp":"<"}]
where={"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
# select `单行文本` from `测试表单` where 单行文本1 BETWEEN '单行文本2' and '单行文本3';
fields=["单行文本"]
_and=[{"name":"单行文本1","val":{"单行文本2","单行文本3"},"exp":"BETWEEN"}]
where={"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
# select `单行文本` from `测试表单` where (单行文本 LIKE '%文本1%') and (单行文本 LIKE '%文本2%')
fields=["单行文本"]
_and=[{"name":"单行文本","val":"%文本1%","exp":"LIKE"},{"name":"单行文本","val":"%文本2%","exp":"LIKE"}]
where={"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
#select `单行文本` from `测试表单` where (单行文本='单行文本1') or (单行文本='单行文本2')
fields=["单行文本"]
_or=[{"name":"单行文本","val":"单行文本1","exp":"="},{"name":"单行文本","val":"单行文本2","exp":"="}]
where={"OR":_or}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
#select `单行文本` from `测试` where ( 单行文本='单行文本1' AND ( 单行文本='单行文本1' OR 单行文本 !='单行文本2' ))
fields=["单行文本"]
_or=[{"name":"单行文本","val":"单行文本1","exp":"="},{"name":"单行文本","val":"单行文本2","exp":"!="}]
_and=[{"name":"单行文本","val":"单行文本1","exp":"="},"OR":_or}
where={"AND":_and}
res=form.handleselectdata(hd,"测试表单",fields,where)
print(res)
#select `单行文本` from `测试表单` where ( 单行文本='单行文本1' AND ( 单行文本='单行文本1' OR 单行文本 !='单行文本2' )) GROUP BY 单行文本,多行文本 ORDER BY 单行文本 desc,多行文本 DESC LIMIT 0,20
fields=["单行文本","多行文本"]
_or=[{"name":"单行文本","val":"单行文本1","exp":"="},{"name":"单行文本","val":"单行文本2","exp":"="}]
_and=[{"name":"单行文本","val":"单行文本1","exp":"="},"OR":_or}
_order=[{"name":"单行文本","mode":"desc"},{"name":"多行文本","mode":"asc"}]
_group=["单行文本","多行文本"]
_limit=[0,20]
where={"AND":_and,"GROUP":_group,"ORDER":_order,"LIMIT":_limit}
res=form.handleselectdata(hd,"测试表单",fields,where)
form.close(hd)
print(res)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无
