本文介绍了在金蝶云星空系统中,使用正则表达式进行文本字段值的高级校验的方法和步骤。首先解释了正则表达式的概念及在金蝶云星空中的应用场景,如限制用户输入。随后详细讲解了如何在BOSIDE中配置正则表达式验证规则,包括新增校验规则、定义正则表达式、在单据头创建待验证字段并配置值更新事件等。文章还提供了多种常见需求的正则表达式示例,如校验邮箱、手机号、数字、字符等,并附带了常用正则表达式大全及学习途径。最后,提供了生产订单中正则表达式校验的演示包,鼓励读者下载学习。
哈喽,小伙伴们,大家好啊!
对,又是我,今天呢,我来分享一下,在金蝶云星空系统中,运用正则表达式,实现对文本字段值的高级校验。
希望大家能喜欢哦。
下面,开始正题。
金蝶云星空的操作(例如保存、提交、审核、空操作、……之类的啦),是可配置校验规则的。
校验规则服务中有一项"正则表达式验证",大伙儿可能用得比较少。
实际上呢,它是灰常有用滴!
例如它可以用来对用户键入值进行复杂的限制和校验,例如“不允许输入标点符号和中文。”、“仅允许输入数字。”、“仅允许输入英文和数字。”、“仅允许输入英文、数字和中文。”、“仅允许输入合法邮箱地址。”、“仅允许输入合法手机号。”等等需求的实现啦~。
学好用好了正则表达式,就再也不用愁字符串合法性校验的问题啦~,想怎么验就怎么验!
肯定有小伙伴好奇,什么是正则表达式呢?
这里可以先对它进行一个简单定义:用一串简短的表达式,遵循特定的语法,就能向计算机清晰传达,你想要什么值、不想要什么值的小知识。
建议大伙儿正式开始阅读前,先看看:正则表达式介绍
需求案例演示
本文,将以《生产订单》为例,试讲下列六项需求案例的实现:
(注:点击图片可放大清晰看)
需求案例1:不允许输入标点符号和中文(例如序列号字段、批号字段)。
需求案例2:仅允许输入数字。
需求案例3:仅允许输入英文和数字。
需求案例4:仅允许输入英文、数字和中文。
需求案例5:仅允许输入合法邮箱地址。
需求案例6:仅允许输入合法手机号。
实现步骤
一.在BOSIDE中打开生产订单的操作列表
新增"空操作"类型的操作,操作代码设置为"CheckFields",操作名称命名为"以正则表达式校验字段合法性",勾选参数设置页签的"显示提示信息"。接下来,切换到其他控制页签进行下一步设置。
二.新增校验规则,选择名为"正则表达式验证"的校验规则。
具体按下图步骤进行设置:
三.配置正则表达式验证规则,依次定义描述、选择检验级别、勾选参与校验的字段、输入满足描述功能的正则表达式。
正则表达式的语法与应用会在下方详述,这里先按下图步骤进行具体设置:
四.对应上述6个需求案例,配置6条正则表达式验证规则。
1.不允许输入标点符号和中文的正则: ^[^\u4E00-\u9FA5_,.;:'""!~/\\{}\[\]()\*\? 【】?,。‘“:;|!]+$
2.仅允许输入数字的正则: ^[0-9]*$
3.仅允许输入英文和数字的正则: ^[A-Za-z0-9]+$
4.仅允许输入英文、数字和中文的正则: ^[\u4E00-\u9FA5A-Za-z0-9]+$
5.仅允许输入合法邮箱地址的正则: ^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
6.仅允许输入合法手机号: ^([1][3,4,5,6,7,8,9])\d{9}$
在完成第四步后,一路确定确定确定确定……直至保存生产订单的修改成果。
五.在单据头创建一个待验证字段,配置值更新事件,调用前面步骤我们创建的操作。
1.在单据头创建一个[待验证字段]文本字段,用于需求案例1-6的演示。
2.设置此字段的属性,【即时触发更新事件】勾选,并设置具体的【值更新事件】。
3.值更新事件】选择【新增操作】,然后拖到最下方,选择前面步骤中我们创建的自定义空操作类型的操作,操作代码为"CheckFields",操作名称为"以正则表达式校验字段合法性"。
4.然后一路确定确定确定……直至保存生产订单的修改成果,如下图:
完成了上述5步骤,可以去客户端验证效果啦(如上述需求案例6张动图所展示的效果)~。
六.可以在保存、提交、审核、反审核等操作中,按上述第二至第四步配置正则表达式验证规则。
1.第一步所创建的空操作,不会对单据产生任何影响,顾名思义,这种操作就是“空”的;第五步的字段值更新事件调用这个空操作,仅仅是为了触发正则表达式验证规则,产生错误提示并终止“空操作”,终止空操作没有任何意义,目的其实就是为了给出提示信息,也方便了演示需求案例。
2.可以在保存、提交、审核、反审核等操作中,按照上述第二步至第四步的详细指引,配置正则表达式验证规则,就能实现真正意义上的操作校验规则。例如,正则表达式验证规则配置在保存操作上,则只要单据字段中存在不满足验证规则的字符,就无法保存(保存操作被终止)。
3.至于“字段值更新事件调用正则表达式验证规则空操作”设置(对应第五步),还是很有用的,它能在用户输入字段值后,立即给出提示,告诉用户输入值合不合规,而不用等到保存、提交、审核、……等操作执行时才给姗姗来迟的提示。所以,最佳实践是两者皆配置。
正则表达式语法简解及学习途径
一.黑名单模式(除了我说不要的,其他都允许),如下图:
1.把所有你不想要的字符,均放入^[^你不想要的字符]+$中。
2.其中【\u4E00-\u9FA5】代表所有中文汉字;【_,.;:'""!~/\\{}\[\]()\*\? 【】?,。‘“:;|!】是我手工录入的常用标点符号。
3.像*、?、^、\、[、]之类的字符,属于正则表达式的元字符(可以简单理解为控制字符),如果这类字符你也不想要,需要在字符的前面加\进行转义,例如\[\]代表中括号左、中括号右你都不想要(通过加\转义告诉计算机别把它俩理解为元字符)。
二.白名单模式(除了我说要的,其他都不允许),如下图:
1.把所有你想要的字符,均放入^[你想要的字符]+$中。
2.其中【\u4E00-\u9FA5】代表所有中文汉字,【A-Z】代表所有大写英文字母,【a-z】代表所有小写英文字母,【0-9】代表所有数字。
3.像*、?、^、\、[、]之类的字符,属于正则表达式的元字符(可以简单理解为控制字符),如果这类字符你也想要,需要在字符的前面加\进行转义,例如\[\]代表中括号左、中括号右你都想要(通过加\转义告诉计算机别把它俩理解为元字符)。
三.其他疑问、技巧及进阶学习
请认真学习:正则表达式学习教材
常用正则表达式大全
在这里列出常用正则表达式大全,包括校验数字、字符、一些特殊的需求等等,供小伙伴们白(Fu)嫖(Zhi):
一、校验数字的表达式
1 数字:^[0-9]*$
2 n位的数字:^\d{n}$
3 至少n位的数字:^\d{n,}$
4 m-n位的数字:^\d{m,n}$
5 零和非零开头的数字:^(0|[1-9][0-9]*)$
6 非零开头的最多带两位小数的数字:^([1-9][0-9]*)+(.[0-9]{1,2})?$
7 带1-2位小数的正数或负数:^(\-)?\d+(\.\d{1,2})?$
8 正数、负数、和小数:^(\-|\+)?\d+(\.\d+)?$
9 有两位小数的正实数:^[0-9]+(.[0-9]{2})?$
10 有1~3位小数的正实数:^[0-9]+(.[0-9]{1,3})?$
11 非零的正整数:^[1-9]\d*$ 或 ^([1-9][0-9]*){1,3}$ 或 ^\+?[1-9][0-9]*$
12 非零的负整数:^\-[1-9][]0-9"*$ 或 ^-[1-9]\d*$
13 非负整数:^\d+$ 或 ^[1-9]\d*|0$
14 非正整数:^-[1-9]\d*|0$ 或 ^((-\d+)|(0+))$
15 非负浮点数:^\d+(\.\d+)?$ 或 ^[1-9]\d*\.\d*|0\.\d*[1-9]\d*|0?\.0+|0$
16 非正浮点数:^((-\d+(\.\d+)?)|(0+(\.0+)?))$ 或 ^(-([1-9]\d*\.\d*|0\.\d*[1-9]\d*))|0?\.0+|0$
17 正浮点数:^[1-9]\d*\.\d*|0\.\d*[1-9]\d*$ 或 ^(([0-9]+\.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*\.[0-9]+)|([0-9]*[1-9][0-9]*))$
18 负浮点数:^-([1-9]\d*\.\d*|0\.\d*[1-9]\d*)$ 或 ^(-(([0-9]+\.[0-9]*[1-9][0-9]*)|([0-9]*[1-9][0-9]*\.[0-9]+)|([0-9]*[1-9][0-9]*)))$
19 浮点数:^(-?\d+)(\.\d+)?$ 或 ^-?([1-9]\d*\.\d*|0\.\d*[1-9]\d*|0?\.0+|0)$
二、校验字符的表达式
1 汉字:^[\u4e00-\u9fa5]{0,}$
2 英文和数字:^[A-Za-z0-9]+$ 或 ^[A-Za-z0-9]{4,40}$
3 长度为3-20的所有字符:^.{3,20}$
4 由26个英文字母组成的字符串:^[A-Za-z]+$
5 由26个大写英文字母组成的字符串:^[A-Z]+$
6 由26个小写英文字母组成的字符串:^[a-z]+$
7 由数字和26个英文字母组成的字符串:^[A-Za-z0-9]+$
8 由数字、26个英文字母或者下划线组成的字符串:^\w+$ 或 ^\w{3,20}$
9 中文、英文、数字包括下划线:^[\u4E00-\u9FA5A-Za-z0-9_]+$
10 中文、英文、数字但不包括下划线等符号:^[\u4E00-\u9FA5A-Za-z0-9]+$ 或 ^[\u4E00-\u9FA5A-Za-z0-9]{2,20}$
11 可以输入含有^%&',;=?$\"等字符:[^%&',;=?$\x22]+
12 禁止输入含有~的字符:[^~\x22]+
三、特殊需求表达式
1 Email地址:^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
2 域名:[a-zA-Z0-9][-a-zA-Z0-9]{0,62}(/.[a-zA-Z0-9][-a-zA-Z0-9]{0,62})+/.?
3 InternetURL:[a-zA-z]+://[^\s]* 或 ^http://([\w-]+\.)+[\w-]+(/[\w-./?%&=]*)?$
4 手机号码:^(13[0-9]|14[0-9]|15[0-9]|16[0-9]|17[0-9]|18[0-9]|19[0-9])\d{8}$ (由于工信部放号段不定时,所以建议使用泛解析 ^([1][3,4,5,6,7,8,9])\d{9}$)
5 电话号码("XXX-XXXXXXX"、"XXXX-XXXXXXXX"、"XXX-XXXXXXX"、"XXX-XXXXXXXX"、"XXXXXXX"和"XXXXXXXX):^(\(\d{3,4}-)|\d{3.4}-)?\d{7,8}$
6 国内电话号码(0511-4405222、021-87888822):\d{3}-\d{8}|\d{4}-\d{7}
7 18位身份证号码(数字、字母x结尾):^((\d{18})|([0-9x]{18})|([0-9X]{18}))$
8 帐号是否合法(字母开头,允许5-16字节,允许字母数字下划线):^[a-zA-Z][a-zA-Z0-9_]{4,15}$
9 密码(以字母开头,长度在6~18之间,只能包含字母、数字和下划线):^[a-zA-Z]\w{5,17}$
10 强密码(必须包含大小写字母和数字的组合,不能使用特殊字符,长度在8-10之间):^(?=.*\d)(?=.*[a-z])(?=.*[A-Z]).{8,10}$
11 日期格式:^\d{4}-\d{1,2}-\d{1,2}
12 一年的12个月(01~09和1~12):^(0?[1-9]|1[0-2])$
13 一个月的31天(01~09和1~31):^((0?[1-9])|((1|2)[0-9])|30|31)$
14 钱的输入格式:
15 1.有四种钱的表示形式我们可以接受:"10000.00" 和 "10,000.00", 和没有 "分" 的 "10000" 和 "10,000":^[1-9][0-9]*$
16 2.这表示任意一个不以0开头的数字,但是,这也意味着一个字符"0"不通过,所以我们采用下面的形式:^(0|[1-9][0-9]*)$
17 3.一个0或者一个不以0开头的数字.我们还可以允许开头有一个负号:^(0|-?[1-9][0-9]*)$
18 4.这表示一个0或者一个可能为负的开头不为0的数字.让用户以0开头好了.把负号的也去掉,因为钱总不能是负的吧.下面我们要加的是说明可能的小数部分:^[0-9]+(.[0-9]+)?$
19 5.必须说明的是,小数点后面至少应该有1位数,所以"10."是不通过的,但是 "10" 和 "10.2" 是通过的:^[0-9]+(.[0-9]{2})?$
20 6.这样我们规定小数点后面必须有两位,如果你认为太苛刻了,可以这样:^[0-9]+(.[0-9]{1,2})?$
21 7.这样就允许用户只写一位小数.下面我们该考虑数字中的逗号了,我们可以这样:^[0-9]{1,3}(,[0-9]{3})*(.[0-9]{1,2})?$
22 8.1到3个数字,后面跟着任意个 逗号+3个数字,逗号成为可选,而不是必须:^([0-9]+|[0-9]{1,3}(,[0-9]{3})*)(.[0-9]{1,2})?$
23 备注:这就是最终结果了,别忘了"+"可以用"*"替代如果你觉得空字符串也可以接受的话(奇怪,为什么?)最后,别忘了在用函数时去掉去掉那个反斜杠,一般的错误都在这里
24 xml文件:^([a-zA-Z]+-?)+[a-zA-Z0-9]+\\.[x|X][m|M][l|L]$
25 中文字符的正则表达式:[\u4e00-\u9fa5]
26 双字节字符:[^\x00-\xff] (包括汉字在内,可以用来计算字符串的长度(一个双字节字符长度计2,ASCII字符计1))
27 空白行的正则表达式:\n\s*\r (可以用来删除空白行)
28 HTML标记的正则表达式:<(\S*?)[^>]*>.*?</\1>|<.*? /> (网上流传的版本太糟糕,上面这个也仅仅能部分,对于复杂的嵌套标记依旧无能为力)
29 首尾空白字符的正则表达式:^\s*|\s*$或(^\s*)|(\s*$) (可以用来删除行首行尾的空白字符(包括空格、制表符、换页符等等),非常有用的表达式)
30 腾讯QQ号:[1-9][0-9]{4,} (腾讯QQ号从10000开始)
31 中国邮政编码:[1-9]\d{5}(?!\d) (中国邮政编码为6位数字)
32 IP地址:\d+\.\d+\.\d+\.\d+ (提取IP地址时有用)
33 IP地址:((?:(?:25[0-5]|2[0-4]\\d|[01]?\\d?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|[01]?\\d?\\d))
尾声
附件《生产订单中运用正则表达式对输入值进行复杂校验和实时提醒.0.0.0.1.zip》,是基于7.6.2122.7(2021年3月份版本)的蓝海演示数据中心的生产订单扩展部署包,大家可以下载后部署到测试环境把玩,也许更有助于学习理解。
另外,小伙伴们,若还有其他比较经典的正则表达式校验需求,也请图文并茂、清晰明了的描述在本贴下方,只要是能用正则实现的需求,我将会挑选其中确实典型的需求,实现它,并且另开一贴来讲述怎么实现它。
点 赞 哦!
生产订单中运用正则表达式对输入值进行复杂校验和实时提醒.0. …(18.16KB)