---
title: "1.4.2、表单数据详情"
docId: "954711594404675584"
source: "https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/9c2e5f92-03b4-4207-9b22-a0c1dd79ac56/doc/954711594404675584"
---
## 1、FormDataDetail

> 所属包：weaver-common-form-extend
> 
> 所属类：com.weaver.common.form.data.detail.FormDataDetail

| 属性名 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| id | Long | 否 | ID |
| formField | FormField | 是 | 所属表单字段 |
| subForm | SubForm | 否 | 所属明细子表 |
| dataIndex | Long | 否 | 明细表行下标 |
| content | String | 文本型字段必传 | 填写内容 |
| operator | SimpleEmployee | 否 | 创建人 |
| type | FieldDescribeType | 否 | 数据类型(标识金额控件货币类型) |
| needCopy | Boolean | 否 | 附件、图片是否需要复制 |
| statDescribe | String | 否 | 货币类型描述 |
| longitude | Double | 否 | 经度(地理位置控件使用) |
| latitude | Double | 否 | 纬度(地理位置控件使用) |
| dataText | FormDataText | 否 | 多行文本、富文本填写内容 |
| dataOptions | List<FormDataOption> | 选项型字段必传 | 选项型控件填写明细 |
| deleteType | Boolean | 否 | 删除状态 |
| contentObj | Object | 否 | 特殊字段类型的附属类型(如人力资源条件、多语言) |

数据示例

```json
[
    { //单行文本
        "formField": {
            "id": "1200637556314857472"
        },
        "content": "测试1",
    },
    { //金额、数字
        "formField": {
            "id": "1200637556314857475"
        },
        "content": "1.200",
        "type": "CNY"
    },
    { //国家、省份
        "formField": {
            "id": "1200642508370714625"
        },
        "dataOptions": [
            {
                "optionId": "6594238874381770918",
                "content": "法属圭亚那"
            },
            {
                "optionId": "6594238875467771944",
                "content": "奥兰群岛"
            }
        ]
    }
    { //附件
        "formField": {
            "id": "1200637556314857476"
        },
        "dataOptions": [
            {
                "optionId": "1200694417425448961",
                "content": "合同附件.pdf",
                "type": "file"
            }
        ],
        "needCopy": true
    },
    { //多行文本
        "formField": {
            "id": "1200637556314857473"
        },
        "dataText": {
            "content": "测试a\n测试b",
            "richContent": "测试a\n测试b"
        }
    },
    { //多级下拉(一级)
        "formField": {
            "id": "1200637603442057220"
        },
        "dataOptions": [
            {
                "optionId": "1200638063171887105",
                "content": "选项1"
            }
        ]
    },
    { //多级下拉(二级)
        "formField": {
            "id": "1200637977120989185"
        },
        "dataOptions": [
            {
                "optionId": "1200638063171887107",
                "content": "选项11"
            }
        ]
    },
    { //开关
        "formField": {
            "id": "1200642508370714629"
        },
        "dataOptions": [
            {
                "optionId": "1",
                "content": "启用"
            }
        ]
    }
    { //图片上传
        "formField": {
            "id": "1200637603442057216"
        },
        "dataOptions": [
            {
                "optionId": "1200694438975700994",
                "content": "Snipaste_2025-03-07_16-04-05.png",
                "type": "imageFile"
			}
        ]
        "needCopy": true
    },
    { //多语言文本
        "content": "测试1", //只更新当前语言
        "formField": {
            "id": "1200637603442057217"
        },
        "contentObj": {//多种语言同时保存用contentObj
            "formDataMultiLangSet": [
                {
                    "id": "1200695052907044868",// 不传则新增
                    "langId": 7,
                    "labelId": "1200695052907044866",
                    "targetId": "1200637603442057217",//字段ID
                    "value": "测试1"
                },
				{
                    "id": "1200695052907044869",// 不传则新增
                    "langId": 8,
                    "labelId": "1200695052907044866",
                    "targetId": "1200637603442057217",字段ID
                    "value": "test1"
                }
            ],
            "content": "测试1"
        }
    },
    { //人员组织多选
        "formField": {
            "id": "1200642276383760387"
        },
        "dataOptions": [
            {
                "optionId": "918327792617603074",
                "content": "张三",
                "type": "resource"
            },
            {
                "optionId": "5114723702119969714",
                "content": "李四",
                "type": "resource"
            }
        ]
    },
    { //下拉复选框
        "formField": {
            "id": "1200637603442057218"
        },
        "dataOptions": [
            {
                "optionId": "0",
                "content": "选项1"
            },
            {
                "optionId": "1",
                "content": "选项2"
            }
        ]
    },
    { //人员范围选择
        "formField": {
            "id": "1200642276383760386"
        },
        "dataOptions": [
            {
                "optionId": "918327792617603074",
                "content": "张三",
                "type": "user"
            },
            {
                "optionId": "1565867853907663832",
                "content": "表单引擎部",
                "type": "dept"
            },
            {
                "optionId": "1565607314067583204",
                "content": "华南分部",
                "type": "subcompany"
            }
        ]
    },
    { //级联
        "formField": {
            "id": "1200637977120989186"
        },
        "dataOptions": [
            {
                //分号分隔不同选项
                "optionId": "1167280362028990467,1167280362028990469,1167280362028990471;1167280362028990487,1167280362028990489",
                "content": "选项1,选项11,选项111;选项2,选项21"
            }
        ]
    },
    { //关联e-builder
        "formField": {
            "id": "1200642276383760385"
        },
        "dataOptions": [
            {
                "optionId": "1199563934682456066",
                "content": "关联EB浏览框数据1"
            }
        ]
    },
    { //第一行明细表数据
        "rowId": "476294050739549325",//rowid不传则新增
        "formField": {
            "id": "1201476006943596545"
        },
        "subForm": {
            "id": "1201475843713318913"
        },
        "dataIndex": 1,
        "dataOptions": [
            {
                "optionId": "918327792617603074",
                "content": "张三"
            }
        ]
    },
    { //第二行明细表数据
        "rowId": "476294050739549325",//rowid不传则新增
        "formField": {
            "id": "1201476006943596545"
        },
        "subForm": {
            "id": "1201475843713318913"
        },
        "dataIndex": 2,
        "dataOptions": [
            {
                "optionId": "5114723702119969714",
                "content": "李四"
            }
        ]
]
```

