历史版本28 :控件校验 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本

App版本/

HTML5移动端展现插件版本

功能变动
11.0.2
-

「允许自定义值」校验项逻辑优化， Excel 导入、值通过公式计算所得等场景下也能触发校验。

V11.0.84移动端控件校验提示优化，帮助用户快速定位到问题控件，详情见第 3 节

1.2 学习视频

本文档的系列学习视频可查看：数据校验

1.3 应用场景

填报控件是可以设置校验规则的，用户在控件中录入的内容如果不满足规则，会弹出校验出错的提示信息。

如下图是文本控件设置了手机号校验，如果填写的内容不满足手机号格式，那么校验不予通过。

1621581644328189.gif

对于满足手机号格式的内容，在确认后校验予以通过，如下图所示：

1621581872859240.gif

1.4 功能入口

不是所有控件都能设置校验，只有部分控件在属性面板下会有校验设置项，如下图所示：

Snag_1ee54521.png

2. 校验规则编辑

校验规则规则说明图示支持的控件
允许为空

  • 是否允许控件内容为空

  • 支持自定义错误提示

Snag_1eefdc50.png


文本控件

文本域控件

数字控件

密码控件

单选按钮组控件

复选按钮组控件

下拉框控件

下拉复选框控件

日期控件

文件控件

列表控件

下拉树控件

视图树控件


长度

  • 可以限制文本的字数

  • 可以设置最小和最大字数

  • 支持自定义错误提示


Snag_1ef089c6.png


文本控件

文本域控件

密码控件

邮件

  • 填写内容必须是邮件格式

  • 支持自定义错误提示


Snag_1ef1589f.png


文本控件
身份证

  • 填写内容必须是身份证格式

  • 支持自定义错误提示


Snag_1ef2054a.png


文本控件
邮编

  • 填写内容必须是邮编格式

  • 支持自定义错误提示


Snag_1ef28bc0.png


文本控件
电话

  • 填写内容必须是电话格式

  • 可以选择电话的数据类型

  • 支持自定义错误提示


Snag_1ef36dc4.png


文本控件
手机

  • 填写内容必须是手机格式

  • 支持自定义错误提示


Snag_1ef40272.png


文本控件
自定义


Snag_1ef494ee.png


文本控件

文本域控件

密码控件

允许小数

  • 是否允许数字带小数

  • 可以设置最多的小数位数


Snag_1f0d53f4.png


数字控件
允许负数

  • 是否允许数字为负数


Snag_1f10dd49.png


数字控件

需要最大值

需要最小值

  • 将数字限定在某个范围内

  • 可以设置最大数和最小数

  • 支持自定义错误提示


Snag_1f13fb14.png


数字控件
允许直接编辑

  • 下拉框内能否直接填写内容

Snag_1f1bd8ef.png


下拉框控件

下拉复选框控件

日期控件

下拉树控件


允许自定义值

控件单元格中能否输入不在下拉菜单选项中的值。

不能输入时，若直接在控件所在的单元格中填写内容，当填入值不包含在下拉菜单选项中，下拉框会自动清除输入值，并会弹出提示框“值不在下拉列表内”；

11.0.2 及之后不通过直接填写，如 Excel 导入、

值通过公式计算所得、从Excel 中复制粘贴、值通过 JS 给单元格赋值所得也会触发校验，「提交」和「数据校验」时若不满足则弹窗提醒“不允许自定义值”。

Snag_1f1c2876.png


下拉框控件

下拉复选框控件

下拉树控件


3. 移动端编辑

移动端控件在校验设置不允许为空时。

2023-08-02_16-54-06.png

报错会提示有「X个控件校验失败」且校验失败的控件标红，默认报错提示为「不可为空」。如下图所示：

如果设置了错误提示。

2023-08-02_16-55-57.png

效果如下图所示：


4. 注意事项编辑

1）填写不符合校验条件的数据后，控件会自动返回上一次填写的内容。

2）填报提交时，也会根据控件的校验条件来检测提交数据。

2.gif

3）Excel 导入时不会触发控件自身设置的校验，11.0.2 及之后会触发「允许自定义值」的校验。