字段的常规设置,指的就是元数据配置界面【常规设置】一栏的配置,主要涉及字段的字段名称、字段标识、显示名称、字段说明、主键、自增长、数据类型、控件类型、默认值等字段基础描述的设置,如下图所示:

1 字段名称、字段标识、显示名称及字段说明

1)字段名称:需要对应数据库表或视图中原始二维集的字段名称。导入方式添加的字段会自动填入数据库中的字段名称,手动添加的字段则会填入默认字段名称field1、field2等,需要手动修改与数据表中字段对应;

2)字段标识:在表单中,字段标识是元数据字段的唯一标识,字段在元数据、元数据字典、功能模块中引用时必须引用该字段标识。导入方式下,字段标识默认同字段名称,一般情况下不需要做改动,如需重新定义需满足以下设置规则:

  1. 标识不能为空;
  2. 标识只能包含英文字母、数字和下划线;
  3. 标识不能为纯数字;
  4. 不得与以下系统名称重名(不区分大小写):authId、targetVolume、volumeName、fileName、creater、debug、t、pr、vilegetype、v、validateVariants、dd_orientation、Loading、__SearchConfig。

3)显示名称:作为字段在表单中显示的别名,一般在业务中会进行重命名,方便表单填写用户理解。

4)字段说明:作为字段的注释说明信息,仅在设计器中进行展示,以便表单设计者对字段进行注释和理解,大部分情况下都无需填写。在导入方式下会将数据库中的字段注释默认填入此项。

2 主键、不是NULL和数据库自增长

1)主键:
元数据必须要设置至少一个字段作为主键字段。

如数据库表中设置字段为主键,导入字段的时候会自动勾选【主键】项。此外,系统会为主键字段默认设置为“隐藏域”的控件类型,因为主键若是自动生成的,在一般情况下将作为不需要编辑的字段,不会展示给填表用户。

2)不是NULL(版本V7.4.0新增)
如数据库表中设置为不是NULL,导入字段时会自动勾选【不是NULL】。勾选【不是NULL】时默认字段在前端控件填写时也是必填的因此会自动勾选控件的【必填】配置项,且不允许取消。

勾选【不是NULL】时不论是暂存还是正式保存,都要对字段值是否为空进行校验。

3)数据库自增长:
如果字段在数据库里设置为自增长的,那么在导入后此项会自动勾选。本质上,勾选该选项的含义是:该字段是被数据库设置了自增长的,那么该字段的自增长功能就委托数据库去完成了。

当然,不是所有数据库都支持自增长的,MySQL是支持该功能的,因此我们可以合理利用好这个功能。

3 虚拟字段

实际应用中有一些字段是不需要在数据库中实际存在的,只作为表单界面的呈现、数据计算或参数传递等虚设的字段,既不会去直接读取数据库,也不需要回写数据库,这类字段我们将其定义为“虚拟字段”。

因为不能直接读取数据库,其显示值配置方式是通过【字段默认值设置】来显示,一般通过表达式来实现数据的动态变化。

4 数据类型和控件类型

数据类型:设置字段的数据类型,选择不同数据类型会影响字段允许使用的控件类型范围。在字段导入时,系统会根据数据库中对字段的类型匹配相应的数据类型,大部分情况下不需要特地进行调整。例如:int对应默认数据类型“整型”,varchar对应默认数据类型“字符型”,date对应默认数据类型“日期型”。

控件类型:选定数据类型以后,上文也提到了不同的数据类型会影响到可选的控件范围,一般情况下默认会根据数据类型自动选定排序靠前的第一种控件。一般需要根据实际业务需要,对字段的控件类型进行调整。

5 控件默认值

为字段选定“控件类型”以后,根据控件类型的不同,还会有一些不同的配置,具体可以参考后文对各类控件的详细介绍。其中【控件默认值】是大部分控件都具备的配置项,其功能是为当前字段在表单新增页面设置控件的初始默认值。

例如:员工信息需要入职当天录入,可将“入职日期”字段的默认值设置为当天,在“公式>函数”下可以找到函数${today()用于获取当天的日期,可以一定程度减轻填写人员的工作量。又例如在本案例中,考虑到员工信息一般为入职当天录入,可将“入职日期”字段的默认值设置为当天,在“公式>函数”下可以找到函数${today()用于获取当天的日期,可以一定程度减轻填写人员的工作量。

6 必填

【必填】用于配置当前字段控件在前端填报界面是否显示必填标识以及在保存时是否触发必填校验。

  • 【必填】默认不勾选,当【不是NULL】勾选时自动勾选【必填】并禁用【必填】不允许取消勾选;当【不是NULL】取消勾选时恢复启用【必填】配置。
  • 勾选【必填】但未勾选【不是NULL】的字段,在暂存时不执行必填校验,在正式保存时需要执行必填校验。
作者:Eric  创建时间:2023-06-09 09:36
最后编辑:Eric  更新时间:2025-04-24 13:55