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;
            ; i < K2.ActivityInstanceDestination.Destinations.Count; i++)
            {
                approverList += K2.ActivityInstanceDestination.Destinations[i].Name.Split(] + ";";
            }
            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端就是处理业务数据，根据自己业务场景写即可。

---恢复内容结束---