首页 > 代码库 > 基于标签方式的工作流启动及任务执行开发说明

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

2024-07-20 23:56:49   220人阅读

基于现在的系统的整合需求，本系统提供基于标签的工作流整合方式，工作流的启动及执行下一步时，均需要通过可以通过标识来处理完成。这使得基于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=http://www.mamicode.com/"axxxService.aaMethod"/>
  •                     <input type="hidden" name="preHandler" value=http://www.mamicode.com/"axxxService.aaMethod"/>
  •                 </td>  
  •             </tr>  
  •         </table>  
  •     </flow:start>  


    start标签只带两个参数， curUserId表示为当前启动的流程的Id，defId为流程定义Id，中间标着色的部分为自己的业务表单，可以在自己的业务表单中加上preHandler及afterHandler参数值，如：<input type=”hidden” name=”afterHandler” value=http://www.mamicode.com/”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=http://www.mamicode.com/”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指定自己的业务执行表单路径。

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


联系
我们