前言
本栏目内容为橙单代码生成工具的在线帮助文档,可通过橙单工具中每个配置页面右上角的「帮助」按钮直接跳转。
表单分组
- 先选择「应用」列表页面,点击「表单管理」按钮进入表单列表页面。

- 在下图左侧的表单分组列表中,可以对表单分组进行「增删改」的管理,每个表单分组会与前端工程中的表单代码目录一一对应。

批量配置表单
在表单列表页面点击「批量新建」按钮,将打开表单批量新建的全屏配置弹框。对于默认标准化类型的表单页面,我们推荐优先使用该方式完成整个「增删改查」表单的配置,如有个性化需求,再通过表单编辑器进行微调。然而对于非默认类型的表单页面,则只能通过表单编辑器进行单独配置。

- 主数据源,每个表单可以配置多个数据源,但是只能有且仅有一个「主数据源」。这里需要说明的是,批量添加表单功能仅支持「一个主数据源 + 多个表关联」作为数据模型,如希望为表单绑定更多数据源,可批量创建后再在表单编辑器中进行二次调整,具体配置会在本章后面小节给出详细的操作说明。
- 表单分组,当前表单所属的分组,表单分组与前端工程中表单源码的目录一一对应。
- 生成范围,目前仅支持「增删改查」和「流程表单」,其中流程表单配置后即可在流程编辑器中绑定并使用。
- 操作支持,目前仅支持「增删改查」、「导入」和「导出」,配置后前端会生成相应的操作按钮,后端也会生成匹配的接口代码。
- 表单名称,仅用于生成器中显示使用,与生成后工程无关。
- 表单标识,会用于构建生成后的表单路由,当前工程内必须保证唯一。
- 表单布局,批量生成的表单中会包含「编辑」和「查询列表」,该选项仅针对「编辑」页面组件的布局形式。
- 字段名称和字段类型,这里不做过多介绍。
- 显示名称,编辑表单页面为「输入项左侧的文本」,查询列表页面为「表格标题」或「查询项左侧的文本」。
- 编辑字段,在编辑表单页面中,是否可以编辑。
- 录入组件,在编辑表单页面中,数据录入组件的类型。
- 表格字段,在查询列表页面,该字段是否位于表格中显示。
- 过滤字段,在查询列表页面,是否为过滤项。如果该开关项为禁用状态,说明字段尚未配置过滤标记,具体操作可见本周后面 常问配置项的过滤字段禁用小节。
- 过滤组件,在查询列表页面,过滤组件的类型。
主数据源
- 如下图的「合同」主数据源,可批量创建出支持「增删改查」的一组标准化页面。

- 在表单列表页面,选择在本例中刚刚批量创建出的一组「合同」表单。

- 下图为主数据源的编辑表单页面。

- 点击表单编辑器左上角的「表单切换」图标,切换到本例中批量创建出的主数据源「合同工单」的查询列表页面。

- 下图为主数据源的查询列表页面。
审批工单列表页面暂不支持添加自定义页面组件,因此左侧的组件列表为空。然而对于非流程工单的查询列表页面,是支持拖拽自定义组件的。

一对一关联
- 如下图的「甲方企业」和「乙方企业」两个一对一关联,批量创建仅支持「查询列表」页面,因此「编辑字段」的开关项均为禁用状态。其余配置和主数据源无异。下面我们重点介绍一下「一对一关联查询页面」的业务应用场景。

- 在表单列表页面,选择在本例中刚刚批量创建出的一组「合同」表单。

- 如下图所示,在主数据源的「合同审批」编辑页面内,包含「甲方企业」的一对一关联选择组件,在运行时点击后,即可打开一对一关联查询弹框。
下图仅为表单编辑页面,因此不具备交互功能。表单交互操作属于生成后工程的功能,需要在本地打包运行后方可操作。

- 点击表单编辑器左上角的「表单切换」图标,切换到本例中批量创建出的一对一关联「甲方企业」的查询列表页面。

- 在下面列表页中,运行时将会显示一对一关联从表「甲方企业」的列表数据,列表最左侧会显示一个「单选按钮」组件,选中单条数据后,点击「确定」按钮即可关闭当前弹框,同时将选择的数据回填到主表的「甲方企业」组件中。

一对多关联
- 如下图的「合同详情」和「交付详情」两个一对多关联,可批量创建出支持「增删改查」的一组标准化页面,其配置和主数据源无异。下面我们重点介绍一下「一对多关联页面」与「主数据源编辑页面」之间的交互关系及业务应用场景。

- 在表单列表页面,选择在本例中刚刚批量创建出的一组「合同」表单。

- 如下图所示,在主数据源的「合同审批」编辑页面内,出现两个标签页,分别对应于两个一对多关联「合同详情」和「交付详情」的列表页面。

- 点击表单编辑器左上角的「表单切换」图标,切换到本例中批量创建出的一对多关联「编辑合同详情」的编辑页面。

- 选择前面截图中主数据源「合同审批」的「合同详情」标签页,点击「新建」或表格行内的「编辑」按钮,即可打开下面的「编辑合同详情」页面,该页面添加的数据均为与主表关联的一对多从表数据。

常问配置项
以下均为在日常技术支持过程中经常会被问到的问题,为了尽可能的节省用户的时间,我们会根据用户的反馈,持续总结并完善该小节。
过滤字段禁用
- 如下图所示,主数据源「合同」的「attachment」字段的过滤开关组件被禁用。

- 问题原因在于当前表单所依赖的数据表字段没有支持「过滤」,具体操作见以下一组截图及其文字注释。


结语
赠人玫瑰,手有余香,感谢您的支持和关注,选择橙单,效率乘三,收入翻番。