表单管理

表单管理

点击菜单，进入报表页面管理，如下图。

数据模型

在线表单页面操作的数据表数据，均来自于这里配置的一个主表和多个关联从表。

添加主表

点击「新增数据表」按钮添加当前在线表单所依赖的数据表，其中添加的第一张数据表为当前在线表单的主表。

• 数据源名称，数据源的中文显示名。
• 数据源标识，当前页面内唯一，推荐小驼峰命名规则。
• 数据源主表，在指定数据链接中选择主表。后面的所有关联表，都必须和主表位于相同的数据库链接。

添加关联表

目前线表单仅支持添加「一对一」和「一对多」的关联从表。

• 关联名称，请给出有意义的中文显示名。
• 关联标识，当前页面内唯一，推荐使用小驼峰命名规则。
• 关联类型，选择从表和主表之间的关联类型。目前仅支持「一对一」和「一对多」。
• 关联主表，该字段此处不能修改。
• 主表关联字段，选择主表中与从表关联的字段。
• 关联从表，从表必须与主表位于同一数据库链接。
• 从表关联字段，在从表中选择与主表关联的字段。
• 是否级联删除，主表数据删除时，会在相同事务内级联删除从表中的关联数据。
• 是否左连接，仅一对一关联支持。选择「否」时为内连接。

字段管理

点击「字段管理」操作按钮，进入如下页面。在该页面可以为主从表字段，设置必要的字段属性。

基本配置

• 基础配置介绍。
• 字段刷新，当数据表字段发生变化时，可将鼠标悬浮到指定的字段上，点击「刷新」按钮即可同步。
• 显示名称，字段在表单中默认的显示名称，默认值为字段在数据表中的注释。
• 是否必填，默认值是当前字段在数据表中「是否允许为空」的设置值，这里可以根据需要自行修改。如果必填为 TRUE，在编辑表单中，该字段所对应的组件数据，即为必填数据。
• 字典数据，可以为字段绑定字典。字典的配置方式，在前面的小节已经介绍了。查询时，会根据字段的字典 ID 值，自动翻译为「字典显示名称」值。在数据添加和编辑页面中，该字段的候选值，可从已绑定字典数据的下拉框中选择。

过滤支持

在进行列表查询页面设计时，过滤组件可以绑定的候选字段。换句话说，这里没有配置支持过滤的字段，不能被查询页面过滤组件所依赖。

• 无过滤，列表查询页面中的过滤组件，无法绑定到该字段。
• 普通过滤，等同于「等于」过滤。
• 范围过滤，等同于「大于等于」 + 「小于等于」过滤，比如时间范围字段。
• 模糊过滤，应用于字符型字段，等同于「LIKE %xx%」过滤。
• 多选过滤，仅当绑定了字典的字段，才能选择该过滤。比如在下拉框中，可以选择多个值作为过滤条件，等同于「IN」过滤。
  

数据权限过滤

如果当前在线表单页面所对应的主表，需要进行数据权限过滤，可在此处指定数据过滤字段。数据权限的配置，与普通路由表单完全一致。具体可参考开发文档 数据权限管理章节的数据权限配置小节。

• 用户过滤字段，指定与用户 ID 相关的字段，可应用于「仅查看当前用户」、「本部门所有用户」和「本部门及子部门所有用户」等数据权限过滤策略。
• 部门过滤字段，指定与部门 ID 相关的字段，可应用于「仅查看当前部门」、「所在部门及子部门」和「多部门及子部门」和「自定义部门列表」等数据权限过滤策略。

字段类别

• 文件上传字段，此类别的字段将在表单中使用上传组件。
• 图片上传字段，此类别的字段将在表单中使用上传组件，并且回显图片。

