基于现在的系统的整合需求,本系统提供基于标签的工作流整合方式,工作流的启动及执行下一步时,均需要通过可以通过标识来处理完成。这使得基于JSP方式的流程整合变得很简单.
- 自定义工作流启动
系统提供启动参数,只需要提交至/flow/startProcessActivity.do,提交的参数包括以下:(可以参考ProcessRunStart.js的)
- defId: 必需,流程定义Id,即pro_definition表里的主键
- startFlow: 必需,值为true,则表示启动流程 必填
- destName:目标节点,当开始节点有两个以上的分支时,可以指定该值,以决定流程启动后,跳转至的目标节点,若没有指定,则默认会跳至第一个节点。
- flowAssignId:目标节点的执行人员,其格式如:格式为:节点1:节点2|节点1执行人IDs:节点2执行IDs,其中节点IDs值格式如1,2,3,若没有指定,则以后台的节点指定的执行人员。
- useTemplate:默认为false,表示用的是后台的在线表单保存值,若用模板表单,则设置该值为true。
- sendMail: 默认为false,true则表示发送邮件通知相关的人员
- sendMsg: 默认为false,true则表示发送短信通知待办人员
若调用标签,可以简化启动流程的使用方式。
start标签调用示例:
Java代码 [url=][/url]
- <%@ taglib prefix="flow" tagdir="/WEB-INF/tags/flow"%>
- <flow:start curUserId="1" defId="1">
- <table cellpadding="0" cellspacing="1" border="1" >
- <tr>
- <td>我的业务表单</td>
- </tr>
- <tr>
- <td>
- xx:<input type="text" name="xxx"/>
- <input type="hidden" name="afterHandler" value="axxxService.aaMethod"/>
- <input type="hidden" name="preHandler" value="axxxService.aaMethod"/>
- </td>
- </tr>
- </table>
- </flow:start>
start标签只带两个参数, curUserId表示为当前启动的流程的Id,defId为流程定义Id,中间标着色的部分为自己的业务表单,可以在自己的业务表单中加上preHandler及afterHandler参数值,如:<input type=”hidden” name=”afterHandler” value=”xxService.xxMethod”/>
在工作流启动的时候,一般只需要指定afterHandler方法对应的参数,其值格式为xxxxService.xxMethod,若指定了该值,则表示在工作流启动后,会从Spring容器中查找xxService的Bean,并且调用其xxMethod的方法,而xxMethod的方法格式如下所示:
Integer xxMethod(FlowFlowRunInfo flowRunInfo);
FlowFlowRunInfo里面会携带流程的相关信息,如更改流程中的待办事项的名称,则可以在在该方法中调用:
ProcessRun processRun=flowRunInfo.getProcessRun();
processRun.setSubject(“xxx审批流程”);
processRunService.save(processRun);
在这里加上自己的业务变量加至流程中,可以像以下调用:
Map map=new HashMap();
map.put(“pkId”,xx.getId());
executionService.setVariables(processRun.getPiId(),map);
或像以下方式中调用:
flowRunInfo.getFlowVars().put(“pkId”,xx.getId());
xx.getId()表示取得xx实体变量中的id键值,可以在后续的流程中获取。
若要在该方法,需要获取表单中的业务方法,可以通过flowRunInfo.getRequest()获取HttpServletRequest对象。若需要获取在业务表单中自动封装的实体,可以在业务表单中用以下的方式命名,如
<input type=”text” name=”salesOrder.orderNo” value=”xxx”/>
在xxMethod方法可以把参数名以salesOrder开头的参数自动组装至salesOrder对象,则需要像以下方式调用:
Java代码 [url=][/url]
- SalesOrder salesOrder=new SalesOrder();
- try{
- BeanUtil.populateEntity(flowRunInfo.getRequest(), salesOrder, "salesOrder");
- }catch(Exception ex){
- logger.error(ex.getMessage());
- }
- 自定义工作流执行下一步
流程执行下一步时,只需要把流程表单中提交至/flow/nextProcess.do,并且携带以下参数则可。
- taskId:必需,jbpm中的任务Id
- destName:目标节点,当开始节点有两个以上的分支时,可以指定该值,以决定流程启动后,跳转至的目标节点,若没有指定,则默认会跳至第一个节点。
- flowAssignId:目标节点的执行人员,其格式如:格式为:节点1:节点2|节点1执行人IDs:节点2执行IDs,其中节点IDs值格式如1,2,3,若没有指定,则以后台的节点指定的执行人员。
- useTemplate:默认为false,表示用的是后台的在线表单保存值,若用模板表单,则设置该值为true。
- signVoteType:会签投票类型,当前节点为会签时,表示需要进行参与会签,当前用户投的会签的决定(1=同意,2=拒绝,3=弃权)
- sendMail: 默认为false,true则表示发送邮件通知相关的人员
- sendMsg:默认为false,true则表示发送短信通知待办人员
标签的使用以下所示:
Java代码 [url=][/url]
- <flow:next curUserId="${params.curUserId}" taskId="${params.taskId}">
- <table>
- <tr>
- <td>我的业务表单</td>
- </tr>
- <tr>
- <td>
- taskName:<input type="text" name="xxx"/>
- </td>
- </tr>
- </table>
- </flow:next>
在该标签内,也可以像start标签一样,接收preHandler参数及afterHandler方法,以方便加上在业务表单的处理方法。
3.在后台指定流程表单路径
进入某个流程后台设置,如下:
把“使用表单模板”,同时在每个节点,指定模板类型为JSP模板,并且在url指定自己的业务执行表单路径。