字段
字段(Field)是构建数据模型的基础单元,定义了实体对象中每个数据项的类型、验证规则和展示方式。
概述
在 Chameleon 平台中,字段相当于数据库表中的字段,同时与数据库表中实际存在的字段进行映射。每个字段都有明确的数据类型定义,平台会根据字段类型自动生成相应的表单控件和列表展示组件。
字段的核心作用
- 数据类型定义:明确数据的存储格式和类型约束
- UI自动生成:根据字段类型自动生成表单控件和列表展示
- 数据验证:内置丰富的验证规则,确保数据完整性
- 关联关系:支持实体间的关联引用
支持的字段类型
| 类型 | 说明 |
|---|---|
| 文本 | 单行文本、密码、文本区、Markdown、富文本等多种渲染形式 |
| 日期时间 | 支持日期时间和日期两种模式 |
| 是否 | Boolean 类型,支持自定义显示文案 |
| 数字 | 普通数字类型,支持整数和小数 |
| 货币 | 高精度数字类型,适用于金额等场景 |
| 文件上传 | 支持文件数量、大小、格式限制 |
| 人员选择 | 员工选择,支持单选/多选、多种渲染形式 |
| 组织选择 | 组织架构选择,支持多种渲染形式 |
| 数据 源 | 从候选数据列表中选择数据,支持多种渲染形式 |
字段配置概览
字段配置分为三个层次:
基本属性
- 名称、编码、类型、描述、默认值
验证属性
- 必填规则、长度限制、范围限制、正则验证
展示属性
- 列表显示、表单显示、只读模式、隐藏字段
高级功能
开启 Lookup
数据源类型字段可开启 Lookup 功能,建立与其他对象的关联关系,自动在列表和详情页展示关联对象字段。
开启索引
对常用查询条件字段开启索引,提升搜索性能(会增加存储空间)。
开启字段监听
数据源类型字段支持字段监听,当监听字段值变更时自动刷新当前字段数据源,适用于级联选择场景。
校验规则
采用正则表达式校验字段输入值,支持内置规则和自定义正则,在数据级别生效。
查重规则
配置对象数据存储时的查重规则,防止重复数据录入。
详细配置指南
字段的完整配置说明请参阅:
最佳实践
字段命名规范
- 名称:使用业务术语,简洁明了
- 编码:使用英文小写字母和下划线命名
类型选择建议
| 业务场景 | 推荐类型 | 原因 |
|---|---|---|
| 金额、价格 | 货币 | 精度高,避免浮点误差 |
| 关联其他实体 | 数据源 | 自动维护关联关系 |
| 状态标记 | 是否 | 简单直观 |