Skip to main content

字段

字段(Field)是构建数据模型的基础单元,定义了实体对象中每个数据项的类型、验证规则和展示方式。

概述​

在 Chameleon 平台中,字段相当于数据库表中的字段,同时与数据库表中实际存在的字段进行映射。每个字段都有明确的数据类型定义,平台会根据字段类型自动生成相应的表单控件和列表展示组件。

字段的核心作用​

  • 数据类型定义:明确数据的存储格式和类型约束
  • UI自动生成:根据字段类型自动生成表单控件和列表展示
  • 数据验证:内置丰富的验证规则,确保数据完整性
  • 关联关系:支持实体间的关联引用

支持的字段类型​

类型说明
文本单行文本、密码、文本区、Markdown、富文本等多种渲染形式
日期时间支持日期时间和日期两种模式
是否Boolean 类型,支持自定义显示文案
数字普通数字类型,支持整数和小数
货币高精度数字类型,适用于金额等场景
文件上传支持文件数量、大小、格式限制
人员选择员工选择,支持单选/多选、多种渲染形式
组织选择组织架构选择,支持多种渲染形式
数据源从候选数据列表中选择数据,支持多种渲染形式

字段配置概览​

字段配置分为三个层次:

基本属性​

  • 名称、编码、类型、描述、默认值

验证属性​

  • 必填规则、长度限制、范围限制、正则验证

展示属性​

  • 列表显示、表单显示、只读模式、隐藏字段

高级功能​

开启 Lookup​

数据源类型字段可开启 Lookup 功能,建立与其他对象的关联关系,自动在列表和详情页展示关联对象字段。

开启索引​

对常用查询条件字段开启索引,提升搜索性能(会增加存储空间)。

开启字段监听​

数据源类型字段支持字段监听,当监听字段值变更时自动刷新当前字段数据源,适用于级联选择场景。

校验规则​

采用正则表达式校验字段输入值,支持内置规则和自定义正则,在数据级别生效。

查重规则​

配置对象数据存储时的查重规则,防止重复数据录入。

详细配置指南​

字段的完整配置说明请参阅:

最佳实践​

字段命名规范​

  1. 名称:使用业务术语,简洁明了
  2. 编码:使用英文小写字母和下划线命名

类型选择建议​

业务场景推荐类型原因
金额、价格货币精度高,避免浮点误差
关联其他实体数据源自动维护关联关系
状态标记是否简单直观

下一步​

  • 表单 - 配置字段在表单中的展示
  • 视图列表 - 配置字段在列表中的展示