操作插件样例—自定义操作校验器校验日期字段

操作插件样例—自定义操作校验器校验日期字段原创

聚宝彭

11人赞赏了该文章 2,303次浏览编辑于2021年10月27日 08:41:06

在实际业务开发过程中，很多场景涉及这样一个需求：保存/提交/审核时，需校验单据上的某些字段是否符合某些条件。目前，很多同学都是在表单插件中的 beforeItemClick/beforeDoOperation 等事件中进行校验，这种方案虽然达到了目的，但如果在后台通过代码对单据数据进行操作，则不能触发这些校验逻辑，从而造成业务数据不正确。下面我将以自定义操作校验器的方式给各位看官献上另一个实现方案。

样例场景

保存单据的时候校验：

1. 单据头的“申请日期”字段不能早于当前日期；

2. 子单据体中的“预计送货日期”字段不能晚于单据体中的“最迟送货日期”字段，否则该单不允许继续操作。

实现方案

1. 捕获 onPreparePropertys 事件，要求加载申请日期、预计送货日期、最迟送货日期字段

2. 捕获 onAddValidators 事件，添加自定义校验器

3. 实现自定义校验器，对申请日期&当前日期、预计送货日期&最迟送货日期分别进行比较

设计器界面

设计器.png

样例代码

源码-1.png

源码-2.png

源码-3.png

插件注册

插件注册.png

效果图

效果图.png

注意事项

1. 对于字段的校验，尽量在操作插件中完成，这样做的好处有：不仅在前端界面操作的时候可以触发校验逻辑，而且在后台通过代码操作单据的时候也可触发，例如，在单据A的插件中新建一条单据B的业务数据，并通过 OperationServiceHelper.executeOperate 保存单据B的时候会触发绑定在单据B的操作上的操作插件。此外，如果将操作绑定到工作流节点上，同样可触发校验逻辑。

工作流可选操作.png