K2工作流引擎Demo

     以前的工作都是电商网站形式的,从未接触过工作流相关工作,新公司是传统制造业行业,我进的这个组又是做工作流这块相关工作的,所以避免不了和工作流打交道。

     这边工作流主要用K2来做,我呢也是初次使用K2工作流引擎,今天就简单记录下创建K2工作流的过程,以后再慢慢补充更深一点的内容。

准备工作:

1.K2客户端要安装好,我这边是公司直接给的K2安装包,外面下载不到,据说这玩意收费的。

2.我这个K2客户端只能在VS2010上创建项目,所以还要配合K2装一个VS2010

3.以上两项准备工作就绪后,基本就要开工了,接下来要做的流程图大概长成这样,上张图看下

大致介绍下,该流程有2个节点Supplier和QS两个审批节点,有3个操作、同意、拒绝、关闭,这个流程也相对简单一点

 

1.需要用VS2010新建工作流项目,打开VS2010

文件》新建》项目:如下所示:

K2客户端安装后,左侧已安装的项目就会有K2的模板,创建项目的时候要选择“K2 Workflow Project”项目,然后输入项目名称、位置、解决方案名称,点击确定即可。

默认是有一个开始节点的,这个节点没有任何操作。

接下来我们做一个,发起申请,供应商收到通知上传,质量部门审批(同意、拒绝、关闭)

1.新增节点》打开工具箱》Event Wizards》选择“Default Server Event(Code)”》拖拽到设计面板,默认就剩生成左侧框内节点。默认会带一个事件。那么接下来,我们再把另外几个节点拖拽出来,最后在去关联。

 

 2.所有节点以及拖拽完成,如下所示,拖拽过程中对每个节点进行了重命名,直接在每个节点上右键》Properties》

 

 

 

 3.这一步就是使用线把这几个流程节点给关联起来。工具箱》Line Wizards》选择:Default Line  线即可。这一步主要用于关联开始节点和Supplier两个节点,这两个节点之间没有任何审批操作。

选择这个线之后,鼠标指针放到起始节点,划线到Supplier节点即可

 

发起流程的时候其实是有代码来通知K2,流程已经发起,下一步通知Supplier节点进行审批,代码大致粘贴下。流程创建好之后,回返回一个ProcInstID ,K2自动生成的,后续和K2的交互就要依赖这个ID。

 QSSampleReportWorkflow workflow = new QSSampleReportWorkflow(
                          item.ID,
                          string.Empty,
                          User.Identity.Name,
                          hdEmployeeName.Value,
                          "供应商样品报告"
                          );
                        item.ProcInstID = workflow.StartNewProcessInstance();

 

 所有参数及方法都在QSSampleReportWorkflow这个类里边,

public sealed class QSSampleReportWorkflow
    {
        string processFullName = @"Com.WorkFlows\QSSampleReport";//审批流文件名
        string originator;//发起人帐号
        string nickName;//昵称
        string viewURL;
        string ApprovalURL;
        string WebServiceURL;

        System.Collections.Hashtable hsDataFields = new System.Collections.Hashtable();
        string title;
        string folioName;
        public QSSampleReportWorkflow(int formID, string appliNo, string userAccount, string userName, string projecteName)
        {
            originator = userAccount;//账号
            nickName = userName;
            string rootURL = ConfigurationManager.AppSettings["SiteRoot"];//当前Web站点地址
            WebServiceURL = string.Format("{0}/Suppliers/QSSampleReport.asmx", rootURL);//WebService地址
            ApprovalURL = string.Format("{0}/Suppliers/SupplierApplyView.aspx", rootURL);//申请页
            viewURL = string.Format("{0}/Suppliers/SupplierApplyView.aspx?RequestID={1}&PDK={2}", rootURL, formID, EncryptHelper.GetPDK(formID.ToString()));//查看页
            title = string.Format("QSSampleReport_{0}_{1}", projecteName, formID);
            folioName = string.Format("QSSampleReport_{0}", formID);
            hsDataFields.Add("RequestID", formID);
            hsDataFields.Add("WebServiceURL", WebServiceURL);
            hsDataFields.Add("ApproveURL", ApprovalURL);
            hsDataFields.Add("Title", title);
            hsDataFields.Add("FullName", nickName);
            //hsDataFields.Add("EnableToCheckFinal", false);
        }

        public QSSampleReportWorkflow()
        {
        }
        public int StartNewProcessInstance()
        {
            return Com.Kion.CommonProjects.WorkflowHelper.K2Helper
                  .StartNewProcessInstanceAndLogOnWorkflowPlatform(processFullName, hsDataFields, folioName, originator, viewURL, "");
        }
        /// <summary>
        /// 审批
        /// </summary>
        /// <param name="sn">审批时自动生产成的参数</param>
        /// <param name="approvalResult">审批结果</param>
        /// <param name="nodeName">审批节点名称</param>
        /// <param name="approver">审批人</param>
        /// <param name="remark">批备注</param>
        public void Approval(string sn, ApplyState approvalResult, string nodeName, string approver, string remark)
        {
            try
            {
                K2Helper.ApprovalProcessInstanceAndLogOnWorkflowPlatform(sn, approvalResult.ToString().Trim()
                    , nodeName, false
                    , approver
                    , remark);
            }
            catch (Exception ex)
            {

            }

        }
    }

 