## 2、FormDataDetailDto

> 所属包：weaver-common-form-bean
> 
> 所属类：com.weaver.common.form.dto.data.FormDataDetailDto

| 属性名 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| rowId | Long | 否 | 明细表行ID |
| fieldId | Long | 是 | 字段ID |
| dataKey | String | 根据datakey匹配时必填 | 字段对应的key |
| content | String | 文本型字段必传 | 字段值<br>选项类型如果是常规的id选项，也可以放大content，多选用对应分隔符分隔 |
| dataIndex | Long | 否 | 明细行号 |
| operate | String | 否 | 操作，数字类型的控件 =+ =-操作 |
| dataOptions | List | 选项型字段必传 | 选项控件选项<br>普通选项类型也可以放到content |
| needCopy | boolean | 否 | 附件、图片是否需要复制 |
| matchByName | boolean | 按照名称匹配时必传 | 选项控件根据名称匹配，目前只支持以下字段（非数据源模版的时候）<br>Select，CheckBox，RadioBox，ImageCheckBox，ImageRadioBox，ComboSelect,MatrixComponent |
| extendParams | Map<String, String> | 否 | 扩展参数 |
| subFormId | Long | 否 | 明细表 Id |
| contentObj | Object | 否 | 内容对象 |
| subFormDataKey | String | 否 | 明细表dataKey |

数据示例

