【应用场景】

<1>注册自定义校验器。

<2>移除校验器。

<3>调整校验器的执行顺序。

【案例演示】

采购订单，审核操作服务插件，演示注册校验器和移除校验器。

【实现步骤】

<1>编写服务插件，代码如下。

using Kingdee.BOS;
using Kingdee.BOS.Core;
using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.Validation;
using Kingdee.BOS.Util;
using System;
using System.ComponentModel;
using System.Linq;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【服务插件】OnAddValidators
    /// </summary>
    [Description("【服务插件】OnAddValidators"), HotUpdate]
    public class OnAddValidatorsOperationServicePlugIn : AbstractOperationServicePlugIn
    {
        public override void OnAddValidators(AddValidatorsEventArgs e)
        {
            base.OnAddValidators(e);
            // 添加自定义校验器
            var demoValidator = new CustomValidatorDemoValidator();
            e.Validators.Add(demoValidator);
            // 移除校验器
            e.Validators.RemoveAll(o => o.GetType().Name == "TextLegalityValidator");
            // 调整校验器顺序
            var validator = e.Validators.FirstOrDefault(o => o.GetType().Name == "BaseDataRefValidator");
            if (validator != null)
            {
                // 将此校验器放到最后执行
                e.Validators.Remove(validator);
                e.Validators.Add(validator);
            }
        }
        #region 自定义校验器
        /// <summary>
        /// 自定义校验器
        /// </summary>
        public class CustomValidatorDemoValidator : AbstractValidator
        {
            public override void InitializeConfiguration(ValidateContext validateContext, Context ctx)
            {
                base.InitializeConfiguration(validateContext, ctx);
                if (validateContext.BusinessInfo != null)
                {
                    EntityKey = validateContext.BusinessInfo.GetEntity(0).Key;
                }
            }
            public override void Validate(ExtendedDataEntity[] dataEntities, ValidateContext validateContext, Context ctx)
            {
                if (validateContext.IgnoreWarning)
                {
                    return; // 警告已经被用户忽略，就不需要再次执行了
                }
                if (dataEntities == null || dataEntities.Length <= 0)
                {
                    return;
                }
                // 循环校验每一个数据包（一个数据包对应一张单据）
                foreach (var et in dataEntities)
                {
                    var hasError = false;
                    // TODO
                    // 进行数据校验
                    hasError = true;
                    // TODO
                    // 如果校验不通过，抛出校验异常
                    if (hasError)
                    {
                        validateContext.AddError(et, new ValidationErrorInfo(
                            "", // 出错的字段Key，可以空
                            Convert.ToString(et.DataEntity[0]), // 数据包内码，必填，后续操作会据此内码避开此数据包
                            et.DataEntityIndex, // 出错的数据包在全部数据包中的顺序
                            et.RowIndex, // 出错的数据行在全部数据行中的顺序，如果校验基于单据头，此为0
                            "E1", // 错误编码，可以任意设定一个字符，主要用于追查错误来源
                            "数据校验未通过，不能继续往下操作了哦。。", // 错误的详细提示信息
                            "单据合法性检查", // 错误的简明提示信息
                            ErrorLevel.FatalError // 错误级别：警告、错误
                        ));
                    }
                }
            }
        }
        #endregion
    }
}

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，重启IIS。

<3>BOSIDE扩展采购订单，注册服务插件，保存元数据，开发完毕。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696