form.getdatabyid
功能说明
描述
根据表单中的单条数据id（支持图片/附件/手写签名的文件操作），获取表单中对应的数据。
函数原型
form.getdatabyid(formAlias,dataId,fields=None)参数
| 名称 | 类型 | 描述 |
|---|---|---|
| formAlias | 字符型 | 表单别名，可以在表单设计界面中的”表单属性”中获取（支持跨应用取数据，格式为："appid@表别名"） |
| dataId | 字符型 | 数据id，每一行表单数据对应一个id，通过查询api获取（例如：form.select） |
| fields | 数组型 | 查询字段，默认为空表示获取所有字段数据，可以在表单设计的字段属性中获取，["*"] 表示查询所有字段。具体参考示例 |
返回值
| 类型 | 描述 |
|---|---|
| 数组：列表型 | 获取成功返回数组，获取失败则返回None或空数组 |
- 数据格式：
{ "id":"58d0e3930170170b8953877e", "单行文本":"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":"2.jpg", "mime":"image/jpeg", "uploader":"547a48c50eccde5ac8c0883b", "bucket":"pub-file", "qnKey":"FpTHlLKcZrGQuRFedYoSwnKWs6V4" } ], "deleter":"", "updateTime":"2019-01-11 17:12:36", "creator":{ "nickname":"皮柏军", "id":"547a48c50eccde5ac8c0883b" }, "createTime":"2019-01-11 11:00:49", "deleteTime":"", }
| 名称 | 描述 |
|---|---|
| id | 数据id，在不同的范围内代表不同含义（例如在 creator 中表示数据创建者的userid） |
| creator | 数据的创建者 |
| createTime | 数据的创建时间 |
| deleter | 数据的删除者 |
| deleteTime | 数据的删除时间 |
| nickname | 数据的创建者对应的昵称 |
| size | 文件大小，单位：字节 |
| name | 文件名称 |
| mime | 文件类型 |
| uploader | 上传人id |
| uploadTime | 上传时间 |
| bucket | 文件服务器的空间名称 |
| qnKey | 文件在服务器空间上的标识符 |
备注
可能出现的错误信息，执行 getlasterror 函数获取具体详细信息：
- 错误编码=getlasterror()
- 错误信息=getlasterror(1)
| 错误编码 | 错误信息 |
|---|---|
| 1407 | api执行频率超出限制 |
| 1400 | 参数类型不正确 |
| 1313 | 参数非法 |
| 1503 | 字段不是关联数组类型 |
| 1508 | 非法字段别名 |
| 1504 | 不存在的字段 |
其他：
- 所有表单api调用频率限制为1000次/分钟。
示例
def test():
ret=form.getdatabyid("表单别名", "5992510eac660721380eb5ba", ["*"])
print(ret)演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无