dataview.select
功能说明
描述
查询指定数据视图存放在数据库中的数据（支持图片/附件/手写签名的文件操作）。
支持部分mysql函数，请查看文档【支持的SQL函数】
函数原型
dataview.select(formAlias,fields,wheres="",type=0)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| formAlias | 字符型 | 数据视图的别名，可以在数据视图设计界面中获取（支持跨应用取数据，格式为："appid@表别名"） |
| fields | 数组型 | 查询字段，为表单的字段的别名，可以在表单设计的字段属性中获取，["*"]表示查询所有字段。具体参考示例 |
| wheres | 字符型 | 查询条件，默认为空 |
| type | 整数型 | 默认为0 0.以列名关联的方式返回查询结果 1.以索引的方式返回查询结果 2.以列名关联的方式返回查询到的第一条记录 3.查询以索引的方式返回查询到的第一条记录 |
- wheres 数据格式：
- WHERE ($单行文本 like "%111%") AND ($多行文本 between "111" AND "222") GROUP BY $单行文本, $多行文本 ORDER BY $单行文本 DESC, $多行文本 ASC LIMIT 0, 20
返回值
| 类型 | 描述 |
|---|---|
| 数组型 | 根据参数中的type类型返回不同的格式的数组 0.以列表的方式返回查询结果 1.以列表的方式返回查询结果 2.以字典的方式返回查询到的第一条记录 3.以列表的方式返回查询到的第一条记录，获取失败返回空数组 |
- 数据格式：
[ { "deleteTime":"", "createTime":"2019-01-05 15:05:07", "updateTime":"2019-01-11 11:00:38", "单行文本":"abc", "多行文本":"def", "图片":[ { "size":"85559", "uploadTime":"2019-03-26T17:48:28Z", "_id":"58f57658a48dae2e5f68952e", "name":"1.jpg", "mime":"image/jpeg", "uploader":"547a48c50eccde5ac8c0883b", "bucket":"pub-file", "qnKey":"Fko6hnrcvUS7n4b6QKszWRDKMsVC" } ], "附件":[ { "size":"79273", "uploadTime":"2019-03-26T17:59:15Z", "_id":"53b506717f9b4cd9d5e89e85", "name":"1.txt", "mime":"text/plain", "uploader":"547a48c50eccde5ac8c0883b", "bucket":"pub-file", "qnKey":"FpTHlLKcZrGQuRFedYoSwnKWs6V4" } ], "手写签名":[ { "_id":"5adf0f8e7f96c03842ae3f72", "bucket":"pub-file", "uploader":"", "uploadTime":"2019-05-20T17:25:43Z", "size":"98328", "qnKey":"FhdH1pyNASeDYC3JwiJQB77vmJr2", "name":"bbysignature_1558512038935.png", "mime":"image/png" } ], "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 中表示数据创建者的userid） creator 数据的创建者 createTime 数据的创建时间 deleter 数据的删除者 deleteTime 数据的删除时间 nickname 数据的创建者对应的昵称 size 文件大小，单位：字节 name 文件名称 mime 文件类型 uploader 上传人id（手写签名里为空） uploadTime 上传时间 bucket 文件服务器的空间名称 qnKey 文件在服务器空间上的标识符
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1300 | 参数不是数组类型 |
| 1305 | 参数不是关联数组 |
| 1313 | 参数非法 |
| 1506 | 连接数据库失败 |
| 1502 | 取表单字段失败 |
| 1560 | 表单中没有可操作的数据，请检查参数是否正确 |
| 1302 | 赋值失败 |
| 1513 | 条件字段不为关联数组 |
| 1508 | 非法字段别名 |
| 1504 | 不存在的字段 |
| 1582 | 非法的表达式 |
| 1505 | 不支持的函数 |
| 1587 | 查询超出范围 |
| 1504 | 不存在的字段 |
| 1533 | 数据库执行失败 |
| 1591 | 操作非法 |
| 1503 | 字段不是关联数组类型 |
| 支持的sql函数（只支持大写） | COUNT、MAX、MIN、AVG、SUM、NOW |
| 支持的sql比较关键字（只支持大写） | AND、OR、ORDER、GROUP(group by)、LIMIT |
其他：
- 所有表单查询api的结果集行数最多返回500条数据
- 所有表单api调用频率限制为1000次/分钟
示例
def test():
# name(字段别名), val(字段对应的值), exp(条件表达式) 为条件专有名称
# 普通字段查询
# 查询全部数据使用 ["*"]
fields=["$单行文本"]
res=dataview.select("测试表单",fields)
print(res)
# select `单行文本` from `测试表单` LIMIT 0,500
fields=["$单行文本"]
where="limit 0,500"
res=dataview.select("测试表单",fields,where)
print(res)
# select MAX(`单行文本`) from `测试表单`
# #开头表示sql函数, 支持的函数名称详情见备注
fields=["#MAX($单行文本)"]
res=dataview.select("测试表单",fields)
print(res)
# select `单行文本` from `测试表单` where 单行文本 IN (1,2,3) AND 单行文本1 NOT IN (4,5,6) ORDER BY 单行文本 DESC
fields=["$单行文本"]
where={"$单行文本 IN (1,2,3) AND $单行文本1 NOT IN (4,5,6) ORDER BY $单行文本 DESC"}
res=dataview.select("测试表单",fields,where)
print(res)
# 非复合字段查空值(单行文本,多行文本,数字,日期时间,单选按钮组,下拉框,流水号,成员单选,部门单选)
fields=["$单行文本"]
where="$单行文本 is None or $单行文本=''"
res=dataview.select("测试表单",fields,where)
print(res)
# 复合字段查空值(复选框组,下拉复选框,地址,定位,图片,附件,手写签名,成员多选,部门多选)
fields=["$复选框组"]
where="$复选框组 is None or $复选框组=[]"
res=dataview.select("测试表单",fields,where)
print(res)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无