   **该文档仅提供系统字段值描述和关联关系参考，请避免直接sql操作写数据的情况**，**若系统字段值未正常维护系统标准功能无法解析对应数据**

   此方式为直接insert表单数据方式(不推荐)， 推荐使用数据操作接口方式，相应接口文档为：[数据操作接口](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/doc/c98b2645-ea0a-465e-a00c-19b36aa50c4b)

[系统参数获取方式说明](https://weapp.eteams.cn/sp/techdoc/doc/4771f4ea-bf3d-403e-81c1-c2983e604b06/freepass)

```
#  生成分布式ID的方法: com.weaver.common.distribution.genid.IdGenerator#generate()
#  说明中的三张表均需要正确维护数据；其中未标记"可为空"的字段均为对应表单中必填值，需正确维护数据和关联关系
#  如果数据需要前台正常可见， 非必要场景外， uf_xxx、ebdf_physical_data两表中data_status维护为"1",否则可能因草稿数据原因导致数据不可见
#  主表正式数据 delete_type = 0;  明细表正式数据 delete_type = 0 and ft_status = 0;
```

## uf\_xxx 表结构

| 字段名 | 是否必须维护 | 描述 |
| --- | --- | --- |
| `id` | 是 | 数据 ID，与 `formdata#id`、`ebdf\_physical\_data#form\_data\_id`、`ebdf\_physical\_data#form\_table\_id` 相同，用于维护分布式 ID 值。 |
| `is\_flow` | 是（主表必须, 明细无需维护） | 是否为流程数据，0 表示不是，1 表示是。该字段仅在主表中存在，非流程数据也需维护为 0，否则会导致列表中该数据不可见。 |
| `flow\_id` | 否（主表必须, 明细无需维护） | 流程 ID，若为流程数据则存储 `requestId`，非流程数据为 `null`。该字段仅在主表中存在。 |
| `data\_status` | 是 | 数据状态，0 表示草稿（只有创建者可见），1 表示正式数据。该字段仅在主表中存在。 |
| `data\_index` | 是 | 数据行号，主表为 0，明细表行号依次为 1、2、3、4、5 等。 |
| `creator` | 是 | 数据创建人。 |
| `create\_time` | 是 | 数据创建时间。 |
| `updater` | 否 | 数据更新人（可为空）。 |
| `update\_time` | 否 | 数据更新时间（可为空）。 |
| `delete\_type` | 是 | 数据删除状态，0 表示正式数据，1 表示回收站数据，2 表示表单彻底删除，3 表示物理待删除 (如需物理删除请看此文档最下方)。`eb` 标准操作的数据会同步更新，`is\_delete` 废弃字段兼容老逻辑，但建议使用 `delete\_type`。 |
| `ft\_status` | 是 | 明细表行数据的删除状态，0 表示正式数据，1 表示删除数据。 |
| `form\_data\_id` | 是 | 主表数据与 `id` 一致，明细数据关联对应主表数据的 `id`。 |
| `tenant\_key` | 是 | 租户key |

## ebdf\_physical\_data 表结构（2511.01基线及以上，可以不再插入数据到此表）

| 字段名 | 是否必须维护 | 描述 |
| --- | --- | --- |
| `id` | 是 | `eb` 数据大表的 ID，无实际意义，只需保证分布式 ID 唯一即可。 |
| `obj\_id` | 是 | `eb` 表单 ID，对应 `ebdf\_obj#id`，获取方式可参考 [系统参数获取方式说明](https://weapp.eteams.cn/sp/techdoc/doc/4771f4ea-bf3d-403e-81c1-c2983e604b06/freepass) 中的 `objId` 部分。 |
| `name` | 是 | 表单数据标题。 |
| `form\_data\_id` | 是 | 表单数据 ID，对应 `uf\_xxx#id`，维护分布式 ID 值。 |
| `form\_table\_id` | 是 | 表单数据 ID，对应 `uf\_xxx#id`，维护分布式 ID 值。 |
| `is\_flow` | 是 | 是否为流程数据，0 表示不是，1 表示是。该字段仅在主表中存在，非流程数据也需维护为 0，否则会导致列表中该数据不可见。 |
| `flow\_id` | 否（主表必须） | 流程 ID，若为流程数据则存储 `requestId`，非流程数据为 `null`。该字段仅在主表中存在。 |
| `data\_status` | 是 | 数据状态，0 表示草稿（只有创建者可见），1 表示正式数据。该字段仅在主表中存在。 |
| `creator` | 是 | 数据创建人。 |
| `create\_time` | 是 | 数据创建时间。 |
| `updater` | 否 | 数据更新人（可为空）。 |
| `update\_time` | 否 | 数据更新时间（可为空）。 |
| `delete\_type` | 是 | 数据删除状态，0 表示正式数据，1 表示回收站数据，3 表示物理删除数据(如需物理删除请看此文档最下方)。 |
| `tenant\_key` | 是 | 租户键。 |

## formdata 表结构

| 字段名 | 是否必须维护 | 描述 |
| --- | --- | --- |
| `id` | 是 | 表单数据 ID。 |
| `form\_id` | 是 | 表单 ID，对应 `form#id`、`ebdf\_obj#form\_id`，获取方式可参考 [系统参数获取方式说明](https://weapp.eteams.cn/sp/techdoc/doc/4771f4ea-bf3d-403e-81c1-c2983e604b06/freepass) 中的 `formId` 部分。 |
| `layout\_id` | 是 | 关联布局 ID，获取方式可参考 [系统参数获取方式说明](https://weapp.eteams.cn/sp/techdoc/doc/4771f4ea-bf3d-403e-81c1-c2983e604b06/freepass) 中的 `layoutId` 部分。 |
| `module` | 是 | 对应模块，固定为 `"ebuilderform"`。 |
| `name` | 是 | 数据标题。 |
| `delete\_type` | 是 | 数据删除状态。 |
| `operator` | 是 | 数据创建人。 |
| `create\_time` | 是 | 数据创建时间。 |
| `data\_status` | 是 | 表单数据状态（注意：`uf` 表以及 `ebdf\_physical\_data` 表的 `data\_status` 状态含义不一致），默认值为 `'submit'`。 |
| `client` | 是 | 提交客户端，默认值为 `'pc'`。 |
| `tenant\_key` | 是 | 租户键。 |

```
delete_type=3 的数据架构扫描 update_time>7天 物理删除
如果需要缩短物理删除时间，可在weaver-mybatis-ext.properties添加如下配置(如不清楚可和架构部 孙肖峰 确认)

# 对应数据库表名和保留天数
weaver.mybatis-plus.data.clear.whiteTableDays=table1:1,table2:2
```
