致远OA自定义函数--正则表达式匹配校验

需求

表单填写的字段要求能够进行规则校验，这里以邮箱填写为例进行需求演示；
如下图：

在表单中的邮箱字段未录入时，右侧提示"请输入邮箱！"；
在表单中的邮箱字段录入后，右侧根据录入结果进行匹配校验，符合规则，显示"true"或者其他文字信息；不符合显示"请输入正确邮箱！"；

实现

制作表单

设计如上图所示的表单样式，邮箱字段为文本，邮箱字段右侧字段也为文本；
如下图：

定义函数

表单中【邮箱判断结果】字段设置计算公式，并新建自定义函数：


函数名称：可自定义，8.0以上版本强制要求使用英文字符；
参数设置：点击右侧的设置按钮，打开选择界面窗口，选择【邮箱】字段为参数；
代码类型：默认为Groovy
最下面的文本框中，输入函数代码段：

def email = param[0]
def isEmail = email ==~ /[\w.]+@[\w.]+/
if(email){
    return isEmail?"true":"请输入正确邮箱！"
}else{return "请输入邮箱！"}

以上设置完成后，依次点击确定、保存等按钮，同时根据实际业务需求，设置表单审批流程等信息，设置完成后，退出表单编辑状态。

函数审核

使用系统管理员账号（system账号）在后台对自定义函数进行审核通过；

效果测试

如果想排查自定义函数的错误信息，可以通过查看logs_sy/cap.log日志，查看打开表单后的输出内容确认。具体位置在Seeyon/A8/ApacheJetspeed/logs_sy/cap.log

完结

以上就是通过自定义函数，对表单中的字段进行规则校验，同理，也可以对手机号、身份证等其他字段进行判断校验。如果再结合表单自带的规则校验功能，就可以控制是否可限制提交表单等操作。
记于2022年2月17日