【应用场景】干预单据体合计列动作。

【案例演示】

<1>采购订单，明细信息单据体的采购数量字段，插件干预该字段的合计值。

<2>主动触发单据体的合计列动作。

【实现步骤】

<1>编写单据插件，代码如下所示。

using Kingdee.BOS.Core.Bill.PlugIn;

using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using Kingdee.BOS.JSON;

using Kingdee.BOS.Util;

using Kingdee.BOS.Web.DynamicForm;

using System;

using System.ComponentModel;

using System.Reflection;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【单据插件】单据体合计列

    /// </summary>

    [Description("【单据插件】单据体合计列"), HotUpdate]

    public class EntrySummaryBillPlugIn : AbstractBillPlugIn

    {

        /// <summary>

        /// 插件干预单据体合计列的值

        /// </summary>

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

        public override void OnEntrySum(EntrySumEventArgs e)

        {

            base.OnEntrySum(e);

            if (e.Field.Key.EqualsIgnoreCase("FQty"))

            {

                var needAddQty = Convert.ToDecimal(this.Model.GetValue("F_Jac_Integer"));

                e.Value = e.Value + needAddQty;

            }

        }

        /// <summary>

        /// 分录菜单点击事件

        /// </summary>

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

        public override void EntryBarItemClick(BarItemClickEventArgs e)

        {

            base.EntryBarItemClick(e);

            if (e.BarItemKey.EqualsIgnoreCase("tbFireEntrySumAction"))

            {

                // 插件主动触发单据体某个列的合计动作

                var formState = GetPropertyValue(this.View, "FormState") as DynamicWebFormState;

                if (formState == null)

                {

                    return;

                }

                var entrySumActions = GetPropertyValue(formState, "EntrySumActions");

                if (entrySumActions == null)

                {

                    return;

                }

                var typeName = "Kingdee.BOS.Web.DynamicForm.EntrySumActions,Kingdee.BOS.Web";

                var qtyField = this.View.BillBusinessInfo.GetField("FQty");

                //var methodAddSumEntry = GetMethod(typeName, "AddSumEntry");

                //methodAddSumEntry.Invoke(entrySumActions, new object[] {qtyField.Entity});// 触发某个单据体下的所有汇总字段的汇总动作

                var methodAddSumField = GetMethod(typeName, "AddSumField");

                methodAddSumField.Invoke(entrySumActions, new object[] { qtyField }); // 触发指定字段的汇总动作

                var methonAddSumAction = GetMethod(typeName, "AddSumAction");

                methonAddSumAction.Invoke(entrySumActions, new object[] { formState });

            }

            if (e.BarItemKey.EqualsIgnoreCase("tbSetSummaryData"))

            {

                // 直接给合计列赋值

                var formState = GetPropertyValue(this.View, "FormState") as DynamicWebFormState;

                if (formState == null)

                {

                    return;

                }

                var sum = new JSONObject();

                sum.Put("FQty".ToUpper(), 888);

                var entityAppearance = this.View.LayoutInfo.GetEntityAppearance("FPOOrderEntry");

                formState.InvokeControlMethod(entityAppearance, "SetSummaryData", sum);

            }

        }

        /// <summary>

        /// 反射获取对象实例的某个属性值

        /// </summary>

        /// <param name="obj"></param>

        /// <param name="propertyName"></param>

        /// <returns></returns>

        private object GetPropertyValue(object obj, string propertyName)

        {

            var property = obj.GetType().GetProperty(propertyName, BindingFlags.NonPublic | BindingFlags.Instance);

            if (property != null)

            {

                return property.GetValue(obj, null);

            }

            return null;

        }

        /// <summary>

        /// 反射获取方法定义

        /// </summary>

        /// <param name="typeName"></param>

        /// <param name="methodName"></param>

        /// <returns></returns>

        private MethodInfo GetMethod(string typeName, string methodName)

        {

            var type = Type.GetType(typeName);

            if (type == null)

            {

                return null;

            }

            return type.GetMethod(methodName);

        }

    }

}

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

<3>登录BOSIDE，扩展采购订单，新增一个整数字段，用于参与插件的合计列计算，如下图所示。

<4>添加分录菜单，用于主动触发单据体的合计列动作，如下图所示。

<5>采购订单注册表单插件，保存元数据，开发完毕。

现在可以登录业务站点，打开采购订单，验证一下插件的控制效果啦。

输入采购数量，被动响应单据体合计事件：

点击分录菜单，主动触发单据体合计事件：

直接赋值888：

【温馨提醒】

不到万不得己，不建议使用反射的方式使用BOS平台未公开的属性或方法，因为平台兼容性只会兼容公开接口，内部方法随时可能有变化，反射调用的方式可能为将来系统升级留下隐患。

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