数据模型字段为数据模型的基本元素,具体可以对应到数据库表中的列。
字段通用配置
- 字段名称:中文、英文、下划线,数字,不能以数字开头。
- 字段标识:英文小写、下划线,数字,不能以数字开头。该属性设置后不支持修改。
- 数据类型:即字段类型选择,下文会对各种字段类型的使用方法进行描述。该属性设置后不支持修改。
- 是否必填:该字段是否必填。
- 是否唯一:该字段的取值是否允许重复,设置为唯一则不允许填重复值。该属性设置后不支持修改。
- 主列字段:数据模型必须设置一个或以上的主列字段。数据类型为单行文本时可选择。当用户在其它数据模型中,配置关联关系字段关联到本数据模型时,该字段会显示为主展示列的值,方便用户查看。此配置仅影响查看效果,不影响关联关系实际存储内容。
字段使用说明
单行文本
单行文本以String类型存储。单行文本字段属性设置参考:
- 文本类型:支持普通文本,邮箱地址,身份证,手机号,固定电话,密码;调用数据模型方法向模型中插入数据时,会根据不同的文本类型,进行正则校验
- 最小长度:最小可设置0,最大不超过“最大长度”设置的值;
- 最大长度:最大可设置为2000,且最大长度设置后,只能增加,不能减小。
身份证类型的文本,存储时只会校验格式是否正确,但不会校验该身份证号是否真实存在。
密码类型的文本,在使用低代码自定义页面调用数据模型方法时,会自动加密该字段的值;除此外,通过其他方式调用数据模型方法时,需要调用方加解密。
多行文本
多行文本以Text类型存储。单行文本字段属性设置参考:
- 最小长度:最小可设置0,最大不超过“最大长度”设置的值;
- 最大长度:最大可设置为65535,且最大长度设置后,只能增加,不能减小。
数字
数字类型以number类型存储。数字类型字段属性设置参考:
- 数字格式:支持整型,长整型,浮点数;
- 最大值,最小值:整型支持范围为[-2147483648, 2147483647],长整型支持范围为[-9007199254740991, 9007199254740991],浮点数支持范围为[-9007199254740991, 9007199254740991]
- 小数位数:当数字格式为浮点数时,出现小数位数,最大可设置6位
布尔
布尔类型以String类型存储,可选值为true和false
日期时间
日期时间以时间戳格式存储,使用低代码自定义页面调用数据模型方法时,日期时间类型的字段会自动转换为指定的时间格式;通过其他方式调用数据模型方法时,需要调用方进行格式转换。日期时间类型字段属性设置参考:
- 格式:支持下列格式:
- 年月日时分秒:存储Long型时间戳,显示为YYYY-MM-DD HH:mm:ss格式
- 年月日:存储Long型时间戳,显示为YYYY-MM-DD格式
- 年月:存储Long型时间戳,显示为YYYY-MM格式
- 时分:存储距离0点的毫秒数,显示为mm:ss格式
- 时间戳:存储Long型时间戳,显示为时间戳
- 最大值/最小值:按指定的格式设置最大值和最小值,超过最大值和最小值的数据,将无法被保存
关联关系
可以通过该字段关联其它数据模型,该字段会记录关联数据模型的数据ID。如人员信息表中可设置工作单位表关联关系,存储时,该字段记录工作单位ID,查询时可以通过工作单位ID获取到关联工作单位的所有主列信息并展示。
关联关系类型字段属性设置参考:
- 关联模型:下拉模型列表,选择该字段要关联的模型即可。
关联关系字段保存的是关联数据模型的数据ID,因此查询和插入数据时,都要使用ID作为参数。
数组
数组中可保存指定类型的元素,一个数组中只支持一种元素类型,以数组形式存储各种元素的值。调用数据模型方法时会根据数组的元素类型进行校验和转换。数组类型字段属性设置参考:
- 元素类型:支持单行文本、多行文本、数字,布尔,日期时间,关联关系等类型
- 其他属性:根据选择的元素不同,会弹出指定类型的属性。
主列字段详细说明
用户可以在数据模型中设置一个字段为主展示列。该字段将会影响其它模型关联此模型时的展示名称。以人员信息和工作单位为例,展示主列字段的用法。
工作单位模型配置:单位编码和单位名称设置为主列字段。
人员信息模型配置:工作单位字段为关联关系类型,关联工作单位模型:
人员信息表工作单位字段实际存储的仍然是关联表的ID,通过模型方法查询该数据模型数据时,关联关系字段以下列格式返回:
{
"id":"工作单位ID",
"company_code":"主列:单位编码",
"company_name":"主列:单位名称",
"#show":"单位编码 单位名称"
}
#show字段是将关联模型中的主列字段的值用空格连接显示,连接顺序按模型中字段的顺序排列。
在表格组件中,为方便用户查看,工作单位字段自动转换为主展示列显示出来
在表单容器中,绑定人员信息模型时,工作单位字段会自动生成为下拉单选组件。组件的选项名称即为主展示列,选项值为 id