表单&数据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 |
| 数据消息推送 | 记录 | 记录 | 不记录 |
| 触发聚合表 | 记录 | 记录 | 记录 |
| 数据动态 | 记录 | 记录 | 记录 |
| 事件/插件 | 可记录 | 可记录 | 可记录 |
| 重复值校验 | 不校验 | 不校验 | - |
| 表单校验 | 不校验 | 不校验 | - |
| 必填校验 | 不校验 | 不校验 | - |
| 流程节点校验 | 不校验 | 不校验 | - |
| 触发流程 | 可记录 | 不记录 | - |
| 聚合表校验 | 校验 | 校验 | 校验 |
| 字段联动、公式 | 不记录 | 不记录 | - |