```json
[
    { //单行文本
        "content": "测试1",
        "fieldId": 1200637556314857472,
        "matchByName": false,
        "needCopy": false
    },
    { //金额、数字
        "content": "1.100",
        "fieldId": 1200637556314857475,
        //  "extendParams": {//金额的币种信息，可以不传
        //     "moneyType": "CNY"
        // },
        "matchByName": false,
        "needCopy": false
    },
    { //国家、省份
        "content": "6594238874381770918,6594238875467771944",
        "fieldId": 1200642508370714625,
        "matchByName": false,
        "needCopy": false
    },
    { //国家-用dataOptions
        "dataOptions": [
            {
                "optionId": "6594238874381770918",
                "content": "法属圭亚那"
            },
            {
                "optionId": "6594238875467771944",
                "content": "奥兰群岛"
            }
        ],
        "fieldId": 1200642508370714625,
        "matchByName": false,
        "needCopy": false
    },
    { //附件
        "content": "1200694417425448961",
        "fieldId": 1200637556314857476,
        "matchByName": false,
        "needCopy": true //true会复制一个新的附件
    },
    { //多行文本
        "content": "测试a\n测试b",
        "fieldId": 1200637556314857473,
        "matchByName": false,
        "needCopy": false
    },
    { //下拉复选框
        "content": "0,1",
         "fieldId": 1200637603442057218,
         "matchByName": false,
         "needCopy": false
    },
    { //多级下拉(一级)
         "content": "1200638063171887105",
         "fieldId": 1200637603442057220,
         "matchByName": false,
          "needCopy": false
    },
    { //多级下拉(二级)
          "content": "1200638063171887107",
          "fieldId": 1200637977120989185,
           "matchByName": false,
            "needCopy": false
    },
    { //开关
        "content": "1",
        "fieldId": 1200642508370714629,
        "matchByName": false,
        "needCopy": false
    },
    { //图片上传
        "content": "1200694438975700994",
        "fieldId": 1200637603442057216,
        "matchByName": false,
        "needCopy": true
    },
    { //多语言文本
        "content": "测试1", //如果要同时保存多种语言，就传入到contentObj
        "fieldId": 1200637603442057217,
        "matchByName": false,
        "needCopy": false
    },
    { //人员组织多选
        "dataOptions": [
            {
                "optionId": "918327792617603074",
                "type": "resource"
            },
            {
                "optionId": "5114723702119969714",
                "type": "resource"
            }
        ],
        "fieldId": 1200642276383760387,
        "matchByName": false,
        "needCopy": false
    },
    { //人员范围选择
        "dataOptions": [
            {
                "optionId": "918327792617603074",
                "type": "user"
            },
            {
                "optionId": "1565867853907663832",
                "type": "dept"
            },
            {
                "optionId": "1565607314067583204",
                "type": "subcompany"
            }
        ],
        "fieldId": 1200642276383760386,
        "matchByName": false,
        "needCopy": false
    },
    { //级联
        //分号分隔不同选项
        "content": "1167280362028990467,1167280362028990469,1167280362028990471;1167280362028990487,1167280362028990489",
        "fieldId": 1200637977120989186,
        "matchByName": false,
        "needCopy": false
    },
    { //关联e-builder
        "content": "1199563934682456066",
        "fieldId": 1200642276383760385,
        "matchByName": false,
        "needCopy": false
    },
    { //第一行明细表数据
        //"rowid":"1200701083199209472",//明细表的id，更新时要传入
        "content": "918327792617603074",
        "dataIndex": 1,
        "fieldId": 1201476006943596545,
        "matchByName": false,
        "needCopy": false
    },
    { //第二行明细表数据
        //"rowid":"1200701083199209472",
        "content": "918327792617603074",
        "dataIndex": 2,
        "fieldId": 1201476006943596545,
        "matchByName": false,
        "needCopy": false
    }
]
```

## 3、FormDataDtoParam

> 所属包：weaver-common-form-bean
> 
> 所属类：com.weaver.common.form.dto.data.FormDataDtoParam

