金蝶K3Cloud插件 -- 单据保存自动提交并审核（c#）

金蝶K3Cloud插件 -- 单据保存自动提交并审核（c#）

最近在做金蝶相关的技术支持，记录一下插件开发步骤。使用C#开发

需求：实现表单点击保存，自动进行提交审核

1、打开VS，新建项目，选择类库

2、类继承Kingdee.BOS.Core.DynamicForm.PlugIn.AbstractOperationServicePlugIn

3、以下是实现代码

 public class Save : AbstractOperationServicePlugIn
    {
        //加载单据字段
        public override void OnPreparePropertys(PreparePropertysEventArgs e)
        {
            base.OnPreparePropertys(e);
            //是否内部交易
            e.FieldKeys.Add("FIsInner");
        }

        public override void OnPrepareOperationServiceOption(OnPrepareOperationServiceEventArgs e)
        {
            base.OnPrepareOperationServiceOption(e);
            //为了在BeginOperationTransaction里检查数据抛出异常时
            //只回滚当前单据的事务，这里设置为不支持批量事务，这样BOS会
            //循环为每一张单据创建事务调用操作 
            e.SupportTransaction = true;
            e.SurportBatchTransaction = false;
        }
        /// <summary>
        /// 保存操作完毕，事务结束之前，进行自动提交、审核，只有内部交易的发货通知单才自动提交审核
        /// </summary>
        /// <param name="e"></param>
        public override void EndOperationTransaction(EndOperationTransactionArgs e)
        {
            if (e.DataEntitys.IsNullOrEmpty() || e.DataEntitys.Count() == 0)
            {
                return;
            }
            DynamicObject objs;
            List<Object> list = new List<Object>();
            for (int i = 0; i < e.DataEntitys.Length; i++)
            {
                objs = e.DataEntitys[i];
                if (objs["FIsInner"].ToString().Trim().Equals("True"))
                {
                    list.Add(objs["Id"]);
                }
                else
                {
                    continue;
                }
            }
            if (list.Count() == 0)
            {
                return;
            }
            // 取到需要自动提交、审核的单据内码
            object[] pkArray = list.ToArray();
            // 设置提交参数
            // using Kingdee.BOS.Orm;
            OperateOption submitOption = OperateOption.Create();
            submitOption.SetIgnoreWarning(this.Option.GetIgnoreWarning());
            submitOption.SetInteractionFlag(this.Option.GetInteractionFlag());
            submitOption.SetIgnoreInteractionFlag(this.Option.GetIgnoreInteractionFlag());
            // 创建提交服务：using Kingdee.BOS.Contracts; using Kingdee.BOS.App;
            ISubmitService submitService = ServiceFactory.GetSubmitService(this.Context);
            IOperationResult submitResult = submitService.Submit(this.Context, this.BusinessInfo, pkArray, "Submit", submitOption);
            // 判断提交结果，如果失败，则内部会抛出错误，回滚代码
            if (CheckOpResult(submitResult) == false)
            {
                return;
            }
            // 构建操作可选参数对象
            OperateOption auditOption = OperateOption.Create();
            auditOption.SetIgnoreWarning(this.Option.GetIgnoreWarning());
            auditOption.SetInteractionFlag(this.Option.GetInteractionFlag());
            auditOption.SetIgnoreInteractionFlag(this.Option.GetIgnoreInteractionFlag());
            // 构建单据主键参数
            List<KeyValuePair<object, object>> pkEntityIds = new List<KeyValuePair<object, object>>();
            foreach (var pkValue in pkArray)
            {
                pkEntityIds.Add(new KeyValuePair<object, object>(pkValue, ""));
            }
            List<object> paras = new List<object>();
            paras.Add("1");
            paras.Add("");
            // 调用审核操作
            ISetStatusService setStatusService = ServiceFactory.GetSetStatusService(this.Context);
            // 如下调用方式，需显示交互信息
            IOperationResult auditResult = setStatusService.SetBillStatus(this.Context, this.BusinessInfo, pkEntityIds, paras, "Audit", auditOption);
            // 判断审核结果，如果失败，则内部会抛出错误，回滚代码
            if (CheckOpResult(auditResult) == false)
            {
                return;
            }
        }
        /// <summary>
        /// 判断操作结果是否成功，如果不成功，则直接抛错中断进程
        /// </summary>
        /// <param name="opResult"></param>
        /// <returns></returns>
        private bool CheckOpResult(IOperationResult opResult)
        {
            bool isSuccess = false;
            if (opResult.IsSuccess == true)
            {
                // 操作成功
                isSuccess = true;
            }
            else
            {
                if (opResult.InteractionContext != null && opResult.InteractionContext.Option.GetInteractionFlag().Count > 0)
                {
                    // 有交互性提示
                    // 传出交互提示完整信息对象
                    this.OperationResult.InteractionContext = opResult.InteractionContext;
                    // 传出本次交互的标识，
                    // 用户在确认继续后，会重新进入操作；
                    // 将以此标识取本交互是否已经确认过，避免重复交互
                    this.OperationResult.Sponsor = opResult.Sponsor;
                    // 抛出错误，终止本次操作
                    throw new KDBusinessException("", "本次操作需要用户确认是否继续，暂时中断");
                }
                else
                {
                    // 操作失败，拼接失败原因，然后抛出中断
                    opResult.MergeValidateErrors();
                    if (opResult.OperateResult == null)
                    {// 未知原因导致提交失败
                        throw new KDBusinessException("", "未知原因导致自动提交、审核失败！");
                    }
                    else
                    {
                        StringBuilder sb = new StringBuilder();
                        sb.AppendLine("自动提交、审核失败，失败原因：");
                        foreach (var operateResult in opResult.OperateResult)
                        {
                            sb.AppendLine(operateResult.Message);
                        }
                        throw new KDBusinessException("", sb.ToString());
                    }
                }
            }
            return isSuccess;
        }
    }

4、生成.dll文件，将插件加入表单的操作列表-保存服务中

分享小技巧，金蝶到7.几的版本以后才支持热更新，所以每次修改插件都要重启IIS，是不是觉得很麻烦，特别是有很多用户在使用的时候，只能下班时间搞。

告诉你们一个办法，修改插件的名字，每次用一个新名字插件在第一次就会生效，如果修改了代码，就再修改插件名字。虽然也比较麻烦，但是不用重启IIS，不用加班搞，爽不爽。。。。

如果对你有用，请给个赞，哈哈！！！