表单&数据API
简介
本章节介绍了表单&数据API的具体参数和返回值,包含表单字段查询接口、查询多条数据接口、根据排序查询多条数据接口、查询单条数据接口、新建单条数据接口、修改单条数据接口、删除单条数据接口。
使用须知
开发前,请仔细阅读开发指南。
- POST请求头
{"Authorization": "Bearer YOUR_APIKEY"}
YOUR_APIKEY
请阅读开发指南了解。
名词解释
名称 | 说明 |
---|---|
app_id | 应用ID |
entry_id | 该应用内的表单ID |
app_id
+entry_id
表示全局唯一的表单标识,前往系统管理中的API文档进行查看。
表单API
查询表单字段
POST - /api/v1/app/{app_id}/entry/{entry_id}/widgets
获取指定表单的控件/字段信息,除分割线
控件和关联查询
控件以外。
具体可以查阅文档末尾的
控件与数据类型对照表
。
- 请求参数:
{}
- 响应内容:
{
"widgets": [{
"name": "单行文本",
"title": "单行文本",
"type": "text"
},
{
"name": "多行文本",
"title": "多行文本",
"type": "textarea"
},
{
"name": "数字",
"title": "数字",
"type": "number"
},
{
"name": "日期时间",
"title": "日期时间",
"type": "datetime"
},
{
"name": "单选按钮组",
"title": "单选按钮组",
"type": "radiogroup"
},
{
"name": "复选框组",
"title": "复选框组",
"type": "checkboxgroup"
},
{
"name": "下拉复选框",
"title": "下拉复选框",
"type": "combocheck"
},
{
"name": "下拉框",
"title": "下拉框",
"type": "combo"
},
{
"name": "定位",
"title": "定位",
"type": "location"
},
{
"name": "地址",
"title": "地址",
"type": "address"
},
{
"name": "附件",
"title": "附件",
"type": "upload"
},
{
"name": "图片",
"title": "图片",
"type": "image"
},
{
"name": "子表单",
"title": "子表单",
"type": "subform",
"data": [{
"name": "子表单单行文本",
"title": "单行文本",
"type": "text"
},
{
"name": "子表单多行文本",
"title": "多行文本",
"type": "textarea"
}]
},
{
"name": "关联数据",
"title": "关联数据",
"type": "linkdata"
},
{
"name": "手写签名",
"title": "手写签名",
"type": "signature"
},
{
"name": "成员单选",
"title": "成员单选",
"type": "user"
},
{
"name": "成员多选",
"title": "成员多选",
"type": "usergroup"
},
{
"name": "部门单选",
"title": "部门单选",
"type": "dept"
},
{
"name": "部门多选",
"title": "部门多选",
"type": "deptgroup"
}]
}
返回表单字段结构信息。
参数 | 类型 | 说明 |
---|---|---|
widgets | array | 控件信息 |
widgets[].name | string | 控件别名 |
widgets[].title | string | 控件标题 |
widgets[].type | string | 控件类型,每种控件类型都有对应的数据类型 |
widgets[].data | array | 仅子表单 控件有,数组里包含了每个子控件的信息 |
数据API
查询多条数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data
该接口的返回数据,始终按照提交时间正序排列
。
- 请求参数:
{
"data_id": "53b6b1251b4eab93d38cb33b",
"fields": ["单行文本", "多行文本", "数字", "日期时间", "下拉框", "下拉复选框"],
"limit": 100,
"filter": {
"rel": "and",
"cond": [{
"field": "单行文本",
"method": "not_empty"
},
{
"field": "多行文本",
"method": "not_empty"
},
{
"field": "数字",
"method": "gt",
"value": [0]
}]
}
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
data_id | 否 | string | 上一次查询数据结果的最后一条数据的ID,没有则留空 |
fields | 否 | array | 需要查询的数据字段 |
limit | 否 | number | 查询的数据条数,1~100,默认100 |
filter | 否 | json | 数据筛选器,详情规则查看后续介绍 |
- 响应内容:
{
"data": [{
"appId": "5d995d2c4e6dfe89f4b8ccaa",
"entryId": "5d31cec8902295850d0ea658",
"_id": "55a06d676fc567faaa726521",
"单行文本": "文本内容1",
"多行文本": "第一行文本\n第二行文本\n第三行文本",
"数字": "123",
"日期时间": "2021-11-26 00:00:00",
"下拉框": "选项1",
"下拉复选框": ["选项1", "选项2"]
},
{
"appId": "5d995d2c4e6dfe89f4b8ccaa",
"entryId": "5d31cec8902295850d0ea658",
"_id": "54b21b2009dda422133572a5",
"单行文本": "文本内容2",
"多行文本": "第一行文本\n第二行文本\n第三行文本",
"数字": "123",
"日期时间": "2021-11-27 00:00:00",
"下拉框": "选项2",
"下拉复选框": ["选项2", "选项3"]
}]
}
返回查询数据信息。
参数 | 类型 | 说明 |
---|---|---|
data | array | 多条数据的集合 |
注意: 查询到的数据内容中,除了控件字段以外,还有一些系统字段。
系统字段 | 字段别名 | 数据类型 | 数据样例 | 备注 |
---|---|---|---|---|
应用ID | appId | string | "5d995d2c4e6dfe89f4b8ccaa" | appId +entryId 保证表单ID的唯一性 |
表单ID | entryId | string | "5d31cec8902295850d0ea658" | appId +entryId 保证表单ID的唯一性 |
数据ID | _id | string | “5bb6e4e013d46e148a9da655” | 全局唯一 |
提交人 | creator | json | {"_id": “575ffc5e885898ce0d2afe41”, “name”: “小云”} | - |
提交时间 | createTime | string | “2019-01-01 10:10:10” | - |
修改人 | updater | json | {"_id": “575ffc5e885898ce0d2afe41”, “name”: “小云”} | - |
修改时间 | updateTime | string | “2019-01-01 10:10:10” | - |
删除人 | deleter | json | {"_id": “575ffc5e885898ce0d2afe41”, “name”: “小云”} | - |
删除时间 | deleteTime | string | “2019-01-01 10:10:10” | - |
流程状态(仅流程表单) | number | flowState | 0 | 该字段仅流程表单支持。 2表示流程手动结束 1表示流程已结束 0表示流程进行中 |
排序查询数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data_by_sort
- 请求参数:
{
"limit": 100,
"skip": 0,
"fields": ["_widget_1499052693182", "_widget_1499052693195", "_widget_1499052693206"],
"filter": {
"rel": "and",
"cond": [{
"field": "_widget_1499052693182",
"method": "empty"
},
{
"field": "_widget_1499052693195",
"method": "not_empty"
},
{
"field": "_widget_1499052693206",
"method": "empty"
}]
},
"sort": {
"_widget_1499052693182": "desc",
"_widget_1499052693195": "asc"
}
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
limit | 否 | number | 查询的数据条数,1~100,默认100 |
skip | 否 | number | 翻页起始值索引 |
fields | 否 | array | 需要查询的数据字段 |
filter | 否 | json | 数据筛选器 |
sort | 否 | json | 排序(asc:正序;desc:倒序),排序不限制字段数量 |
以下控件类型不可作为排序字段:复选框组、下拉复选框、地址、定位、图片、附件、手写签名、成员单选、成员多选、部门单选、部门多选。
- 响应内容:
{
"data": {
"appId": "5b88531dc22c4e4c7755116f",
"entryId": "56e26c5747ae8869481b417f",
"_id": "5bb6e4e013d46e148a9da655",
"_widget_1555926403587": "张三",
"_widget_1555926403600": "张三",
"_widget_1555926403640": 7,
"_widget_1555926403652": "2019-01-01 10:10:10",
"creator": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"createTime": "2019-01-01 10:10:10",
"updateTime": "2019-01-01 10:10:10",
"updater": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"deleter": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
}
}
}
数据筛选器
查询数据接口同时也支持过滤条件
,可通过filter参数
进行数据过滤。
- 筛选参数结构如下:
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
rel | 是 | string | 筛选组合关系;“and”(满足所有过滤条件), “or”(满足任一过滤条件) |
cond | 是 | [json] | 过滤条件列表 |
- 过滤条件参数如下:
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
field | 是 | string | 字段名 |
method | 是 | string | 过滤方法; eq(等于) ne(不等于) all(同时包含) in(等于任意一个) nin(不等于任意一个) like(包含) unlike(不包含) empty(为空) not_empty(不为空) gt(大于) gte(大于等于) lt(小于) lte(小于等于) range(选择范围,在x与y之间,并且包含x和y本身) |
value | 否 | array | 过滤值 |
hasEmpty | 否 | Boolean | 是否未填写 |
- 目前支持如下字段:
字段类型 | 支持的过滤方式 | 说明 |
---|---|---|
flowState | eq,ne | 流程状态,仅对流程表单有效 |
日期时间/数字/提交时间/更新时间 | eq,ne,gt,gte,lt,lte,range,empty,not_empty | - |
单行文本/下拉框/单选按钮组 | eq,ne,in,nin,like,unlike,empty,not_empty | - |
多行文本 | like,unlike,empty,not_empty | - |
附件/图片/手写签名 | empty,not_empty | - |
定位/地址 | empty,not_empty,all,nin | - |
复选框组/下拉复选框 | eq,empty,not_empty,all,in | - |
成员单选/部门单选/提交人 | eq,ne,in,nin,empty,not_empty | - |
成员多选/部门多选 | in,all,eq,empty,not_empty | - |
- 筛选示例:
{
"filter": {
"rel": "and",
// 或者 "or"
"cond": [
// 过滤条件
{
"field": "flowState",
"method": "eq",
"value": [1]
},
{
"field": "图片",
"method": "empty"
},
{
"field": "单行文本",
"method": "in",
"value": ["apple", "pen"]
},
{
"field": "时间",
"method": "range",
"value": ["2019-06-11 00:00:00", "2019-06-28 23:59:59"]
},
{
"field": "多行文本",
"method": "like",
"value": ["ddd"] //包含“ddd”的数据
}]
}
}
查询单条数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data_retrieve
按照指定数据ID
获取表单中的数据。
- 请求参数:
{
"data_id": "59e9a2fe283ffa7c11b1ddbf"
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
data_id | 是 | string | 数据ID |
- 响应内容:
{
"data": {
"appId": "539543cee19942ea8bb5e744",
"entryId": "50dafd850f3fc191513f2f21",
"_id": "5bb6e4e013d46e148a9da655",
"_widget_1558765248187": "张三",
"聚合表验证数字": 7,
"多行文本": "webapi",
"数字": 7,
"日期时间": "2019-01-01 10:10:10",
"单选按钮组": "一年级",
"复选框组": ["选项1", "选项2"],
"下拉复选框": ["选项1", "选项2"],
"下拉框": "女",
"定位": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路86号鑫天大厦",
"lnglatXY": [113.002864, 28.199614]
},
"地址": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路86号鑫天大厦"
},
"_widget_1558929030197": [{
"name": "私有云介绍.pdf",
"size": 524288,
"mime": "application/pdf",
"url": "http://qiniu.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2"
},
{
"name": "定制介绍.pdf",
"size": 524288,
"mime": "application/pdf",
"url": "http://qiniu.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2"
}],
"图片": [{
"name": "bby.png",
"size": 3762,
"mime": "image/png",
"url": "http://qiniu.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2"
},
{
"name": "image2.png",
"size": 3762,
"mime": "image/png",
"url": "http://qiniu.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2"
}],
"子表单": [{
"子表单单行文本": "张三",
"子表单多行文本": "系统webapi"
}],
"_widget_1558929030271": {
"id": "5b237548b22ab14884086cc0",
"key": "系统"
},
"_widget_1558929030284": {
"name": "signature_1238921858.png",
"size": 1024,
"mime": "image/png",
"url": "http://qiniu.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2"
},
"成员单选": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"成员多选": [{
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
{
"_id": "575ffc5e885898ce0d2afe41",
"name": "小宝"
}],
"部门单选": {
"_id": "59daab24c91306a9239b7ca0",
"name": "经理部"
},
"部门多选": [{
"_id": "59daab24c91306a9239b7ca0",
"name": "经理部"
},
{
"_id": "59daab24c91306a9239b7ca1",
"name": "市场部"
}],
"creator": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"createTime": "2019-01-01 10:10:10",
"updateTime": "2019-01-01 10:10:10",
"updater": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"deleter": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
}
}
}
参数 | 类型 | 说明 |
---|---|---|
data | json | 单条数据 |
新增数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data_create
在指定表单中添加一条数据。
请注意:使用API添加数据时,会触发的事件有新数据提交提醒、聚合表计算&校验、数据量统计。也可以通过请求参数来控制是否发起流程、触发数据助手&功能插件&后端事件,但是不会触发重复值校验和必填校验。
另外
系统字段
和分割线
、手写签名
、关联数据
、关联查询
不支持添加和修改数据。
- 请求参数:
{
"data": {
"_widget_1558765248187": "张三",
"聚合表验证数字": 8,
"多行文本": "webapi",
"数字": 8,
"日期时间": "2019-01-01 11:11:11",
"单选按钮组": "一年级",
"复选框组": ["选项1", "选项2"],
"下拉复选框": ["选项1", "选项2"],
"下拉框": "女",
"定位": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路",
"lnglatXY": [112.99627, 28.19393]
},
"地址": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路"
},
"图片": [--格式1:直接传入图片url "https://doc.com/static/index/images/tu_1_03.png", --格式2:以数组方式传入图片url {
"url": "https://doc.com/static/index/images/tu_1_03.png"
},
--格式3:以数组方式传入图片url和自定义图片名称 {
"url": "https://doc.com/static/index/images/tu_1_03.png",
"name": "test.png"
}],
"子表单": [{
"子表单单行文本": "张三",
"子表单多行文本": "百数webapi"
},
{
"子表单单行文本": "李四",
"子表单多行文本": "百数"
}],
"成员单选": "5af263d45e67aaf5b09033c7",
"成员多选": ["5af263d45e67aaf5b09033c7", "5af263d45e67aaf5b09033c9"],
"部门单选": "5af263d45e67aaf5b09033c7",
"部门多选": ["5af263d45e67aaf5b09033c7", "5af263d45e67aaf5b09033c9"]
},
"is_start_workflow": true,
"is_start_event": true,
"operator": ""
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
data | 是 | json | 数据内容 |
is_start_workflow | 否 | Boolean | 用来控制是否触发流程,默认不触发流程 |
is_start_event | 否 | Boolean | 是否触发功能扩展设置(数据助手、插件事件、后端事件) |
operator | 否 | string | 操作人_id,默认使用应用所有者的_id |
- 响应内容:
{
"data": {
"appId": "5d995d2c4e6dfe89f4b8ccaa",
"entryId": "5d31cec8902295850d0ea658",
"creator": {
"name": "金睦",
"_id": "519311e456fcb477cbf840d0"
},
"deleter": null,
"updater": null,
"createTime": "2021-11-26 21:13:59",
"updateTime": "2021-11-26 21:13:59",
"deleteTime": null,
"_id": "5036ab0e8668ccee27fa65e1",
"_widget_1558765248187": "张三",
"聚合表验证数字": 8,
"多行文本": "webapi",
"数字": 8,
"日期时间": "2019-01-01 11:11:11",
"单选按钮组": "一年级",
"复选框组": ["选项1", "选项2"],
"下拉复选框": ["选项1", "选项2"],
"下拉框": "女",
"定位": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路",
"lnglatXY": [112.99627, 28.19393]
},
"地址": {
"province": "湖南省",
"city": "长沙市",
"district": "芙蓉区",
"detail": "韶山北路"
},
"图片": [--格式1:直接传入图片url "https://doc.com/static/index/images/tu_1_03.png", --格式2:以数组方式传入图片url {
"url": "https://doc.com/static/index/images/tu_1_03.png"
},
--格式3:以数组方式传入图片url和自定义图片名称 {
"url": "https://doc.com/static/index/images/tu_1_03.png",
"name": "test.png"
}],
"子表单": [{
"子表单单行文本": "张三",
"子表单多行文本": "百数webapi"
},
{
"子表单单行文本": "李四",
"子表单多行文本": "百数"
}],
"成员单选": "5af263d45e67aaf5b09033c7",
"成员多选": ["5af263d45e67aaf5b09033c7", "5af263d45e67aaf5b09033c9"],
"部门单选": "5af263d45e67aaf5b09033c7",
"部门多选": ["5af263d45e67aaf5b09033c7", "5af263d45e67aaf5b09033c9"]
}
}
参数 | 类型 | 说明 |
---|---|---|
data | json | 返回提交后的完整数据,内容同查询单条数据接口 |
批量新增数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/batch_data_create
在指定表单中添加多条数据。
请注意:使用API添加数据时,会触发的事件有新数据提交提醒、聚合表计算&校验、数据量统计。也可以通过请求参数来控制是否发起流程、触发数据助手&功能插件&后端事件,但是不会触发重复值校验和必填校验。
限制100条 超出报错
另外
系统字段
和分割线
、手写签名
、关联数据
、关联查询
不支持添加和修改数据。
- 请求参数:
{
"datas": [{
"单行文本": "webapi多条发起",
"成员单选": "55cb7d57f7a190e382857117"
},
{
"单行文本": "webapi发起1",
"成员单选": "55cb7d57f7a190e382857117"
}],
"is_start_workflow": false,
"is_start_event": false,
"operator": ""
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
datas | 是 | json | 数据内容 |
is_start_workflow | 否 | Boolean | 用来控制是否触发流程,默认不触发流程 |
is_start_event | 否 | Boolean | 是否触发功能扩展设置(数据助手、插件事件、后端事件) |
operator | 否 | string | 操作人_id,默认使用应用所有者的_id |
- 响应内容:
{
"success": [{
"appId": "5d89dec9547d284a4bf5fb62",
"entryId": "58417ecfad8d8e341c9e8ab8",
"creator": {
"name": "张三",
"_id": "51616fa9c2668f496283094c"
},
"deleter": null,
"updater": null,
"createTime": "2021-06-30 14:27:42",
"updateTime": "2021-06-30 14:27:42",
"deleteTime": null,
"_id": "52de26c07ad2173baf8d5b31",
"flowState": "0",
"单行文本": "webapi多条发起",
"成员单选": {
"name": "阿举",
"_id": "55cb7d57f7a190e382857117"
}
},
{
"appId": "5d89dec9547d284a4bf5fb62",
"entryId": "58417ecfad8d8e341c9e8ab8",
"creator": {
"name": "张三",
"_id": "51616fa9c2668f496283094c"
},
"deleter": null,
"updater": null,
"createTime": "2021-06-30 14:27:42",
"updateTime": "2021-06-30 14:27:42",
"deleteTime": null,
"_id": "5358703fe081160cf4114769",
"flowState": "0",
"单行文本": "webapi发起1",
"成员单选": {
"name": "阿举",
"_id": "55cb7d57f7a190e382857117"
}
}],
"failed": [{
"单行文本": "webapi多条发起2",
"成员单选": "55cb7d57f7a190e382857117"
},
{
"单行文本": "webapi多条发起5",
"成员单选": "55cb7d57f7a190e382857117"
}],
"failedCode": [4009, 4009]
}
参数 | 类型 | 说明 |
---|---|---|
success | json | 成功的数据结果 |
failed | json | 失败的原数据 |
failedCode | array | 失败对应的错误码code |
编辑数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data_update
按照指定数据ID
修改表单中的数据。
请注意:使用API修改数据时,会触发的事件有聚合表计算&校验、数据量统计。也可以通过请求参数来控制是否触发数据助手&功能插件&后端事件,不进行重复值校验、必填校验等。
- 请求参数:
{
"data_id": "5bb6e4e013d46e148a9da655",
"data": {
"单行文本": "张三",
"多行文本": "webapi",
"数字": 8,
"日期时间": "2019-01-01 11:11:11",
"下拉框": "女",
"下拉复选框": ["选项1", "选项2"]
},
"is_start_event": true,
"operator": ""
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
data_id | 是 | string | 数据ID |
data | 是 | json | 数据内容,同数据提交 |
is_start_event | 否 | Boolean | 是否触发功能扩展设置(数据助手、插件事件、后端事件) |
operator | 否 | string | 操作人_id,默认使用应用所有者的_id |
- 响应内容:
{
"data": {
"appId": "5d995d2c4e6dfe89f4b8ccaa",
"entryId": "5d31cec8902295850d0ea658",
"_id": "张三",
"单行文本": "张三",
"多行文本": "webapi",
"数字": 7,
"日期时间": "2019-01-01 10:10:10",
"下拉框": "女",
"下拉复选框": ["选项1", "选项2"],
"creator": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"createTime": "2019-01-01 10:10:10",
"updateTime": "2019-01-01 10:10:10",
"updater": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
},
"deleter": {
"_id": "575ffc5e885898ce0d2afe41",
"name": "小云"
}
}
}
参数 | 类型 | 说明 |
---|---|---|
data | json | 返回修改后的新数据,内容同查询单条数据接口 |
删除数据
POST - /api/v1/app/{app_id}/entry/{entry_id}/data_delete
按照指定数据ID
从表单中删除数据,删除的数据进入回收站。
也可以通过请求参数来控制是否发起流程、触发数据助手&功能插件&后端事件。
- 请求参数:
{
"data_id": "5bb6e4e013d46e148a9da655",
"is_start_event": false,
"operator": ""
}
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
data_id | 是 | string | 数据ID |
is_start_event | 否 | Boolean | 是否触发功能扩展设置(数据助手、插件事件、后端事件) |
operator | 否 | string | 操作人_id,默认使用应用所有者的_id |
- 响应内容:
{
"status": "success"
}
返回删除结果。
参数 | 类型 | 说明 |
---|---|---|
status | string | 返回请求结果,success 为成功。 |
控件与数据类型对照表
控件名称 | 控件类型 | 数据类型 | 数据样例 | 备注 |
单行文本 | text | string | “张三” | |
多行文本 | textarea | string | “百数webapi” | |
数字 | number | Number | 7 | |
日期时间 | datetime | string | “2019-01-01 11:10:11” | |
单选按钮组 | radiogroup | string | “一年级” | |
复选框组 | checkboxgroup | Array | [“选项1”,“选项2”] | |
下拉框 | combo | string | “女” | |
下拉复选框 | combocheck | Array | [“选项1”,“选项2”] | |
地址 | address | json | {province: "湖南省", city: "长沙市", district: "芙蓉区", detail: "袁家岭"} | |
定位 | location | json | {province: "湖南省", city: "长沙市", district: "芙蓉区", detail: "袁家岭", lnglatXY: [113.002864, 28.199614]} | lnglatXY表示[经度, 纬度] |
图片 | image | Array | [ { "name": "img.png", "size": 3762, "mime": "image/png", "url": "https://qiniu.XXX.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2" }, { "name": "img1.png", "size": 3762, "mime": "image/png", "url": "https://qiniu.XXX.com/FvXfzy2nqPP12YP5cTeH6bUX4Vp2" } ] | 数据中包含的url为图片链接 |
附件 | upload | Array | [ { "name": "接口.pdf", "size": 37602, "mime": "application/pdf", "url": "https://qiniu.XXX.com/FvXfzy2nqPP12YP5cTeH6bUVp2" }, { "name": "百数.pdf", "size": 37602, "mime": "application/pdf", "url": "https://qiniu.XXX.com/FvXfzy2nqPP12YP5cTeH6X4Vp2" } ] | 数据中包含的url为附件链接 |
子表单 | subform | Array | ||
关联数据 | linkdata | json | {“id”:“5b237548b22ab14884086cc0”,“key”:“接口”} | id表示所关联数据的ID;key表示主键字段的值 |
手写签名 | signature | json | {“name”:“signature_1238921857.png”,“size”:1024,“mime”:“image/png”,“url”:“https://qiniu.XXX.com/FvXfzy2nqPP12YP5cTeH6X4p2”} | 数据中包含的url为手写签名的图片链接 |
成员单选 | user | json | { "name": "小云", "_id": "55cb7d57f7a190e382857189" } | 成员信息中_id表示百数中的用户id;name表示用户昵称 |
成员多选 | usergroup | Array | [ { "name": "小云", "_id": "55cb7d57f7a190e382857189" }, { "name": "小宝", "_id": "575ffc5e885898ce0d2af791" } ] | |
部门单选 | dept | json | { "name": "销售部", "_id": "59daab24c91306a9239b7ca0" } | |
部门多选 | deptgroup | Array | [ { "name": "销售部", "_id": "59daab24c91306a9239b7ca0" }, { "name": "人事部", "_id": "5014a86b688ff0ec55a946d9" } ] |
API操作关联关系
- | create | update | delete |
数据消息推送 | 记录 | 记录 | 不记录 |
触发聚合表 | 记录 | 记录 | 记录 |
数据动态 | 记录 | 记录 | 记录 |
事件/插件 | 可记录 | 可记录 | 可记录 |
重复值校验 | 不校验 | 不校验 | - |
表单校验 | 不校验 | 不校验 | - |
必填校验 | 不校验 | 不校验 | - |
流程节点校验 | 不校验 | 不校验 | - |
触发流程 | 可记录 | 不记录 | - |
聚合表校验 | 校验 | 校验 | 校验 |
字段联动、公式 | 不记录 | 不记录 | - |