1 功能简介

跨设备表单后端校验,可以理解为对前端校验的补充,适用于表单填报或导入时涉及后台数据库中数据的条件校验,例如可以实现记录的唯一性校验。

2 配置说明

  • 类型:根据常用的使用场景,后端校验目前支持“条件判断”和“唯一性校验”两种类型。
  • 选择元数据:下拉列表会列出当前表单已选的元数据,选择需要校验的表单元数据。
  • 校验规则:当“类型“选择“条件判断”时可以自定义校验条件表达式,后端校验不支持跨元数据取数,后端表达式写法参阅章节 表达式-后台表达式;当“类型”选择“唯一性校验”时,可以直接勾选需要联合校验唯一性的字段,支持多字段唯一性校验。
  • 提示类型 & 提示内容:填入触发校验时的前端提示信息内容,支持常量和表达式。

例如在表单实例“员工信息管理”中需要校验员工用户登录名在数据库中的唯一性,就需要用到后端校验,用上述两种方式均可实现。

校验类型

(1)条件判断


【类型】选择“条件判断”,【执行规则】表达式可以如下配置:使用execSql函数去数据库中查找当前用户名是否重复(计数大于0)。${execSql(dbContext,"SELECT COUNT(login_name) FROM `employee` WHERE login_name ='".concat(row.getValue("login_name")).concat("'"))>0}

小结:“条件判断”通过自定义校验条件配置触发来实现业务,适用于特定业务的的后端数据校验。

(2)唯一性校验

如果通过【唯一性校验】功能去实现上述场景配置会更加简单,【校验规则】只需要选择需要校验唯一性的字段即可,如下图所示。

小结:“唯一性校验”是包装成固定业务对单字段/多字段联合唯一性进行校验,多字段唯一性校验也是实际应用中较为常见的使用场景,可以使用此功能实现。注意:唯一性校验触发后按配置的提示内容会显示在配置了唯一性校验字段控件下方。

校验提示信息

触发校验的提示信息分别以常量和表达式举例说明:

(1)常量

提示类型选择“常量”时可以直接填写需要提示的文本信息内容,配置如下:当前用户登录名已存在,请修改!

执行效果如下图所示:

(2)表达式

若提示信息需要包含一些变量,就要用到表达式,不同于前端校验提示内容的写法,后台校验提示内容可以直接在内容中穿插变量表达式,但是要选择提示类型为“表达式”才能进行表达式解析。

例如提示内容中需要引用当前控件填写的值来提示,配置表达式写法如下:当前用户登录名【${row.getValue("login_name")}】已存在,请修改!

执行效果如下图所示:

作者:Eric  创建时间:2023-06-10 09:28
最后编辑:Eric  更新时间:2025-04-24 13:55