如何用插件实现操作校验

用代码实现操作校验，需要派生操作插件基类，以及实现一个校验器。

代码段1：实现操作插件基类，该插件编译通过后，需要到BOS IDE中，打开单据，注册到单据的操作上。

/// <summary>
    /// 操作服务端插件示例
    /// </summary>
    /// <remarks>
    /// 1. 示例如何强制要求加载某字段
    /// 2. 示例如何注入校验器，校验器可以通用，为避免在各操作中重复编码，剥离出来，然后各操作注入剥离出的校验器
    /// 3. 说明一些关键事件的用途
    /// </remarks>
    [System.ComponentModel.Description("操作服务端插件示例")]
    public class OperationPlugSample : Kingdee.BOS.Core.DynamicForm.PlugIn.AbstractOperationServicePlugIn
    {
        /// <summary>
        /// 数据加载前，确保需要的属性被加载
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 在列表上执行操作时，单据的字段并没有被完全加载。
        /// 如果操作插件用到了未被加载的字段，一定会中断；
        /// 本事件允许插件，强制要求加载某些字段，避免中断
        /// </remarks>
        public override void OnPreparePropertys(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.PreparePropertysEventArgs e)
        {
            // 如下代码行，指定字段xxxxx的Key，强制要求加载字段
            e.FieldKeys.Add("xxxxx");
        }
        /// <summary>
        /// 操作执行前，加载操作校验器
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 在系统开始执行校验前，插件可以追加自己的校验器进入操作校验器集合
        /// </remarks>
        public override void OnAddValidators(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.AddValidatorsEventArgs e)
        {
            // 如下代码行，示例加入自定义的校验器
            // 自定义的校验器，必须从基类 Kingdee.BOS.Core.Validation.AbstractValidator 派生
            e.Validators.Add(new OperationSampleValidator());
        }
        #region 接下来按照事件的执行事件顺序，由前向后逐一介绍各事件
        /// <summary>
        /// 操作执行前，事务开始前事件
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 1. 此事件在操作校验之后、操作实现代码之前执行
        /// 2. 此事件在操作事务之前，即此事件中的数据库处理，不受操作的事务保护
        /// 3. 通常此事件，也可以用来进行数据校验
        /// </remarks>
        public override void BeforeExecuteOperationTransaction(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.BeforeExecuteOperationTransaction e)
        {
            // TODO: ....
            // 如下代码，示意校验不通过时，终止操作的执行
            e.CancelMessage = "测试终止操作执行";
            e.Cancel = true;
        }
        /// <summary>
        /// 操作执行前，事务开始后事件
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 1. 此事件在操作校验之后
        /// 2. 此事件在操作事务开始之后
        /// 3. 此事件在操作执行代码之前
        /// 4. 此事件中的数据库处理，受操作的事务保护
        /// 5. 通常此事件，可以用来做数据准备，在操作之前，提前写数据到库
        /// </remarks>
        public override void BeginOperationTransaction(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.BeginOperationTransactionArgs e)
        {
            // TODO: 进行数据准备，甚至写预处理数据到数据库
        }
        /// <summary>
        /// 操作执行后，事务结束前
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 1. 此事件在操作执行代码之后，操作的内部逻辑已经执行完毕
        /// 2. 此事件在操作事务提交之前
        /// 3. 此事件中的数据库处理，受操作的事务保护
        /// 4. 通常此事件，可以用来做同步数据，如同步生成其他单据，而且需要受事务保护
        /// </remarks>
        public override void EndOperationTransaction(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.EndOperationTransactionArgs e)
        {
            // TODO：进行同步数据处理
        }
        /// <summary>
        /// 操作执行后，事务结束后
        /// </summary>
        /// <param name="e"></param>
        /// <remarks>
        /// 1. 此事件在操作执行后，操作的内部逻辑已经执行完毕；
        /// 2. 此事件在操作事务提交之后；
        /// 3. 此事件中的数据库处理，不受操作的事务保护
        /// 4. 通常此事件，也可以做同步数据，但是此同步数据的成功与否，不需影响操作
        /// </remarks>
        public override void AfterExecuteOperationTransaction(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.AfterExecuteOperationTransaction e)
        {
            // TODO：进行同步数据处理，如果同步失败，不影响操作的结果
        }
        #endregion 
    }

代码段2：校验器的实现

/// <summary>
    /// 操作校验器（示例）
    /// </summary>
    [System.ComponentModel.Description("操作校验器（示例）")]
    class OperationSampleValidator : Kingdee.BOS.Core.Validation.AbstractValidator
    {
        #region 重载函数
        /// <summary>
        /// 校验主实体，以此实体数据包进行循环，逐行校验
        /// </summary>
        public override string EntityKey
        {
            get
            {
                // 根据实际校验要求，返回单据头或者单据体Key
                return "FBillHead";
            }
        }
        /// <summary>
        /// 执行校验，把校验结果注入到validateContext中
        /// </summary>
        /// <param name="dataEntities"></param>
        /// <param name="validateContext"></param>
        /// <param name="ctx"></param>
        public override void Validate(
            Kingdee.BOS.Core.ExtendedDataEntity[] dataEntities, 
            Kingdee.BOS.Core.Validation.ValidateContext validateContext, 
            Kingdee.BOS.Context ctx)
        {
            foreach (var dataEntity in dataEntities)
            {
                // TODO: 逐个数据包执行校验代码
                
                // 如下代码，示意如何注入校验提示，后续操作，会自动避开校验没通过的数据包
                validateContext.AddError(dataEntity.DataEntity,
                                        new Kingdee.BOS.Core.Validation.ValidationErrorInfo(
                                            "出错字段.Key",     // 出错的字段Key，可以空
                                            Convert.ToString(dataEntity.DataEntity[0]), // 数据包内码，必填，后续操作会据此内码避开此数据包
                                            dataEntity.DataEntityIndex,     // 出错的数据包在全部数据包中的顺序
                                            dataEntity.RowIndex,            // 出错的数据行在全部数据行中的顺序，如果校验基于单据头，此为0
                                            "E1",                           // 错误编码，可以任意设定一个字符，主要用于追查错误来源
                                            "错误的详细提示信息",            // 错误的详细提示信息 
                                            "错误摘要",                     // 错误的简明提示信息
                                            Kingdee.BOS.Core.Validation.ErrorLevel.Error));     // 错误级别：警告、错误...
            }
        }
        #endregion 重载函数
    }