| 属性名 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| formDataDtos | List<com.weaver.common.form.dto.data.FormDataDto> | 是 | 数据集合 |
| formId | Long | 是 | 表单ID |
| fieldIds | List<Long> | 否 | 过滤条件字段id，根据id去匹配formDataDetails里面的数据根据数据去匹配对应的dataId |
| fixFieldIds | List<String> | 否 | 固定字段id集合 |
| matchMore | DataUpdatePolicy | 否 | 匹配到多行的时候更新策略<br>null和DataUpdatePolicy.ZERO：不更新<br>DataUpdatePolicy.FIRST：更新第一行<br>DataUpdatePolicy.LAST：更新最后一行<br>DataUpdatePolicy.EXCEPTION：抛异常回滚<br>DataUpdatePolicy.ALL：更新全部的，多行的顺序按创建时间排序 |
| noMatch | DataUpdatePolicy | 否 | 没匹配到的时候更新策略<br>null和DataUpdatePolicy.zero不更新<br>DataUpdatePolicy.add新增，DataUpdatePolicy.EXCEPTION抛异常回滚 |
| subFormMatchFields | Map<Long, SubFormMatchDto> | 否 | 所有明细表根据fieldId更新rowId的条件集合<br>key为subFormId<br>value为对应明细表下需要匹配rowId的字段以及当前明细表是否覆盖的标记 |
| subFormDataKeyMatchFields | Map<String, SubFormMatchDto> | 否 | 所有明细表根据fieldId更新rowId的条件集合<br>key为subFormDataKey<br>value为对应明细表下需要匹配rowId的字段以及当前明细表是否覆盖的标记 |
| errorDatas | List | 否 | 数据匹配异常的数据集合，返回时携带 |
| relationId | Long | 否 | 外部模块指定ID |
| refType | String | 否 | 外部-指定rowId更新匹配不到时，按照此类型进行更新，empty表示匹配不到则置空 |
| fieldList | List | 否 | 数据相关所有字段 |
| needDefaultValue | Boolean | 否 | 是否需要默认值<br>true且新建数据时生效，传空串不会生成默认值 |
| checkEntities | List | 否 | 错误数据提示，导入接口用 |
| needCheckData | Boolean | 否 | 是否需要预校验并返回具体错误信息<br>批量数据会将错误信息精确到数据行 |
| checkResult | List<Map<String, Object>> | 否 | 预校验的错误信息 |
| shardingValue | String | 否 | 分表字段值 |
| singleDataMaxRows | Integer | 否 | 匹配到多行的时候更新最大的行数<br>DataUpdatePolicy.more更新指定的行与maxRows一起用<br>DataUpdatePolicy.all更新指定的行与maxRows一起用，maxRows为null不限制 |
| allDataMaxRows | Integer | 否 | 总更新行数限制，不能超过10000行 |
| needValidateInfo | Boolean | 否 | validate=true生效，查重结果是否需要具体信息，false或不传时只返回下表 |
| layoutMultiId | Long | 否 | 布局ID |
| module | String | 否 | 所属模块 |
| customParams | Map<String, Object> | 否 | 自定义参数 |
| newLayout | boolean | 否 | 是否使用最新布局，默认true |
| optionNoFindIgnore | boolean | 否 | 浏览按钮选项未找到时是否忽略 |
| dataKeyNoFindIgnore | Boolean | 否 | 根据dataKey匹配时未找到时是否忽略 |
| execIgnoreParam | boolean | 否 | 是否忽略运算入参（配置了运算函数） |
| execMonitor | boolean | 否 | 是否执行运算 |
| execRelate | boolean | 否 | 是否执行数据钻取 |
| validate | boolean | 否 | 是否开启数据查重校验 |
| validateExecuted | Boolean | 否 | 是否已经执行过数据查重校验 |
| client | String | 否 | 客户端来源 |
| simpleFormDataLog | SimpleFormDataLog | 否 | 表单修改日志相关信息 |
| name | String | 否 | 名称 |
| moneyTypeUseDefault | boolean | 否 | 金额启用币种时如果没有传递币种是否传递默认币种 |
| moneyTypeIgnore | Boolean | 否 | 是否忽略币种 |
| getOptionNewName | boolean | 否 | 关联选项控件是否校验选项存在，是否获取最新名称 |
| needUpdateDataIndex | Boolean | 否 | 是否更新dataIndex，默认以给如的值进行更新若不更新则需要主动传递false，此属性进行进行rowId更新时生效（已废弃） |
| needUpdateDataUpdateTime | Boolean | 否 | 是否需要更新数据更新时间，默认false |

