提交时校验数据

1. 简介

1.1 功能简介

「校验数据」是「表单提交时」支持配置的事件之一。即在用户提交表单的时候，对填写内容进行校验，并在不满足校验条件的时候进行提示或阻止提交。

1.2 使用场景

适用于需要对填写的表单内容进行校验的场景。如活动报名表中对手机字段的校验、产品管理中对产品编号的校验、员工信息表中对身份证号的校验等。

1.3 预期效果

1）阻止提交

以商品编号为通过校验时阻止提交为例，设置商品编号为 5 位数，不满足条件时，无法提交表单。如下所示：

2）允许忽略提示并继续提交

以提交采购申请为例，当填写的到货日期不足 3 天时，提示成员并支持继续提交。如下所示：

2. 设置步骤

2.1 设置入口

1）在「表单设计 > 表单属性 > 表单提交时 > 校验数据」处，点击添加校验条件，即可进行设置。

2）当一个表单中添加了多个校验条件时，支持对列表中的条件进行拖拽排序，便于查看。

2.2 设置校验条件

「校验数据」事件中的公式，即设置的校验条件。在表单提交时，将校验数据是否满足该条件，并在不满足条件的时候进行提示或阻止提交，所以在设置校验条件时需写出正确的条件。

在公式中插入字段时，可通过如下两种方式：

2.3 设置提示文字

提示文字，即不满足校验条件时出现的提示内容。设置时，支持插入表单字段，提示时将带出字段实际值。

例如，设置提示文字为「当前到货日期为【到货日期】，预留采购时间不足 3 天，可能无法按时到货」，成员看到的提示将包含它实际填写的日期，便于定位问题。如下图所示：

2.4 设置字段修改时实时校验

开启「字段修改时实时校验」后，当成员编辑校验条件中涉及到的字段时，系统将实时进行校验并反馈结果，辅助成员正确填写表单内容，无需等到提交时再发现问题。以校验采购到货日期为例，如下图所示：

2.5 设置不满足校验条件时的处理方式

支持设置校验强度，即数据不满足校验条件时，成员能否继续提交：

以允许忽略并继续提交为例，效果如下图所示：

2.6 效果演示

效果参见本文【1.3 预期效果】。

3. 判断符号

常用判断符号如下所示，公式用法详情参见：公式

4. 注意事项

1）普通表单可以在表单属性中设置校验条件，对数据进行校验。

2）流程表单开启流程后，处理流程时的校验以流程节点的校验条件设置为准，详情可参见：节点校验条件。