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端就是处理业务数据,根据自己业务场景写即可。