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端就是处理业务数据，根据自己业务场景写即可。
—恢复内容结束—