4.发起流程之后会到Supplier这个节点,这个节点要干的事情有以下几项,
1.获取节点审批人,需要在Supplier这个节点加载时初始化时写一一段与WebService交互的代码,先把WebServices引入

 

Process Referencess》Add》Web》如下图所示添加引用

 2.获取Supplier这个节点审批人,那么就要加入以下代码,操作如下

在代码区域,DestinationRule_ExecuteCode方法中最后一个else里边写入以下代码,保存即可,

GetDynamicApprovers方法WebService那边返回一个字符串数组存的都是账号
K2.Destinations.Clear();
                Suppliers.QSSampleReport wsHelper = new Suppliers.QSSampleReport();
                wsHelper.Url = K2.ProcessInstance.DataFields["WebServiceURL"].Value.ToString();
                int requestID = int.Parse(K2.ProcessInstance.DataFields["RequestID"].Value.ToString());
                //获取Supplier节点审批人
                string[] approverList = wsHelper.GetDynamicApprovers(requestID, K2.ActivityInstance.Activity.Name);

                foreach (string approver in approverList)
                {
                    K2.Destinations.Add(DestinationType.User, approver);
                }

 

2.给默认的Server Event添加事件代码,这里主要用来发送邮件,具体操作如下图所示

在Main方法中添加以下代码:

 string approverList = string.Empty;
            for (int i = 0; i < K2.ActivityInstanceDestination.Destinations.Count; i++)
            {
                approverList += K2.ActivityInstanceDestination.Destinations[i].Name.Split(':')[1] + ";";
            }
            Suppliers.QSSampleReport wsHelper = new Suppliers.QSSampleReport();
            wsHelper.Url = K2.ProcessInstance.DataFields["WebServiceURL"].Value.ToString();//WebService地址
            int requestID = int.Parse(K2.ProcessInstance.DataFields["RequestID"].Value.ToString());//申请ID
            wsHelper.SendEmailToApprover(approverList, K2.SerialNumber, K2.ActivityInstanceDestination.ActivityInstance.Activity.Name, requestID);

 

3.设置QS节点,和上边Supplier节点设置一样,需要在初始化时拷贝获取审批人代码,ServerEvent节点拷贝发送邮件代码。和Supplier区别在于,这个节点有审批人会介入,需要配置两个操作,批准、拒绝
添加动作(审批通过、拒绝等),执行这个节点的操作(这个节点直接审批通过即可),添加一个Default client Event,具体如下图所示

 

然后会弹出配置框,按照指示操作即可

 

 

 

大致配置了4个参数,要和WebServices那边对应起来,配置好之后还是回到刚才界面选择配置参数,如下所示,SN是自动生成的参数,选择WebServiceUlr之后点击Next然后在Back返回这个参数自动就带上了,

这个参数是K2自动生成的一个流程ID,跟业务表单对应的,传到业务站点之后可以根据这个流程ID获取对应业务数据,前提是我们之前存了这个流程ID

 

 这一步配置后直接Next即可,然后配置,两个操作,就是 审批和拒绝两个操作。具体如下

两个操作配置好之后,直接Next到User界面,添加用户,这个用户目前是写死的,具体什么意义我还不清楚,不写又不行,具体如下图所示

 

 配置完之后,直接Next,直至Finish即可。这时候会出来两条线,一个是Approve,另一个则是Decline,然后将这两条线指向对应节点,如下图所示

 

在Approva节点和Close节点的ServerEvent里加入以下代码通知程序审批流结束,有点区别是这个方法同意传true,关闭就传false
wsHelper.EndApproval(requestID, true);//发起流程操作
Suppliers.QSSampleReport wsHelper = new Suppliers.QSSampleReport();//创建WebService对象
            wsHelper.Url = K2.ProcessInstance.DataFields["WebServiceURL"].Value.ToString();//获取WebServiceURL
            int requestID = int.Parse(K2.ProcessInstance.DataFields["RequestID"].Value.ToString());//获取业务表单Id
            wsHelper.EndApproval(requestID, true);//发起流程操作

 

 在WebService提供端,EndApproval方法里要写入业务代码,流程结束后,业务数据的操作,邮件通知,流程关闭等

 

WebService端代码我就不贴了,有些东西是公司的,web端就是处理业务数据,根据自己业务场景写即可。

posted @ 2019-06-06 16:01  向乾  阅读(6604)  评论(1编辑  收藏  举报