通过 JSON 格式存储文件的上传信息，因此只有字符型字段才能选择该类别。另外，如果存储类型为「本地存储」，上传的文件将存储到配置 项 common-online.uploadFileBaseDir 指定的子目录内。对于「分布式存储」，将会存储到 minio / 阿里云 OSS / 腾讯云 COS / 华为云 OBS。具体的分布式存储类型，是在代码生成器中配置的，见下图。

• 富文本字段，此类别的字段将在表单中使用富文本输入框。
• 多选字段，此类别字段在表单中，可以使用下拉多选、复选框等组件表示。字段中包含的多个数据值，会使用「逗号」分隔，因此只有字符型字段才可以选择该类别。
• 创建人部门，该字段值会在数据新增时，自动填充。
• 创建人字段，该字段值会在数据新增时，自动填充。
• 创建时间，该字段值会在数据新增时，自动填充。
• 更新人字段，该字段值会在数据新增和修改时，自动填充。
• 更新时间，该字段值会在数据新增和修改时，自动填充。
• 逻辑删除字段，用于标记数据被「逻辑删除」的字段。
• 自动编码字段，仅字符型字段可以选择该类别。选择该类别后，还需要设置编码的计算规则。
• 流程状态，数据值等同于工单表中的 flow_status 字段，仅当流程完成时，才会自动同步到该字段。
• 流程审批状态，数据值等同于工单表中的 latest_approval_status 字段，流程任务审批状态变化时，会将任务的审批状态值自动同步到该字段。

字段验证

为指定字段添加前端验证规则，同一个字段可以配置多个规则。

数据脱敏

在线表单和路由表单的数据脱敏规则大同小异，因此在开始阅读本小节内容之前，请先阅读开发文档 架构进阶必读章节的数据脱敏小节。本小节仅介绍与在线表单相关的数据脱敏操作步骤和实现细节。

脱敏字段配置

和路由表单的规则一样，都是只有「字符型」字段才能配置为脱敏字段，内置的脱敏规则也和路由表单完全一致。

表单配置

可以在表单设计页面，设置此表单哪些字段需要脱敏。主要注意的是，只有查询类型的表单支持脱敏字段选择，编辑和详情等二级表单页面，脱敏规则与查询页面设置一致，如下图所示。

自定义处理器

与路由表单不同，在线表单不支持为不同的脱敏字段提供不同的自定义脱敏规则处理器对象。

• 在业务服务中，提供在线表单自定义脱敏规则处理器实现类。
• 该类必须继承自 OnlineCustomMaskFieldHandler 类。
• 该类必须为 Bean 对象，并在服务启动时，将 this 对象注册到 OnlineCustomExtFactory 的 setCustomMaskFieldHandler 方法中，以供运行时使用。
• 在实际的业务开发中，可根据 handleMask 方法参数 appCode、tableName 和 columnName 进行条件分支的判断，以处理不同字段的自定义脱敏规则。
• 最后需要强调一下，handleMask 方法中的 modelName 参数，表示在线表单表对象名，如「SysUser」，而 objectFieldName 参数表示在线表单表字段对象的属性名，如「mobilePhone」。

聚合计算

为数据主表添加基于聚合计算的虚拟字段。添加后的虚拟字段，可以在列表中被正常显示，在详情页，也可以被组件绑定后显示。与普通数据表字段的差别是，虚拟字段不能编辑，也不会存入数据表，仅为查询过程中动态计算后的显示。

新增聚合计算虚拟字段。

• 结果字段列名，字段名别名，推荐使用小驼峰命名规则。
• 结果字段显示名，中文显示名称。
• 聚合关联，仅能选择「一对多」关联。
• 聚合计算表，一对多关联从表。
• 聚合计算字段，选择从表中参与聚合计算的字段。
• 结果字段类型，计算结果值的类型。
• 聚合计算规则，聚合计算的规则，如 SUM / COUNT / AVG / MIN / MAX 等。
  添加过滤条件，用于过滤参与计算的一对多从表数据。
  

以上两图的配置，会生成如下 SQL，用于计算基于聚合计算的虚拟字段。