logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
概述

数据源

数据源管理
主数据源

外部数据源(数据库)

介绍
外部 MySQL
外部 MariaDB
外部 PostgreSQL
外部 MSSQL
外部 Oracle
主、外部数据库对比
REST API 数据源
人大金仓(KingbaseES)数据源

数据表

概述
普通表
继承表
文件表
树表
日历表
评论表
表达式表
SQL 表
数据库视图

数据表字段

概述
字段验证

基本类型

单行文本
多行文本
手机号码
电子邮箱
URL
整数
数字
百分比
密码
颜色
图标

选择类型

勾选
下拉菜单(单选)
下拉菜单(多选)
单选框
复选框

多媒体

Markdown
Markdown(Vditor)
富文本
附件(关系)
附件(URL)

日期 & 时间

概述
日期时间(含时区)
日期时间(不含时区)
Unix 时间戳
日期(不含时间)
时间

几何图形

点
线
圆
多边形

高级类型

UUID
Nano ID
排序
计算公式
自动编码
JSON
数据表选择器
加密

系统信息

创建日期
最后修改日期
创建人
最后修改人
空间
Table OID

关系类型

概述
一对一
一对多
多对一
多对多
多对多(数组)

开发

概述
Previous Page概述
Next Page单行文本

#字段验证

为了确保数据表的准确性、安全性和一致性,NocoBase 提供了字段校验功能。该功能主要分为两个部分:配置规则和校验规则。

#配置规则

20250819181342

NocoBase 系统字段是集成了 Joi 的规则,支持情况如下:

#字符串类型

Joi 字符串类型对应的 NocoBase 字段类型包括:单行文本、多行文本、手机号、邮箱、URL、密码、UUID。

#通用规则

  • 最小长度
  • 最大长度
  • 长度
  • 正则表达式
  • 必填

#邮箱

20250819192011 查看更多选项

#URL

20250819192409 查看更多选项

#UUID

20250819192731 查看更多选项

#数字类型

Joi 数字类型对应的 NocoBase 字段类型包括:整数、数字、百分比。

#通用规则

  • 大于
  • 小于
  • 最大值
  • 最小值
  • 整数倍

#整数

除通用规则外,整数字段额外支持整数验证和不安全整数验证。 20250819193758

#数字与百分比

除通用规则外,数字和百分比字段额外支持精度验证。 20250819193954

#日期类型

Joi 日期类型对应的 NocoBase 字段类型包括:日期(含时区)、日期(不含时区)、仅日期、Unix 时间戳。

支持的验证规则:

  • 大于
  • 小于
  • 最大值
  • 最小值
  • 时间戳格式验证
  • 必填

#关系字段

关系字段仅支持必填验证。需要注意的是,关系字段的必填验证暂不支持在子表单或子表格场景下应用。 20250819184344

#校验规则应用

配置字段规则后,在添加或修改数据时将触发相应的校验规则。 20250819201027

校验规则同样适用于子表格和子表单组件: 20250819202514

20250819202357

需要注意的是,在子表单或子表格场景中,关系字段的必填验证暂不生效。 20250819203016

#与客户端字段验证的区别

与服务端字段验证适用于不同的应用场景,两者在实现方式和规则触发时机上存在显著差异,因此需要分别进行管理。

#配置方式差异

  • 客户端验证:在编辑表单中配置规则(如下图所示)
  • 服务端字段验证:在数据源 → 数据表配置中设置字段规则 20250819203836

20250819203845

#校验触发时机差异

  • 客户端验证:在用户填写字段时实时触发验证,并立即显示错误信息
  • 服务端字段验证:在数据提交后,由服务端在数据入库前进行校验,错误信息通过 API 响应返回
  • 应用范围:服务端字段验证除了在表单提交时生效外,还会在工作流、数据导入等所有涉及数据新增或修改的场景中触发
  • 错误信息:客户端验证支持自定义错误信息,服务端验证暂不支持自定义错误信息