正则表达式在金蝶云星空中的运用技巧:对用户输入的值进行复杂判断与实时校验。原创
金蝶云社区-深圳周少斌身份
深圳周少斌
222人赞赏了该文章 8819次浏览 未经作者许可,禁止转载编辑于2021年12月23日 17:51:11
封面

哈喽,小伙伴们,大家好啊!

对,又是我,今天呢,我来分享一下,在金蝶云星空系统中,运用正则表达式,实现对文本字段值的高级校验。

希望大家能喜欢哦


下面,开始正题。

金蝶云星空的操作(例如保存、提交、审核、空操作、……之类的啦),是可配置校验规则的。

校验规则服务中有一项"正则表达式验证",大伙儿可能用得比较少。

实际上呢,它是灰常有用滴!

例如它可以用来对用户键入值进行复杂的限制和校验,例如“不允许输入标点符号和中文。”、“仅允许输入数字。”、“仅允许输入英文和数字。”、“仅允许输入英文、数字和中文。”、“仅允许输入合法邮箱地址。”、“仅允许输入合法手机号。”等等需求的实现啦~


学好用好了正则表达式,就再也不用愁字符串合法性校验的问题啦~,想怎么验就怎么验!


肯定有小伙伴好奇,什么是正则表达式呢?

这里可以先对它进行一个简单定义:用一串简短的表达式,遵循特定的语法,就能向计算机清晰传达,你想要什么值、不想要什么值的小知识。

建议大伙儿正式开始阅读前,先看看:正则表达式介绍



  • 需求案例演示

本文,将以《生产订单》为例,试讲下列六项需求案例的实现:

(注:点击图片可放大清晰看)

需求案例1:不允许输入标点符号和中文(例如序列号字段、批号字段)。

需求案例1.gif


需求案例2:仅允许输入数字。

需求案例2.gif


需求案例3仅允许输入英文和数字。

需求案例3.gif


需求案例4:仅允许输入英文、数字和中文。

需求案例4.gif


需求案例5:仅允许输入合法邮箱地址。

需求案例5.gif


需求案例6仅允许输入合法手机号。

需求案例6.gif



  • 实现步骤

一.在BOSIDE中打开生产订单的操作列表

     新增"空操作"类型的操作,操作代码设置为"CheckFields",操作名称命名为"以正则表达式校验字段合法性",勾选参数设置页签的"显示提示信息"。接下来,切换到其他控制页签进行下一步设置。

image.png


二.新增校验规则,选择名为"正则表达式验证"的校验规则。

     具体按下图步骤进行设置:

image.png


三.配置正则表达式验证规则,依次定义描述、选择检验级别、勾选参与校验的字段、输入满足描述功能的正则表达式。

     正则表达式的语法与应用会在下方详述,这里先按下图步骤进行具体设置:

     

image.png


四.对应上述6个需求案例,配置6条正则表达式验证规则。

     image.png

     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.然后一路确定确定确定……直至保存生产订单的修改成果,如下图:


image.png

  完成了上述5步骤,可以去客户端验证效果啦(如上述需求案例6张动图所展示的效果)~。

六.可以在保存、提交、审核、反审核等操作中,按上述第二至第四步配置正则表达式验证规则。

    1.第一步所创建的空操作,不会对单据产生任何影响,顾名思义,这种操作就是“空”的;第五步的字段值更新事件调用这个空操作,仅仅是为了触发正则表达式验证规则,产生错误提示并终止“空操作”,终止空操作没有任何意义,目的其实就是为了给出提示信息,也方便了演示需求案例。

    2.可以在保存、提交、审核、反审核等操作中,按照上述第二步至第四步的详细指引,配置正则表达式验证规则,就能实现真正意义上的操作校验规则。例如,正则表达式验证规则配置在保存操作上,则只要单据字段中存在不满足验证规则的字符,就无法保存(保存操作被终止)。

    3.至于“字段值更新事件调用正则表达式验证规则空操作”设置(对应第五步),还是很有用的,它能在用户输入字段值后,立即给出提示,告诉用户输入值合不合规,而不用等到保存、提交、审核、……等操作执行时才给姗姗来迟的提示。所以,最佳实践是两者皆配置。



  • 正则表达式语法简解及学习途径

一.黑名单模式(除了我说不要的,其他都允许),如下图:

image.png


    1.把所有你不想要的字符,均放入^[^你不想要的字符]+$中。

    2.其中【\u4E00-\u9FA5】代表所有中文汉字;【_,.;:'""!~/\\{}\[\]()\*\? 【】?,。‘“:;|!】是我手工录入的常用标点符号。

    3.像*、?、^、\、[、]之类的字符,属于正则表达式的元字符(可以简单理解为控制字符),如果这类字符你也不想要,需要在字符的前面加\进行转义,例如\[\]代表中括号左、中括号右你都不想要(通过加\转义告诉计算机别把它俩理解为元字符)。


二.白名单模式(除了我说要的,其他都不允许),如下图:

image.png

    1.把所有你想要的字符,均放入^[你想要的字符]+$中。

    2.其中【\u4E00-\u9FA5】代表所有中文汉字,【A-Z】代表所有大写英文字母,a-z代表所有小写英文字母,0-9代表所有数字。

    3.像*、?、^、\、[、]之类的字符,属于正则表达式的元字符(可以简单理解为控制字符),如果这类字符你也想要,需要在字符的前面加\进行转义,例如\[\]代表中括号左、中括号右你都想要(通过加\转义告诉计算机别把它俩理解为元字符)。

三.其他疑问、技巧及进阶学习

请认真学习:正则表达式学习教材

image.png


  • 常用正则表达式大全

在这里列出常用正则表达式大全,包括校验数字、字符、一些特殊的需求等等,供小伙伴们白(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-4405222021-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月份版本)的蓝海演示数据中心的生产订单扩展部署包,大家可以下载后部署到测试环境把玩,也许更有助于学习理解。


       另外,小伙伴们,若还有其他比较经典的正则表达式校验需求,也请图文并茂、清晰明了的描述在本贴下方,只要是能用正则实现的需求,我将会挑选其中确实典型的需求,实现它,并且另开一贴来讲述怎么实现它。


       点    赞     哦!


赞 222