本文介绍了创建或更新的表单数据格式。
表单中每个组件都有唯一 ID，每个组件中填写的数据都有固定格式。保存/更新表单数据时，用 Map<String, Object> 的 jsonString 格式来作为参数传递表单中的数据。key 为组件 ID，Object 为组件的值。
单行文本
多行文本
数值
单选
复选
| 数据格式 | 示例 |
|---|
| 字符串数组 | 1["选项一","选项二"] |
评分
下拉单选
下拉复选
| 数据格式 | 示例 |
|---|
| 字符串数组 | 1["选项一","选项二"] |
级联选择
| 数据格式 | 示例 | 备注 |
|---|
| 字符串数据 | 1["part","part_b"] | 必须按照级联顺序，依次放到数组中。 |
日期
日期区间
| 数据格式 | 示例 | 备注 |
|---|
| 字符串数组 | 12["1514736000000","1517328000000"]。假如只有结束时间，["","1517328000000"] | 第一个为开始时间的时间戳字符串，第二个为结束时间的时间戳字符串。 |
图片上传
| 数据格式 | 示例 |
|---|
| JSONArray | 123456789[ { "previewUrl": "/ossFileHandle?appType=APP_K6IGJJ6PFAARLPDSWKXQ&fileName=APP_K6IGJJ6PFAARLPDSWKXQ_MTczMjU1NjYyMzg3MzI0NF8wUDk2NlQ2MVIzR1lHV1RaMjMxQ1A5U1Y1NU1NM1lMWVY1QzBMMQ.jpg&instId=&type=open&process=image/resize,m_fill,w_200,h_200,limit_0/quality,q_80", "size": 2610734, "name": "Bts2Z0e6oxA.jpg", "downloadUrl": "/ossFileHandle?appType=APP_K6IGJJ6PFAARLPDSWKXQ&fileName=APP_K6IGJJ6PFAARLPDSWKXQ_MTczMjU1NjYyMzg3MzI0NF8wUDk2NlQ2MVIzR1lHV1RaMjMxQ1A5U1Y1NU1NM1lMWVY1QzBMMQ.jpg&instId=&type=download", "url": "/ossFileHandle?appType=APP_K6IGJJ6PFAARLPDSWKXQ&fileName=APP_K6IGJJ6PFAARLPDSWKXQ_MTczMjU1NjYyMzg3MzI0NF8wUDk2NlQ2MVIzR1lHV1RaMjMxQ1A5U1Y1NU1NM1lMWVY1QzBMMQ$$.jpg&instId=&type=download" } ] |
附件组件
| 数据格式 | 示例 |
|---|
| JSONArray | 123456789[ { "downloadUrl": "文件下载地址", "name": "文件名", "previewUrl": "文件预览地址", "url": "文件下载地址", "ext": "docx" }] |
成员
| 数据格式 | 示例 | 备注 |
|---|
| 字符串数组 | 1["user01","user02"] | 传人员的userId信息，精确匹配。值必须完全匹配，userId顺序也需要一致。 |
子表单组件(原名称是明细组件)
| 数据格式 | 示例 | 备注 |
|---|
| JSONArray | 12345678[ { "textField_jcr0069m": "danhang1" //(textField_jcr0069m为子表单里的单行文本组件的组件ID) }, { "textField_jcr0069m": "danhang2" }] | 由于子表单组件下有多条记录，所以用JSONARRAY。由于每条记录都是很多组件的值，因此用JSONObject来存每个组件对应的值。 |
部门
国家/地区
| 数据格式 | 示例 |
|---|
| JSONArray | 12345[ { "value": "PG" } ] |
地址
| 数据格式 | 示例 |
|---|
| JSONObject | 123456789101112131415161718192021{ "address": "111", "regionIds": [ 460000, 469027, 469023401 ], "regionText": [ { "en_US": "hai+nan+sheng", "zh_CN": "海南省" }, { "en_US": "cheng+mai+xian", "zh_CN": "澄迈县" }, { "en_US": "guo+ying+hong+gang+nong+chang", "zh_CN": "国营红岗农场" } ] |
富文本
| 数据格式 | 示例 |
|---|
| 字符串 | 1 你好，这是测试 \n<span style="font-family: kaiti;background-color: #ff0000;color: #ffff00;">测试 \n |
城市选择
| 数据格式 | 示例 | 备注 |
|---|
| 字符串数组 | 1["110000","110100","110101"] | 第一个必须为省份ID，第二个为城市ID，第三个为区ID。 |
超链接组件
关联表单
| 数据格式 | 示例 |
|---|
| JSONArray | 12345678910[ { "appType": "APP_XXXX", "formUuid": "被关联页面的表单编码", "formType": "receipt", "instanceId": "被关联的表单实例ID", "title": "标题", "subTitle": "" }] |
扫码加入交流群