【应用场景】

使用校验器，执行子单据体字段汇总到单据体后的数据合法性检查。

【案例演示】

采购订单有明细信息单据体，明细信息单据体有交货明细子单据体，添加校验器，验证交货明细子单据体的数量列合计值是否等于其父单据体的交货数量字段的值。

【实现步骤】

<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.Orm.DataEntity;

using Kingdee.BOS.Util;

using System;

using System.ComponentModel;

using System.Linq;

namespace Jac.XkDemo.BOS.App.PlugIn

{

    /// <summary>

    /// 【服务插件】子单据体字段汇总到单据体后的数据合法性检查

    /// </summary>

    [Description("【服务插件】子单据体字段汇总到单据体后的数据合法性检查"), HotUpdate]

    public class SubEntitySummaryToEntityOperationServicePlugIn : AbstractOperationServicePlugIn

    {

        /// <summary>

        /// 添加插件需要用到的字段引用

        /// </summary>

        /// <param name="e"></param>

        public override void OnPreparePropertys(PreparePropertysEventArgs e)

        {

            base.OnPreparePropertys(e);

            e.FieldKeys.Add("F_Jac_Qty");

            e.FieldKeys.Add("FPlanQty");

        }

        /// <summary>

        /// 添加校验器

        /// </summary>

        /// <param name="e"></param>

        public override void OnAddValidators(AddValidatorsEventArgs e)

        {

            base.OnAddValidators(e);

            var validator = new SubEntitySummaryToEntityValidator();

            e.Validators.Add(validator);

        }

    }

    /// <summary>

    /// 校验器-子单据体字段汇总到单据体后的数据合法性检查

    /// </summary>

    public class SubEntitySummaryToEntityValidator : 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 entityObjs = et["POOrderEntry"] as DynamicObjectCollection;

                if (entityObjs == null || entityObjs.Count == 0)

                {

                    continue;

                }

                var rowIndex = 0;

                foreach (var entityObj in entityObjs)

                {

                    rowIndex++;

                    var subObjs = entityObj["POOrderEntryDeliPlan"] as DynamicObjectCollection;

                    if (subObjs == null || subObjs.Count == 0)

                    {

                        continue;

                    }

                    // 获取单据体当前行的汇总字段的值

                    var entityQty = Convert.ToDecimal(Convert.ToDouble(entityObj["F_Jac_Qty"]));

                    // 获取单据体当前行的子单据体的要汇总的字段的合计值

                    var subEntityQtySum = Convert.ToDecimal(Convert.ToDouble(subObjs.Where(o => o["PlanQty"] != null).Sum(o => Convert.ToDecimal(o["PlanQty"]))));

                    if (entityQty != subEntityQtySum)

                    {

                        validateContext.AddError(et, new ValidationErrorInfo(

                            "", // 出错的字段Key，可以空

                            Convert.ToString(et.DataEntity[0]), // 数据包内码，必填，后续操作会据此内码避开此数据包

                            et.DataEntityIndex, // 出错的数据包在全部数据包中的顺序

                            et.RowIndex, // 出错的数据行在全部数据行中的顺序，如果校验基于单据头，此为0

                            "E1", // 错误编码，可以任意设定一个字符，主要用于追查错误来源

                            string.Format("单据编号为【{0}】的采购订单，明细信息单据体的第{1}行分录，发货数量的值[{2}]和交货明细子单据体的数量合计值[{3}]不相等。"

                                , et.BillNo, rowIndex, entityQty, subEntityQtySum), // 错误的详细提示信息

                            "子单据体字段汇总到单据体后的数据合法性检查", // 错误的简明提示信息

                            ErrorLevel.FatalError // 错误级别：警告、错误

                        ));

                    }

                }

            }

        }

    }

}

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

<3>BOSIDE扩展采购订单，明细信息单据体添加交货数量字段，注册服务插件，保存元数据，开发完毕。

Python插件注册方式如下。

【注意】

如果C#插件代码过于复杂，不便转Python，可以使用小工具【Cs2Py】把C#插件代码直接转换成Python插件代码，Python插件救急救场可以，复杂功能不推荐使用。

【功能验证】

<1>登录业务站点，打开采购订单编辑界面，明细信息单据体上的交货数量录入不同于采购数量的值，点击保存，校验器校验不通过，保存操作被终止。

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

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

Cs2Py.rar

插件代码.rar