```json
{
    "allDataMaxRows": 10000,
    "dataKeyNoFindIgnore": false,
    "execIgnoreParam": false,
    "execMonitor": false,
    "execRelate": false,
    "formDataDtos": [
        {
            "coverMap": {},
            "delRowIds": [//删除明细
				{
					"dataId":1224758990197022721,
					"rowId": 1224821559305699328,
					"subFormId":1224759037533937665
				}
			],
            "dataDetails": [
                { //单行文本
                    "content": "测试1",
                    "fieldId": 1200637556314857472,
                    "matchByName": false,
                    "needCopy": false
                },
                { //金额、数字
                    "content": "1.100",
                    "fieldId": 1200637556314857475,
                    //  "extendParams": {//金额的币种信息，可以不传
                    //     "moneyType": "CNY"
                    // },
                    "matchByName": false,
                    "needCopy": false
                },
                { //国家、省份
                    "content": "6594238874381770918,6594238875467771944",
                    "fieldId": 1200642508370714625,
                    "matchByName": false,
                    "needCopy": false
                },
                { //国家-用dataOptions
                    "dataOptions": [
                        {
                            "optionId": "6594238874381770918",
                            "content": "法属圭亚那"
                        },
                        {
                            "optionId": "6594238875467771944",
                            "content": "奥兰群岛"
                        }
                    ],
                    "fieldId": 1200642508370714625,
                    "matchByName": false,
                    "needCopy": false
                },
                { //附件
                    "content": "1200694417425448961",
                    "fieldId": 1200637556314857476,
                    "matchByName": false,
                    "needCopy": true //true会复制一个新的附件
                },
                { //多行文本
                    "content": "测试a\n测试b",
                    "fieldId": 1200637556314857473,
                    "matchByName": false,
                    "needCopy": false
                },
                { //下拉复选框
                    "content": "0,1",
                    "fieldId": 1200637603442057218,
                    "matchByName": false,
                    "needCopy": false
                },
                { //多级下拉(一级)
                    "content": "1200638063171887105",
                    "fieldId": 1200637603442057220,
                    "matchByName": false,
                    "needCopy": false
                },
                { //多级下拉(二级)
                    "content": "1200638063171887107",
                    "fieldId": 1200637977120989185,
                    "matchByName": false,
                    "needCopy": false
                },
                { //开关
                    "content": "1",
                    "fieldId": 1200642508370714629,
                    "matchByName": false,
                    "needCopy": false
                },
                { //图片上传
                    "content": "1200694438975700994",
                    "fieldId": 1200637603442057216,
                    "matchByName": false,
                    "needCopy": true
                },
                { //多语言文本
                    "content": "测试1", //如果要同时保存多种语言，就传入到contentObj
                    "fieldId": 1200637603442057217,
                    "matchByName": false,
                    "needCopy": false
                },
                { //人员组织多选
                    "dataOptions": [
                        {
                            "optionId": "918327792617603074",
                            "type": "resource"
                        },
                        {
                            "optionId": "5114723702119969714",
                            "type": "resource"
                        }
                    ],
                    "fieldId": 1200642276383760387,
                    "matchByName": false,
                    "needCopy": false
                },
                { //人员范围选择
                    "dataOptions": [
                        {
                            "optionId": "918327792617603074",
                            "type": "user"
                        },
                        {
                            "optionId": "1565867853907663832",
                            "type": "dept"
                        },
                        {
                            "optionId": "1565607314067583204",
                            "type": "subcompany"
                        }
                    ],
                    "fieldId": 1200642276383760386,
                    "matchByName": false,
                    "needCopy": false
                },
                { //级联
                    //分号分隔不同选项
                    "content": "1167280362028990467,1167280362028990469,1167280362028990471;1167280362028990487,1167280362028990489",
                    "fieldId": 1200637977120989186,
                    "matchByName": false,
                    "needCopy": false
                },
                { //关联e-builder
                    "content": "1199563934682456066",
                    "fieldId": 1200642276383760385,
                    "matchByName": false,
                    "needCopy": false
                },
                { //第一行明细表数据
                    //"rowid":"1200701083199209472",//明细表的id，更新时要传入
                    "content": "918327792617603074",
                    "dataIndex": 1,
                    "fieldId": 1201476006943596545,
                    "matchByName": false,
                    "needCopy": false
                },
                { //第二行明细表数据
                    //"rowid":"1200701083199209472",
                    "content": "918327792617603074",
                    "dataIndex": 2,
                    "fieldId": 1201476006943596545,
                    "matchByName": false,
                    "needCopy": false
                }
            ]
        }
    ],
    "formId": 1200610648327225345,
    "getOptionNewName": false,
    "matchMore": "ZERO",
    "module": "formdatareport",
    "moneyTypeIgnore": false,
    "moneyTypeUseDefault": false,
    "needUpdateDataIndex": true,
    "newLayout": true,
    "noMatch": "ZERO",
    "optionNoFindIgnore": false,
    "refType": "empty",
    "subFormDataKeyMatchFields": {},
    "subFormMatchFields": {},
    "validate": false
}
```
