二开案例.单据插件.撤销流程

【应用场景】

通过插件的方式，对已启动流程的单据，执行撤销操作。

撤销有两个场景：

场景1：单据刚提交，流程刚启动，尚未进行过任何的审批操作。此时去执行撤销后，已产生的待办会被作废，流程会被终止，单据也会执行反审核操作，单据状态变成重新审核状态。

场景2：单据已执行过审批操作。此时去执行撤销后，当前节点的所有审批任务都会作废，当前节点会重新激活，重新产生待办任务，流程状态不会变化，还是运行中，单据状态也不会变化，还是审核中。

【案例演示】

币别，启动工作流后，执行撤销操作。

对应场景1：

对应场景2：

【示例代码】

using Kingdee.BOS;
using Kingdee.BOS.Core.Bill.PlugIn;
using Kingdee.BOS.Core.DynamicForm;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.Objects.Workflow;
using Kingdee.BOS.Orm;
using Kingdee.BOS.ServiceHelper;
using Kingdee.BOS.Util;
using Kingdee.BOS.Workflow.Models.ServiceArgs;
using Kingdee.BOS.Workflow.ServiceHelper;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;

namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【单据插件】撤销流程
    /// </summary>
    [Description("【单据插件】撤销流程"), HotUpdate]
    public class CancelProcInstBillPlugIn : AbstractBillPlugIn
    {
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            if (e.BarItemKey == "test")
            {
                var result = CancelAssign(this.Context, this.View.BillBusinessInfo.GetForm().Id, this.Model.DataObject[0].ToString());
                if (result.IsSuccess)
                {
                    this.View.ShowOperateResult(result.OperateResult);
                }
                else
                {
                    var errMsg = new List<string>();
                    if (!result.ValidationErrors.IsEmpty())
                    {
                        errMsg.Add("校验错误：\r\n" + string.Join("\r\n", result.ValidationErrors.Select(o => o.Message)));
                    }
                    if (!result.OperateResult.IsEmpty())
                    {
                        errMsg.Add("操作错误：\r\n" + string.Join("\r\n", result.OperateResult.Select(o => o.Message)));
                    }
                    this.View.ShowErrMessage("操作失败！\r\n" + string.Join("\r\n", errMsg));
                }
            }
        }
        /// <summary>
        /// 撤销待办任务/撤销流程
        /// </summary>
        /// <param name="ctx">上下文</param>
        /// <param name="formId">业务对象标识</param>
        /// <param name="pkValue">单据内码</param>
        /// <returns>返回操作结果</returns>
        private static IOperationResult CancelAssign(Context ctx, string formId, string pkValue)
        {
            var formMetadata = FormMetaDataCache.GetCachedFormMetaData(ctx, formId);
            var businessInfo = formMetadata.BusinessInfo;
            // 准备读取、判断待撤销的流程实例
            var procInstWaitCancel = new GetCancelAssignsArgs();
            procInstWaitCancel.GetByBill(formId, pkValue);
            AssignmentServiceHelper.GetCancelAssigns(ctx, procInstWaitCancel);
            var message = procInstWaitCancel.Message;
            if (procInstWaitCancel.ProcInstCanCancelAssigns.Count == 0)