基于标签方式的工作流启动及任务执行开发说明

基于现在的系统的整合需求，本系统提供基于标签的工作流整合方式，工作流的启动及执行下一步时，均需要通过可以通过标识来处理完成。这使得基于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.在后台指定流程表单路径

 

进入某个流程后台设置，如下：

<IGNORE_JS_OP style="WORD-WRAP: break-word">

把“使用表单模板”，同时在每个节点，指定模板类型为JSP模板，并且在url指定自己的业务执行表单路径。